@botonic/plugin-flow-builder 0.57.0-rslib-esm.2 → 0.57.0

package/lib/esm/utils/input.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inputHasTextOrTranscript = inputHasTextOrTranscript;
+exports.getTextOrTranscript = getTextOrTranscript;
+exports.isKeywordsAllowed = isKeywordsAllowed;
+exports.isSmartIntentsAllowed = isSmartIntentsAllowed;
+const core_1 = require("@botonic/core");
+const get_flow_builder_plugin_1 = require("./get-flow-builder-plugin");
+function inputHasTextOrTranscript(input) {
+    const isTextInput = Boolean(input.data) && input.type === core_1.INPUT.TEXT;
+    const isTranscriptText = Boolean(input.transcript) && input.type === core_1.INPUT.AUDIO;
+    return isTextInput || isTranscriptText;
+}
+function getTextOrTranscript(input) {
+    if (input.type === core_1.INPUT.TEXT && input.data) {
+        return input.data;
+    }
+    if (input.type === core_1.INPUT.AUDIO && input.transcript) {
+        return input.transcript;
+    }
+    console.error('No text or transcript found in input', input);
+    return undefined;
+}
+function isNluAllowed(request, nluFlag) {
+    const shadowing = Boolean(request.session._shadowing);
+    const flowBuilderPlugin = (0, get_flow_builder_plugin_1.getFlowBuilderPlugin)(request.plugins);
+    return !shadowing || (shadowing && flowBuilderPlugin.inShadowing[nluFlag]);
+}
+function isKeywordsAllowed(request) {
+    return isNluAllowed(request, 'allowKeywords');
+}
+function isSmartIntentsAllowed(request) {
+    return isNluAllowed(request, 'allowSmartIntents');
+}
+//# sourceMappingURL=input.js.map

package/lib/esm/utils/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/utils/input.ts"],"names":[],"mappings":";;AAMA,4DAMC;AAED,kDAUC;AAWD,8CAEC;AAED,sDAEC;AAzCD,wCAAiD;AAIjD,uEAAgE;AAEhE,SAAgB,wBAAwB,CAAC,KAAY;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAK,CAAC,IAAI,CAAA;IACpE,MAAM,gBAAgB,GACpB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAK,CAAC,KAAK,CAAA;IAEzD,OAAO,WAAW,IAAI,gBAAgB,CAAA;AACxC,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAY;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC,IAAI,CAAA;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC,UAAU,CAAA;IACzB,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAA;IAC5D,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,OAAsB,EACtB,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACrD,MAAM,iBAAiB,GAAG,IAAA,8CAAoB,EAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/D,OAAO,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,SAAgB,iBAAiB,CAAC,OAAsB;IACtD,OAAO,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;AAC/C,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAsB;IAC1D,OAAO,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAA;AACnD,CAAC"}

package/lib/esm/webview/contents-context.d.ts

@@ -0,0 +1,2 @@
+import type { MapContentsType, WebviewContentsContextType } from './types';
+export declare const createWebviewContentsContext: <T extends MapContentsType>() => import("react").Context<WebviewContentsContextType<T>>;

package/lib/esm/webview/contents-context.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebviewContentsContext = void 0;
+const react_1 = require("react");
+const createWebviewContentsContext = () => (0, react_1.createContext)({
+    getTextContent: () => '',
+    getImageSrc: () => '',
+    setCurrentLocale: () => undefined,
+    contents: {},
+});
+exports.createWebviewContentsContext = createWebviewContentsContext;
+//# sourceMappingURL=contents-context.js.map

package/lib/esm/webview/contents-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents-context.js","sourceRoot":"","sources":["../../../src/webview/contents-context.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAI9B,MAAM,4BAA4B,GAAG,GAA8B,EAAE,CAC1E,IAAA,qBAAa,EAAgC;IAC3C,cAAc,EAAE,GAAG,EAAE,CAAC,EAAE;IACxB,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE;IACrB,gBAAgB,EAAE,GAAG,EAAE,CAAC,SAAS;IACjC,QAAQ,EAAE,EAA6B;CACxC,CAAC,CAAA;AANS,QAAA,4BAA4B,gCAMrC"}

package/lib/esm/webview/index.d.ts

@@ -0,0 +1,3 @@
+export { createWebviewContentsContext } from './contents-context';
+export * from './types';
+export { useWebviewContents } from './use-webview-contents';

package/lib/esm/webview/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWebviewContents = exports.createWebviewContentsContext = void 0;
+const tslib_1 = require("tslib");
+var contents_context_1 = require("./contents-context");
+Object.defineProperty(exports, "createWebviewContentsContext", { enumerable: true, get: function () { return contents_context_1.createWebviewContentsContext; } });
+tslib_1.__exportStar(require("./types"), exports);
+var use_webview_contents_1 = require("./use-webview-contents");
+Object.defineProperty(exports, "useWebviewContents", { enumerable: true, get: function () { return use_webview_contents_1.useWebviewContents; } });
+//# sourceMappingURL=index.js.map

package/lib/esm/webview/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/webview/index.ts"],"names":[],"mappings":";;;;AAAA,uDAAiE;AAAxD,gIAAA,4BAA4B,OAAA;AACrC,kDAAuB;AACvB,+DAA2D;AAAlD,0HAAA,kBAAkB,OAAA"}

package/lib/esm/webview/types.d.ts

@@ -0,0 +1,47 @@
+import type { FlowBuilderJSONVersion } from '../types';
+export declare enum WebviewContentType {
+    TEXT = "webview-text",
+    IMAGE = "webview-image"
+}
+export type WebviewContentsResponse = (WebviewTextContent | WebviewImageContent)[];
+export interface WebviewTextContent {
+    code: string;
+    type: WebviewContentType.TEXT;
+    content: {
+        text: {
+            message: string;
+            locale: string;
+        }[];
+    };
+}
+export interface WebviewImageContent {
+    code: string;
+    type: WebviewContentType.IMAGE;
+    content: {
+        image: {
+            file: string;
+            locale: string;
+        }[];
+    };
+}
+export type MapContentsType = Record<string, string>;
+export interface UseWebviewContentsProps<T extends MapContentsType> {
+    apiUrl?: string;
+    version?: FlowBuilderJSONVersion;
+    botId: string;
+    webviewId: string;
+    providerId: string;
+    locale: string;
+    mapContents: Record<keyof T, string>;
+}
+export interface UseWebviewContents<T extends MapContentsType> {
+    isLoading: boolean;
+    error: boolean;
+    webviewContentsContext: WebviewContentsContextType<T>;
+}
+export interface WebviewContentsContextType<T extends MapContentsType> {
+    getTextContent: (code: string) => string;
+    getImageSrc: (code: string) => string;
+    setCurrentLocale: (locale: string) => void;
+    contents: Record<keyof T, string>;
+}

package/lib/esm/webview/types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebviewContentType = void 0;
+var WebviewContentType;
+(function (WebviewContentType) {
+    WebviewContentType["TEXT"] = "webview-text";
+    WebviewContentType["IMAGE"] = "webview-image";
+})(WebviewContentType || (exports.WebviewContentType = WebviewContentType = {}));
+//# sourceMappingURL=types.js.map

package/lib/esm/webview/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/webview/types.ts"],"names":[],"mappings":";;;AAEA,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,6CAAuB,CAAA;AACzB,CAAC,EAHW,kBAAkB,kCAAlB,kBAAkB,QAG7B"}

package/lib/esm/webview/use-webview-contents.d.ts

@@ -0,0 +1,2 @@
+import { type MapContentsType, type UseWebviewContents, type UseWebviewContentsProps } from './types';
+export declare function useWebviewContents<T extends MapContentsType>({ apiUrl, version, botId, webviewId, providerId, locale, mapContents, }: UseWebviewContentsProps<T>): UseWebviewContents<T>;

package/lib/esm/webview/use-webview-contents.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWebviewContents = useWebviewContents;
+const tslib_1 = require("tslib");
+const axios_1 = tslib_1.__importDefault(require("axios"));
+const react_1 = require("react");
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const types_2 = require("./types");
+function useWebviewContents({ apiUrl = constants_1.FLOW_BUILDER_API_URL_PROD, version = types_1.FlowBuilderJSONVersion.LATEST, botId, webviewId, providerId, locale, mapContents, }) {
+    const [textContents, setTextContents] = (0, react_1.useState)();
+    const [imageContents, setImageContents] = (0, react_1.useState)();
+    const [contents, setContents] = (0, react_1.useState)({});
+    const [currentLocale, setCurrentLocale] = (0, react_1.useState)(locale);
+    const [error, setError] = (0, react_1.useState)(false);
+    const updateCurrentLocale = (textContents) => {
+        if (!textContents || textContents.length === 0) {
+            console.log('There is no text contents to check the locale');
+            return;
+        }
+        const locales = textContents[0].content.text.map(text => text.locale);
+        const language = currentLocale.split('-')[0];
+        if (locales.includes(currentLocale)) {
+            setCurrentLocale(currentLocale);
+            return;
+        }
+        if (locales.includes(language)) {
+            setCurrentLocale(language);
+            return;
+        }
+        console.error(`locale: ${currentLocale} cannot be resolved with: ${locales.join(', ')}`);
+    };
+    const getTextContent = (contentID) => {
+        return (textContents
+            ?.find(textContent => textContent.code === contentID)
+            ?.content.text.find(text => text.locale === currentLocale)?.message ||
+            '');
+    };
+    const getImageSrc = (contentID) => {
+        return (imageContents
+            ?.find(imageContent => imageContent.code === contentID)
+            ?.content.image.find(image => image.locale === currentLocale)?.file ||
+            '');
+    };
+    (0, react_1.useEffect)(() => {
+        if (textContents || imageContents) {
+            const contentsObject = {};
+            for (const [key, value] of Object.entries(mapContents)) {
+                contentsObject[key] = getTextContent(value) || getImageSrc(value);
+            }
+            setContents(contentsObject);
+        }
+    }, [textContents, imageContents, currentLocale]);
+    (0, react_1.useEffect)(() => {
+        const getResponseContents = async () => {
+            const url = `${apiUrl}/v1/bot_flows/${botId}/versions/${version}/webviews/${webviewId}/?provider_id=${providerId}`;
+            try {
+                const response = await axios_1.default.get(url);
+                const textResponseContents = response.data.filter(webviewContent => webviewContent.type === types_2.WebviewContentType.TEXT);
+                setTextContents(textResponseContents);
+                const imageResponseContents = response.data.filter(webviewContent => webviewContent.type === types_2.WebviewContentType.IMAGE);
+                setImageContents(imageResponseContents);
+                updateCurrentLocale(textResponseContents);
+            }
+            catch (error) {
+                console.error('Error fetching webview contents:', error);
+                setError(true);
+            }
+        };
+        getResponseContents();
+    }, []);
+    return {
+        isLoading: Object.keys(contents).length === 0,
+        error,
+        webviewContentsContext: {
+            getTextContent,
+            getImageSrc,
+            setCurrentLocale,
+            contents,
+        },
+    };
+}
+//# sourceMappingURL=use-webview-contents.js.map

package/lib/esm/webview/use-webview-contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-webview-contents.js","sourceRoot":"","sources":["../../../src/webview/use-webview-contents.ts"],"names":[],"mappings":";;AAeA,gDAwGC;;AAvHD,0DAAyB;AACzB,iCAA2C;AAE3C,4CAAwD;AACxD,oCAAiD;AACjD,mCAQgB;AAEhB,SAAgB,kBAAkB,CAA4B,EAC5D,MAAM,GAAG,qCAAyB,EAClC,OAAO,GAAG,8BAAsB,CAAC,MAAM,EACvC,KAAK,EACL,SAAS,EACT,UAAU,EACV,MAAM,EACN,WAAW,GACgB;IAC3B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,IAAA,gBAAQ,GAAwB,CAAA;IACxE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,IAAA,gBAAQ,GAAyB,CAAA;IAC3E,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EACtC,EAA6B,CAC9B,CAAA;IACD,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,IAAA,gBAAQ,EAAC,MAAM,CAAC,CAAA;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAA;IAEzC,MAAM,mBAAmB,GAAG,CAAC,YAAmC,EAAE,EAAE;QAClE,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACrE,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAE5C,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpC,gBAAgB,CAAC,aAAa,CAAC,CAAA;YAC/B,OAAM;QACR,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,gBAAgB,CAAC,QAAQ,CAAC,CAAA;YAC1B,OAAM;QACR,CAAC;QAED,OAAO,CAAC,KAAK,CACX,WAAW,aAAa,6BAA6B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAA;IACH,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,CAAC,SAAiB,EAAU,EAAE;QACnD,OAAO,CACL,YAAY;YACV,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,SAAS,CAAC;YACrD,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,EAAE,OAAO;YACrE,EAAE,CACH,CAAA;IACH,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAU,EAAE;QAChD,OAAO,CACL,aAAa;YACX,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,SAAS,CAAC;YACvD,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC,EAAE,IAAI;YACrE,EAAE,CACH,CAAA;IACH,CAAC,CAAA;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,cAAc,GAAG,EAAE,CAAA;YACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAS,WAAW,CAAC,EAAE,CAAC;gBAC/D,cAAc,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;YACnE,CAAC;YACD,WAAW,CAAC,cAAyC,CAAC,CAAA;QACxD,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAA;IAEhD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,mBAAmB,GAAG,KAAK,IAAI,EAAE;YACrC,MAAM,GAAG,GAAG,GAAG,MAAM,iBAAiB,KAAK,aAAa,OAAO,aAAa,SAAS,iBAAiB,UAAU,EAAE,CAAA;YAClH,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAA0B,GAAG,CAAC,CAAA;gBAE9D,MAAM,oBAAoB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAC/C,cAAc,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,KAAK,0BAAkB,CAAC,IAAI,CAC1C,CAAA;gBACzB,eAAe,CAAC,oBAAoB,CAAC,CAAA;gBAErC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAChD,cAAc,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,KAAK,0BAAkB,CAAC,KAAK,CAC1C,CAAA;gBAC1B,gBAAgB,CAAC,qBAAqB,CAAC,CAAA;gBAEvC,mBAAmB,CAAC,oBAAoB,CAAC,CAAA;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAA;gBACxD,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC;QACH,CAAC,CAAA;QACD,mBAAmB,EAAE,CAAA;IACvB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;QAC7C,KAAK;QACL,sBAAsB,EAAE;YACtB,cAAc;YACd,WAAW;YACX,gBAAgB;YAChB,QAAQ;SACT;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,22 +1,21 @@
 {
-  "type": "module",
   "name": "@botonic/plugin-flow-builder",
-  "version": "0.57.0-rslib-esm.2",
-  "main": "./lib/index.js",
-  "module": "./lib/index.js",
+  "version": "0.57.0",
+  "main": "./lib/cjs/index.js",
+  "module": "./lib/esm/index.js",
   "description": "Use Flow Builder to show your contents",
   "scripts": {
-    "build": "rslib build --no-env",
-    "build:watch": "rslib build --watch --no-env",
-    "test": "vitest run --coverage",
+    "build": "rm -rf lib && ../../node_modules/.bin/tsc -p tsconfig.json && ../../node_modules/.bin/tsc -p tsconfig.esm.json",
+    "build:watch": "npm run build -- --watch",
+    "test": "../../node_modules/.bin/jest --coverage",
     "cloc": "../../scripts/qa/cloc-package.sh .",
-    "prepublishOnly": "npm run build && npm run test && npm run lint",
+    "prepublishOnly": "rm -rf lib && npm i && npm run build",
     "lint": "biome check --write src/ tests/",
     "lint:check": "biome check src/ tests/",
     "format": "biome format --write src/ tests/"
   },
   "dependencies": {
-    "@botonic/react": "0.57.0-rslib-esm.2",
+    "@botonic/react": "^0.57.0",
     "axios": "^1.18.1",
     "uuid": "^10.0.0"
   },
@@ -34,7 +33,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=22.19.0",
+    "node": ">=22.23.2",
     "npm": ">=10.0.0"
   },
   "keywords": [
@@ -47,6 +46,5 @@
   ],
   "devDependencies": {
     "@types/uuid": "^10.0.0"
-  },
-  "types": "./lib/index.d.ts"
+  }
 }

package/src/action/ai-agent-from-user-input.ts

@@ -1,3 +1,4 @@
+import { NluType } from '@botonic/core'
 import type { FlowContent } from '../content-fields/index'
 import { splitAiAgentContents } from '../utils/ai-agent'
 import type { FlowBuilderContext } from './context'
@@ -46,5 +47,11 @@ export async function getContentsByAiAgentFromUserInput({
     }
   }
 
+  request.input.nluResolution = {
+    type: NluType.AiAgent,
+    matchedValue: 'ai-agent-from-user-input',
+    payload: undefined,
+  }
+
   return contents
 }

package/src/action/first-interaction.ts

@@ -1,3 +1,4 @@
+import { NluType } from '@botonic/core'
 import type { FlowBuilderApi } from '../api'
 import { MAIN_FLOW_NAME } from '../constants'
 import {
@@ -51,6 +52,11 @@ export async function getContentsByFirstInteraction(
   if (request.input.nluResolution || inputHasTextOrTranscript(request.input)) {
     const contentsByUserInput = await getContentsByUserInput(context)
 
+    if (request.input.nluResolution?.type === NluType.AiAgent) {
+      const startContents = await flowBuilderPlugin.getStartContents()
+      return [...startContents, ...contentsByUserInput]
+    }
+
     return [...firstInteractionContents, ...contentsByUserInput]
   }
 

package/src/action/get-contents.ts

@@ -1,4 +1,9 @@
-import { type BotContext, INPUT } from '@botonic/core'
+import {
+  type BotContext,
+  INPUT,
+  type Input,
+  WhatsappInputOrigin,
+} from '@botonic/core'
 import { EMPTY_PAYLOAD } from '../constants'
 import type { FlowContent } from '../content-fields'
 import { inputHasTextOrTranscript } from '../utils/input'
@@ -35,7 +40,10 @@ export async function getContents(
     return await getContentsByFallback(context)
   }
 
-  if (inputHasTextOrTranscript(botContext.input)) {
+  if (
+    inputHasTextOrTranscript(botContext.input) ||
+    isContactRequested(botContext.input)
+  ) {
     const aiAgentContents = await getContentsByAiAgentFromUserInput(context)
     if (aiAgentContents.length > 0) {
       return aiAgentContents
@@ -44,3 +52,10 @@ export async function getContents(
 
   return await getContentsByFallback(context)
 }
+
+function isContactRequested(input: Input) {
+  return (
+    input.type === INPUT.CONTACT &&
+    input.origin === WhatsappInputOrigin.ContactRequest
+  )
+}

package/src/action/index.tsx

@@ -11,8 +11,10 @@ import {
   FlowAiAgent,
   FlowAiAgentRouter,
   type FlowContent,
+  FlowWhatsappRequestContactInfoNode,
 } from '../content-fields'
 import { splitAiAgentContents } from '../utils/ai-agent'
+import { getFlowBuilderPlugin } from '../utils/get-flow-builder-plugin'
 import { getFlowBuilderActionContext } from './context'
 import { getContentsByFirstInteraction } from './first-interaction'
 import { getContents } from './get-contents'
@@ -65,6 +67,11 @@ export class FlowBuilderAction extends React.Component<FlowBuilderActionProps> {
       }
 
       await content.processContent(botContext)
+
+      if (content instanceof FlowWhatsappRequestContactInfoNode) {
+        const flowBuilderPlugin = getFlowBuilderPlugin(botContext.plugins)
+        flowBuilderPlugin.cmsApi.setWhatsappRequestContactId(content.id)
+      }
     }
 
     return contents

package/src/api.ts

@@ -1,7 +1,12 @@
-import type { PluginPreRequest } from '@botonic/core'
+import type { BotContext } from '@botonic/core'
 import axios from 'axios'
 
-import { AI_AGENTS_FLOW_NAME, SEPARATOR, UUID_REGEXP } from './constants'
+import {
+  AI_AGENTS_FLOW_NAME,
+  PUSH_FLOW_PAYLOAD,
+  SEPARATOR,
+  UUID_REGEXP,
+} from './constants'
 import {
   type HtBotActionNode,
   type HtCaptureUserInputNode,
@@ -18,6 +23,7 @@ import {
   type HtRatingButton,
   type HtRatingNode,
   type HtSmartIntentNode,
+  type HtWhatsappRequestContactInfoNode,
 } from './content-fields/hubtype-fields'
 import {
   type FlowBuilderApiOptions,
@@ -30,7 +36,7 @@ export class FlowBuilderApi {
   url: string
   flowUrl: string
   flow: HtFlowBuilderData
-  request: PluginPreRequest
+  botContext: BotContext
 
   private constructor() {}
 
@@ -38,12 +44,12 @@ export class FlowBuilderApi {
     const newApi = new FlowBuilderApi()
 
     newApi.url = options.url
-    newApi.request = options.request
+    newApi.botContext = options.botContext
     // TODO: Refactor later to combine logic from `FlowBuilderApi.create`, `resolveFlowUrl` and `getAccessToken` to be in one place
     if (process.env.NODE_ENV === ProcessEnvNodeEnvs.DEVELOPMENT) {
       await newApi.updateSessionWithUserInfo(options.accessToken)
     }
-    const updatedRequest = newApi.request
+    const updatedRequest = newApi.botContext
     newApi.flowUrl = options.flowUrl.replace(
       '{bot_id}',
       updatedRequest.session.bot.id
@@ -64,8 +70,8 @@ export class FlowBuilderApi {
     const response = await axios.get(url, {
       headers: { Authorization: `Bearer ${token}` },
     })
-    this.request.session.organization_id = response.data.organization_id
-    this.request.session.bot.id = response.data.bot_id
+    this.botContext.session.organization_id = response.data.organization_id
+    this.botContext.session.bot.id = response.data.bot_id
   }
 
   getNodeByFlowId(id: string): HtNodeWithContent {
@@ -259,23 +265,23 @@ export class FlowBuilderApi {
   }
 
   getCaptureUserInputId(): string | undefined {
-    return this.request.session.capture_user_input?.node_id
+    return this.botContext.session.capture_user_input?.node_id
   }
 
   setCaptureUserInputId(id: string): void {
-    if (this.request.session.capture_user_input) {
-      this.request.session.capture_user_input.node_id = id
+    if (this.botContext.session.capture_user_input) {
+      this.botContext.session.capture_user_input.node_id = id
     }
-    this.request.session.capture_user_input = { node_id: id }
+    this.botContext.session.capture_user_input = { node_id: id }
   }
 
   removeCaptureUserInputId(): void {
-    this.request.session.capture_user_input = undefined
+    this.botContext.session.capture_user_input = undefined
   }
 
   setUserExtraDataVariable(key: string, value: string): void {
-    if (this.request.session.user.extra_data) {
-      this.request.session.user.extra_data[key] = value
+    if (this.botContext.session.user.extra_data) {
+      this.botContext.session.user.extra_data[key] = value
     }
   }
 
@@ -287,14 +293,45 @@ export class FlowBuilderApi {
     return this.getNodeById<HtCaptureUserInputNode>(captureUserInputId)
   }
 
+  getSessionWhatsappRequestContactId(): string | undefined {
+    return this.botContext.session.whatsapp_request_contact?.id
+  }
+
+  setWhatsappRequestContactId(id: string): void {
+    if (this.botContext.session.whatsapp_request_contact) {
+      this.botContext.session.whatsapp_request_contact.id = id
+    }
+    this.botContext.session.whatsapp_request_contact = { id }
+  }
+
+  removeWhatsappRequestContactId(): void {
+    this.botContext.session.whatsapp_request_contact = undefined
+  }
+
+  getWhatsappRequestContactInfoNode():
+    | HtWhatsappRequestContactInfoNode
+    | undefined {
+    const whatsappRequestContactId = this.getSessionWhatsappRequestContactId()
+    if (!whatsappRequestContactId) {
+      return undefined
+    }
+    return this.getNodeById<HtWhatsappRequestContactInfoNode>(
+      whatsappRequestContactId
+    )
+  }
+
   getResolvedLocale(): string {
     const flowLocales = this.flow.locales
     const defaultLocaleCode = this.flow.default_locale_code
 
     return new FlowLocale(
-      this.request,
+      this.botContext,
       flowLocales,
       defaultLocaleCode
     ).resolve()
   }
+
+  isPushFlowPayload(payload?: string): boolean {
+    return payload?.startsWith(PUSH_FLOW_PAYLOAD) ?? false
+  }
 }

package/src/bot-context-manager.ts

@@ -0,0 +1,153 @@
+import {
+  type BotContext,
+  INPUT,
+  PROVIDER,
+  WhatsappInputOrigin,
+} from '@botonic/core'
+
+import type { FlowBuilderApi } from './api'
+import {
+  EMPTY_PAYLOAD,
+  ON_CLOSE_HANDOFF_PAYLOAD,
+  SEPARATOR,
+  SOURCE_INFO_SEPARATOR,
+} from './constants'
+import { FlowHandoff } from './content-fields'
+import {
+  type HtBotActionNode,
+  type HtHandoffNode,
+  HtNodeWithContentType,
+} from './content-fields/hubtype-fields'
+import { getNextPayloadByUserInput } from './user-input'
+import type { SmartIntentsInferenceConfig } from './user-input/smart-intent'
+import { inputHasTextOrTranscript } from './utils/input'
+
+export class BotContextManager {
+  constructor(
+    private readonly cmsApi: FlowBuilderApi,
+    private readonly smartIntentsConfig: SmartIntentsInferenceConfig
+  ) {}
+
+  async prepareInputForRoutes(botContext: BotContext): Promise<void> {
+    // When AI Agent is executed in Whatsapp, button payloads come as referral and must be converted to text being processed by the agent.
+    this.convertWhatsappAiAgentEmptyPayloads(botContext)
+
+    // If the payload is a push-flow payload, set first interaction to false
+    this.updateFirstInteractionOnPushFlowPayload(botContext)
+
+    this.resolveWhatsappContactRequestPayload(botContext)
+    this.resolveOnCloseHandoffPayload(botContext)
+
+    await this.resolvePayloadFromUserTextInput(botContext)
+
+    this.cmsApi.removeCaptureUserInputId()
+    this.removePayloadSourceSuffix(botContext)
+    this.resolveBotActionPayload(botContext)
+  }
+
+  private async updateFirstInteractionOnPushFlowPayload(
+    botContext: BotContext
+  ): Promise<void> {
+    if (this.cmsApi.isPushFlowPayload(botContext.input.payload)) {
+      botContext.session.is_first_interaction = false
+    }
+  }
+
+  private async resolvePayloadFromUserTextInput(
+    botContext: BotContext
+  ): Promise<void> {
+    const checkUserTextInput =
+      inputHasTextOrTranscript(botContext.input) && !botContext.input.payload
+
+    if (!checkUserTextInput) {
+      return
+    }
+
+    const resolvedLocale = this.cmsApi.getResolvedLocale()
+    const nextPayload = await getNextPayloadByUserInput(
+      this.cmsApi,
+      resolvedLocale,
+      botContext,
+      this.smartIntentsConfig
+    )
+    botContext.input.payload = nextPayload
+  }
+
+  private resolveWhatsappContactRequestPayload(botContext: BotContext): void {
+    if (
+      botContext.input.type !== INPUT.CONTACT ||
+      botContext.input.origin !== WhatsappInputOrigin.ContactRequest
+    ) {
+      return
+    }
+
+    const whatsappRequestContactInfoNode =
+      this.cmsApi.getWhatsappRequestContactInfoNode()
+
+    if (whatsappRequestContactInfoNode) {
+      botContext.input.payload = this.cmsApi.getPayload(
+        whatsappRequestContactInfoNode.content.button.target
+      )
+    }
+
+    this.cmsApi.removeWhatsappRequestContactId()
+  }
+
+  private resolveOnCloseHandoffPayload(botContext: BotContext): void {
+    if (botContext.input.payload?.startsWith(ON_CLOSE_HANDOFF_PAYLOAD)) {
+      const handoffNodeId = botContext.input.payload.split(SEPARATOR)[1]
+      const handoffNode = this.cmsApi.getNodeById<HtHandoffNode>(handoffNodeId)
+      if (handoffNode && handoffNode.type === HtNodeWithContentType.HANDOFF) {
+        const flowHandoff = FlowHandoff.fromHubtypeCMS(
+          handoffNode,
+          this.cmsApi.getResolvedLocale(),
+          this.cmsApi
+        )
+        botContext.input.payload = flowHandoff.resolveOnClosePayload(botContext)
+      }
+    }
+  }
+
+  private convertWhatsappAiAgentEmptyPayloads(botContext: BotContext): void {
+    if (botContext.session.user.provider === PROVIDER.WHATSAPP) {
+      const shouldUseReferral =
+        botContext.input.referral &&
+        botContext.input.payload?.startsWith(EMPTY_PAYLOAD)
+
+      if (shouldUseReferral) {
+        botContext.input.type = INPUT.TEXT
+        botContext.input.data = botContext.input.referral
+      }
+    }
+  }
+
+  private removePayloadSourceSuffix(botContext: BotContext): void {
+    if (botContext.input.payload) {
+      botContext.input.payload = this.removeSourceSuffix(
+        botContext.input.payload
+      )
+    }
+  }
+
+  private resolveBotActionPayload(botContext: BotContext): void {
+    if (
+      botContext.input.payload &&
+      this.cmsApi.isBotAction(botContext.input.payload)
+    ) {
+      const cmsBotAction = this.cmsApi.getNodeById<HtBotActionNode>(
+        botContext.input.payload
+      )
+
+      botContext.input.payload =
+        this.cmsApi.createPayloadWithParams(cmsBotAction)
+
+      // Re-execute convertWhatsappAiAgentEmptyPayloads function to handle
+      // the case that a BotAction has a payload equals to EMPTY_PAYLOAD
+      this.convertWhatsappAiAgentEmptyPayloads(botContext)
+    }
+  }
+
+  private removeSourceSuffix(payload: string): string {
+    return payload.split(SOURCE_INFO_SEPARATOR)[0]
+  }
+}