@botonic/plugin-flow-builder 0.57.0-rslib-esm.1 → 0.58.0-alpha-new-stack.0

package/lib/utils/hubtype-assistant-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils/hubtype-assistant-content.js","sources":["../../src/utils/hubtype-assistant-content.ts"],"sourcesContent":["import { WhatsappCTAUrlHeaderType } from '@botonic/react'\nimport type { FlowContent } from '../content-fields'\nimport type { FlowButton } from '../content-fields/flow-button'\nimport { FlowCarousel } from '../content-fields/flow-carousel'\nimport { FlowImage } from '../content-fields/flow-image'\nimport { FlowText } from '../content-fields/flow-text'\nimport { FlowVideo } from '../content-fields/flow-video'\nimport { FlowWhatsappCtaUrlButtonNode } from '../content-fields/flow-whatsapp-cta-url-button'\nimport { FlowWhatsappTemplate } from '../content-fields/flow-whatsapp-template'\nimport { HtButtonStyle } from '../content-fields/hubtype-fields'\nimport { FlowWhatsappButtonList } from '../content-fields/whatsapp-button-list/flow-whatsapp-button-list'\n\n// biome-ignore lint/complexity/noStaticOnlyClass: namespace-like adapter with private static helpers\nexport class HubtypeAssistantContent {\n  static adapt(content: FlowContent): string {\n    if (content instanceof FlowText) {\n      return HubtypeAssistantContent.formatFlowTextContent(content)\n    }\n    if (content instanceof FlowCarousel) {\n      return HubtypeAssistantContent.formatCarouselContent(content)\n    }\n    if (content instanceof FlowImage) {\n      return content.src ? `[Image]\\n${content.src}` : '[Image]'\n    }\n    if (content instanceof FlowVideo) {\n      return content.src ? `[Video]\\n${content.src}` : '[Video]'\n    }\n    if (content instanceof FlowWhatsappButtonList) {\n      return HubtypeAssistantContent.formatWhatsappButtonListContent(content)\n    }\n    if (content instanceof FlowWhatsappCtaUrlButtonNode) {\n      return HubtypeAssistantContent.formatWhatsappCtaContent(content)\n    }\n    if (content instanceof FlowWhatsappTemplate) {\n      return HubtypeAssistantContent.formatWhatsappTemplateContent(content)\n    }\n    return ''\n  }\n\n  private static quickReplyLabel(button: FlowButton): string {\n    const buttonText = button.text?.trim()\n    if (buttonText) {\n      return buttonText\n    }\n\n    return button.payload || 'Option'\n  }\n\n  private static persistentButtonLabel(button: FlowButton): string {\n    return button.text?.trim() || 'Button'\n  }\n\n  private static carouselButtonLabel(button: FlowButton): string {\n    return button.text?.trim() || 'Action'\n  }\n\n  private static formatFlowTextContent(text: FlowText): string {\n    const body = text.text?.trim() ?? ''\n    const buttons = text.buttons\n\n    if (!body && buttons.length === 0) {\n      return ''\n    }\n\n    if (buttons.length === 0) {\n      return text.text\n    }\n\n    const isQuickReply = text.buttonStyle === HtButtonStyle.QUICK_REPLY\n    const blockTitle = isQuickReply ? 'Quick replies:' : 'Buttons:'\n    const lines = buttons.map((button, i) => {\n      const label = isQuickReply\n        ? HubtypeAssistantContent.quickReplyLabel(button)\n        : HubtypeAssistantContent.persistentButtonLabel(button)\n      return `  [${i + 1}] ${label}`\n    })\n\n    const block = [blockTitle, ...lines].join('\\n')\n    if (!body) {\n      return block\n    }\n\n    return `${body}\\n\\n${block}`\n  }\n\n  private static formatCarouselContent(carousel: FlowCarousel): string {\n    const elements = carousel.elements\n    const n = elements.length\n    const mainText = (carousel.whatsappText ?? '').trim()\n\n    if (n === 0) {\n      return mainText\n    }\n\n    let header: string\n    if (!mainText) {\n      header = `Carousel displayed with ${n} items:`\n    } else if (mainText.endsWith(':')) {\n      header = mainText\n    } else {\n      header = `${mainText}\\nCarousel with ${n} items:`\n    }\n\n    const itemLines = elements.map((element, index) => {\n      const title = element.title?.trim() || 'Item'\n      const subtitle = element.subtitle?.trim()\n      const subtitlePart = subtitle ? ` - ${subtitle}` : ''\n      const btnLabels: string[] = []\n      if (element.button) {\n        btnLabels.push(\n          HubtypeAssistantContent.carouselButtonLabel(element.button)\n        )\n      }\n      const btnPart = btnLabels.length > 0 ? ` [${btnLabels.join(', ')}]` : ''\n\n      return `  ${index + 1}. \"${title}\"${subtitlePart}${btnPart}`\n    })\n\n    return [header, ...itemLines].join('\\n')\n  }\n\n  private static formatWhatsappButtonListContent(\n    list: FlowWhatsappButtonList\n  ): string {\n    const body = list.text?.trim() ?? ''\n    const hasSections = list.sections.some(s => s.rows.length > 0)\n\n    if (!body && !hasSections) {\n      return '[WhatsApp Button List]'\n    }\n\n    const parts: string[] = []\n    if (body) {\n      parts.push(body)\n    }\n\n    if (hasSections) {\n      const sectionBlocks = list.sections.map(section => {\n        const rowLines = section.rows.map(row => {\n          const rowTitle = row.title?.trim() ?? ''\n          const rowDescription = row.description?.trim() ?? ''\n          if (!rowTitle && !rowDescription) {\n            return '  - '\n          }\n          if (!rowTitle) {\n            return `  - ${rowDescription}`\n          }\n          if (!rowDescription) {\n            return `  - ${rowTitle}`\n          }\n          return `  - ${rowTitle}: ${rowDescription}`\n        })\n        const rowsText = rowLines.join('\\n')\n\n        const sectionTitle = section.title?.trim()\n        if (sectionTitle) {\n          return `${sectionTitle}:\\n${rowsText}`\n        }\n\n        return rowsText\n      })\n      parts.push(sectionBlocks.join('\\n'))\n    }\n\n    return parts.join('\\n\\n')\n  }\n\n  private static formatWhatsappCtaContent(\n    cta: FlowWhatsappCtaUrlButtonNode\n  ): string {\n    const hasStructuredData =\n      (cta.headerType === WhatsappCTAUrlHeaderType.Text &&\n        !!cta.header?.trim()) ||\n      cta.text?.trim() ||\n      cta.footer?.trim() ||\n      cta.displayText?.trim() ||\n      cta.url\n\n    if (!hasStructuredData) {\n      return cta.text?.trim() || '[WhatsApp CTA Button]'\n    }\n\n    const lines: string[] = []\n    if (\n      cta.headerType === WhatsappCTAUrlHeaderType.Text &&\n      cta.header?.trim()\n    ) {\n      lines.push(cta.header.trim())\n    }\n    if (cta.text?.trim()) {\n      lines.push(cta.text.trim())\n    }\n    if (cta.footer?.trim()) {\n      lines.push(cta.footer.trim())\n    }\n    const ctaLine = `[${cta.displayText || ''}]${cta.url ? ` (${cta.url})` : ''}`\n    lines.push(ctaLine)\n\n    return lines.join('\\n')\n  }\n\n  private static formatWhatsappTemplateContent(\n    template: FlowWhatsappTemplate\n  ): string {\n    const { name, language } = template.htWhatsappTemplate\n    return `WhatsApp Template: ${name} (${language})`\n  }\n}\n"],"names":["WhatsappCTAUrlHeaderType","FlowCarousel","FlowImage","FlowText","FlowVideo","FlowWhatsappCtaUrlButtonNode","FlowWhatsappTemplate","HtButtonStyle","FlowWhatsappButtonList","HubtypeAssistantContent","content","button","buttonText","text","body","buttons","isQuickReply","blockTitle","lines","i","label","block","carousel","elements","n","mainText","header","itemLines","element","index","title","subtitle","subtitlePart","btnLabels","btnPart","list","hasSections","s","parts","sectionBlocks","section","rowLines","row","rowTitle","rowDescription","rowsText","sectionTitle","cta","hasStructuredData","ctaLine","template","name","language"],"mappings":"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"}
+{"version":3,"file":"utils/hubtype-assistant-content.js","sources":["../../src/utils/hubtype-assistant-content.ts"],"sourcesContent":["import { WhatsappCTAUrlHeaderType } from '@botonic/react'\nimport type { FlowContent } from '../content-fields'\nimport type { FlowButton } from '../content-fields/flow-button'\nimport { FlowCarousel } from '../content-fields/flow-carousel'\nimport { FlowImage } from '../content-fields/flow-image'\nimport { FlowText } from '../content-fields/flow-text'\nimport { FlowVideo } from '../content-fields/flow-video'\nimport { FlowWhatsappCtaUrlButtonNode } from '../content-fields/flow-whatsapp-cta-url-button'\nimport { FlowWhatsappRequestContactInfoNode } from '../content-fields/flow-whatsapp-request-contact-info'\nimport { FlowWhatsappTemplate } from '../content-fields/flow-whatsapp-template'\nimport { HtButtonStyle } from '../content-fields/hubtype-fields'\nimport { FlowWhatsappButtonList } from '../content-fields/whatsapp-button-list/flow-whatsapp-button-list'\n\n// biome-ignore lint/complexity/noStaticOnlyClass: namespace-like adapter with private static helpers\nexport class HubtypeAssistantContent {\n  static adapt(content: FlowContent): string {\n    if (content instanceof FlowText) {\n      return HubtypeAssistantContent.formatFlowTextContent(content)\n    }\n    if (content instanceof FlowCarousel) {\n      return HubtypeAssistantContent.formatCarouselContent(content)\n    }\n    if (content instanceof FlowImage) {\n      return content.src ? `[Image]\\n${content.src}` : '[Image]'\n    }\n    if (content instanceof FlowVideo) {\n      return content.src ? `[Video]\\n${content.src}` : '[Video]'\n    }\n    if (content instanceof FlowWhatsappButtonList) {\n      return HubtypeAssistantContent.formatWhatsappButtonListContent(content)\n    }\n    if (content instanceof FlowWhatsappCtaUrlButtonNode) {\n      return HubtypeAssistantContent.formatWhatsappCtaContent(content)\n    }\n    if (content instanceof FlowWhatsappTemplate) {\n      return HubtypeAssistantContent.formatWhatsappTemplateContent(content)\n    }\n    if (content instanceof FlowWhatsappRequestContactInfoNode) {\n      return HubtypeAssistantContent.formatRequestContactInfoContent(content)\n    }\n    return ''\n  }\n\n  private static quickReplyLabel(button: FlowButton): string {\n    const buttonText = button.text?.trim()\n    if (buttonText) {\n      return buttonText\n    }\n\n    return button.payload || 'Option'\n  }\n\n  private static persistentButtonLabel(button: FlowButton): string {\n    return button.text?.trim() || 'Button'\n  }\n\n  private static carouselButtonLabel(button: FlowButton): string {\n    return button.text?.trim() || 'Action'\n  }\n\n  private static formatFlowTextContent(text: FlowText): string {\n    const body = text.text?.trim() ?? ''\n    const buttons = text.buttons\n\n    if (!body && buttons.length === 0) {\n      return ''\n    }\n\n    if (buttons.length === 0) {\n      return text.text\n    }\n\n    const isQuickReply = text.buttonStyle === HtButtonStyle.QUICK_REPLY\n    const blockTitle = isQuickReply ? 'Quick replies:' : 'Buttons:'\n    const lines = buttons.map((button, i) => {\n      const label = isQuickReply\n        ? HubtypeAssistantContent.quickReplyLabel(button)\n        : HubtypeAssistantContent.persistentButtonLabel(button)\n      return `  [${i + 1}] ${label}`\n    })\n\n    const block = [blockTitle, ...lines].join('\\n')\n    if (!body) {\n      return block\n    }\n\n    return `${body}\\n\\n${block}`\n  }\n\n  private static formatCarouselContent(carousel: FlowCarousel): string {\n    const elements = carousel.elements\n    const n = elements.length\n    const mainText = (carousel.whatsappText ?? '').trim()\n\n    if (n === 0) {\n      return mainText\n    }\n\n    let header: string\n    if (!mainText) {\n      header = `Carousel displayed with ${n} items:`\n    } else if (mainText.endsWith(':')) {\n      header = mainText\n    } else {\n      header = `${mainText}\\nCarousel with ${n} items:`\n    }\n\n    const itemLines = elements.map((element, index) => {\n      const title = element.title?.trim() || 'Item'\n      const subtitle = element.subtitle?.trim()\n      const subtitlePart = subtitle ? ` - ${subtitle}` : ''\n      const btnLabels: string[] = []\n      if (element.button) {\n        btnLabels.push(\n          HubtypeAssistantContent.carouselButtonLabel(element.button)\n        )\n      }\n      const btnPart = btnLabels.length > 0 ? ` [${btnLabels.join(', ')}]` : ''\n\n      return `  ${index + 1}. \"${title}\"${subtitlePart}${btnPart}`\n    })\n\n    return [header, ...itemLines].join('\\n')\n  }\n\n  private static formatWhatsappButtonListContent(\n    list: FlowWhatsappButtonList\n  ): string {\n    const body = list.text?.trim() ?? ''\n    const hasSections = list.sections.some(s => s.rows.length > 0)\n\n    if (!body && !hasSections) {\n      return '[WhatsApp Button List]'\n    }\n\n    const parts: string[] = []\n    if (body) {\n      parts.push(body)\n    }\n\n    if (hasSections) {\n      const sectionBlocks = list.sections.map(section => {\n        const rowLines = section.rows.map(row => {\n          const rowTitle = row.title?.trim() ?? ''\n          const rowDescription = row.description?.trim() ?? ''\n          if (!rowTitle && !rowDescription) {\n            return '  - '\n          }\n          if (!rowTitle) {\n            return `  - ${rowDescription}`\n          }\n          if (!rowDescription) {\n            return `  - ${rowTitle}`\n          }\n          return `  - ${rowTitle}: ${rowDescription}`\n        })\n        const rowsText = rowLines.join('\\n')\n\n        const sectionTitle = section.title?.trim()\n        if (sectionTitle) {\n          return `${sectionTitle}:\\n${rowsText}`\n        }\n\n        return rowsText\n      })\n      parts.push(sectionBlocks.join('\\n'))\n    }\n\n    return parts.join('\\n\\n')\n  }\n\n  private static formatWhatsappCtaContent(\n    cta: FlowWhatsappCtaUrlButtonNode\n  ): string {\n    const hasStructuredData =\n      (cta.headerType === WhatsappCTAUrlHeaderType.Text &&\n        !!cta.header?.trim()) ||\n      cta.text?.trim() ||\n      cta.footer?.trim() ||\n      cta.displayText?.trim() ||\n      cta.url\n\n    if (!hasStructuredData) {\n      return cta.text?.trim() || '[WhatsApp CTA Button]'\n    }\n\n    const lines: string[] = []\n    if (\n      cta.headerType === WhatsappCTAUrlHeaderType.Text &&\n      cta.header?.trim()\n    ) {\n      lines.push(cta.header.trim())\n    }\n    if (cta.text?.trim()) {\n      lines.push(cta.text.trim())\n    }\n    if (cta.footer?.trim()) {\n      lines.push(cta.footer.trim())\n    }\n    const ctaLine = `[${cta.displayText || ''}]${cta.url ? ` (${cta.url})` : ''}`\n    lines.push(ctaLine)\n\n    return lines.join('\\n')\n  }\n\n  private static formatWhatsappTemplateContent(\n    template: FlowWhatsappTemplate\n  ): string {\n    const { name, language } = template.htWhatsappTemplate\n    return `WhatsApp Template: ${name} (${language})`\n  }\n\n  private static formatRequestContactInfoContent(\n    requestContactInfo: FlowWhatsappRequestContactInfoNode\n  ): string {\n    const body = requestContactInfo.text?.trim() ?? ''\n    if (!body) {\n      return '[WhatsApp Request Contact Info]'\n    }\n    return requestContactInfo.text\n  }\n}\n"],"names":["WhatsappCTAUrlHeaderType","FlowCarousel","FlowImage","FlowText","FlowVideo","FlowWhatsappCtaUrlButtonNode","FlowWhatsappRequestContactInfoNode","FlowWhatsappTemplate","HtButtonStyle","FlowWhatsappButtonList","HubtypeAssistantContent","content","button","buttonText","text","body","buttons","isQuickReply","blockTitle","lines","i","label","block","carousel","elements","n","mainText","header","itemLines","element","index","title","subtitle","subtitlePart","btnLabels","btnPart","list","hasSections","s","parts","sectionBlocks","section","rowLines","row","rowTitle","rowDescription","rowsText","sectionTitle","cta","hasStructuredData","ctaLine","template","name","language","requestContactInfo"],"mappings":"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"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "type": "module",
   "name": "@botonic/plugin-flow-builder",
-  "version": "0.57.0-rslib-esm.1",
+  "version": "0.58.0-alpha-new-stack.0",
   "main": "./lib/index.js",
   "module": "./lib/index.js",
   "description": "Use Flow Builder to show your contents",
   "scripts": {
     "build": "rslib build --no-env",
     "build:watch": "rslib build --watch --no-env",
-    "test": "../../node_modules/.bin/jest --coverage",
+    "test": "vitest run --coverage",
     "cloc": "../../scripts/qa/cloc-package.sh .",
     "prepublishOnly": "npm run build && npm run test && npm run lint",
     "lint": "biome check --write src/ tests/",
@@ -16,7 +16,7 @@
     "format": "biome format --write src/ tests/"
   },
   "dependencies": {
-    "@botonic/react": "0.57.0-rslib-esm.1",
+    "@botonic/react": "0.58.0-alpha-new-stack.0",
     "axios": "^1.18.1",
     "uuid": "^10.0.0"
   },
@@ -34,7 +34,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=22.19.0",
+    "node": ">=22.23.2",
     "npm": ">=10.0.0"
   },
   "keywords": [

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]
+  }
+}

package/src/constants.ts

@@ -2,7 +2,6 @@ export const FLOW_BUILDER_API_URL_PROD =
   process.env.HUBTYPE_API_URL || 'https://api.hubtype.com'
 export const SEPARATOR = '|'
 export const SOURCE_INFO_SEPARATOR = `${SEPARATOR}source_`
-export const EMPTY_PAYLOAD = 'fb-empty-payload'
 export const VARIABLE_PATTERN_GLOBAL = /{([^{}]+)}/g
 export const ACCESS_TOKEN_VARIABLE_KEY = '_access_token'
 export const REG_EXP_PATTERN = /^\/(.*)\/([gimyus]*)$/
@@ -10,6 +9,8 @@ export const UUID_REGEXP =
   /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
 
 /* ********** PAYLOADS ********** */
+export const EMPTY_PAYLOAD = 'fb-empty-payload'
+export const ON_CLOSE_HANDOFF_PAYLOAD = 'fb-on-close-handoff'
 export const AGENT_RATING_PAYLOAD = 'agent-rating'
 export const PUSH_FLOW_PAYLOAD = 'push-flow'
 

package/src/content-fields/contact-reasons-conditional-matcher.ts

@@ -0,0 +1,24 @@
+import type { HubtypeCaseContactReason } from '@botonic/core'
+
+import type { HtContactReasonBranch } from './hubtype-fields/contact-reasons-conditional'
+
+export function contactReasonMatchesBranch(
+  sessionContactReason: HubtypeCaseContactReason,
+  branch: HtContactReasonBranch
+): boolean {
+  return (
+    sessionContactReason.project_id === branch.project_id &&
+    sessionContactReason.name === branch.name
+  )
+}
+
+export function findMatchingContactReasonBranch(
+  sessionContactReasons: HubtypeCaseContactReason[],
+  contactReasonBranches: HtContactReasonBranch[]
+): HtContactReasonBranch | undefined {
+  return contactReasonBranches.find(branch =>
+    sessionContactReasons.some(sessionContactReason =>
+      contactReasonMatchesBranch(sessionContactReason, branch)
+    )
+  )
+}

package/src/content-fields/flow-ai-agent-base.tsx

@@ -16,6 +16,7 @@ import { HubtypeAssistantContent } from '../utils/hubtype-assistant-content'
 import { ContentFieldsBase } from './content-fields-base'
 import { FlowCarousel } from './flow-carousel'
 import { FlowText } from './flow-text'
+import { FlowWhatsappRequestContactInfoNode } from './flow-whatsapp-request-contact-info'
 import type { HtInputGuardrailRule, HtNodeWithContent } from './hubtype-fields'
 import type { FlowContent } from './index'
 
@@ -89,6 +90,16 @@ export abstract class FlowAiAgentBase extends ContentFieldsBase {
         )
       }
 
+      if (message.type === OutputMessageType.RequestContactInfo) {
+        this.jsxElements.push(
+          FlowWhatsappRequestContactInfoNode.fromAIAgent(
+            this.id,
+            message,
+            botContext
+          )
+        )
+      }
+
       if (message.type === FlowBuilderOutputMessageType.FlowBuilderContent) {
         const flowContents = await this.getFlowContentsByContentId(
           botContext,
@@ -107,7 +118,7 @@ export abstract class FlowAiAgentBase extends ContentFieldsBase {
     botContext: BotContext,
     previousContents?: FlowContent[]
   ): Promise<void> {
-    if (this.messages.length === 0) {
+    if (!this.aiAgentResponse) {
       await this.resolveAIAgentResponse(botContext, previousContents)
     }
     if (this.jsxElements.length === 0) {

package/src/content-fields/flow-ai-agent-router.tsx

@@ -194,6 +194,7 @@ export class FlowAiAgentRouter extends FlowAiAgentBase {
       inputGuardrailsTriggered: [],
       outputGuardrailsTriggered:
         this.aiAgentResponse?.outputGuardrailsTriggered ?? [],
+      doNothing: this.aiAgentResponse?.doNothing ?? false,
     }
     const { action, ...specialistEventArgs } = specialistEvent
     await trackEvent(botContext, action, specialistEventArgs)

package/src/content-fields/flow-ai-agent.tsx

@@ -94,6 +94,7 @@ export class FlowAiAgent extends FlowAiAgentBase {
         this.aiAgentResponse?.inputGuardrailsTriggered ?? [],
       outputGuardrailsTriggered: [], //aiAgentResponse.outputGuardrailsTriggered,
       error: this.aiAgentResponse?.error ?? false,
+      doNothing: this.aiAgentResponse?.doNothing ?? false,
     }
     const { action, ...eventArgs } = event
 

package/src/content-fields/flow-contact-reasons-conditional.tsx

@@ -0,0 +1,90 @@
+import {
+  type BotContext,
+  EventAction,
+  type EventConditionalContactReasons,
+} from '@botonic/core'
+
+import {
+  getCommonFlowContentEventArgsForContentId,
+  trackEvent,
+} from '../tracking'
+import { findMatchingContactReasonBranch } from './contact-reasons-conditional-matcher'
+import { ContentFieldsBase } from './content-fields-base'
+import type { HtNodeLink } from './hubtype-fields/common'
+import type {
+  HtContactReasonBranch,
+  HtContactReasonsNode,
+} from './hubtype-fields/contact-reasons-conditional'
+
+export class FlowContactReasonsConditional extends ContentFieldsBase {
+  public contactReasons: HtContactReasonBranch[] = []
+  public conditionalResult: string = ''
+  public defaultTarget: HtNodeLink
+
+  static fromHubtypeCMS(
+    component: HtContactReasonsNode,
+    botContext: BotContext
+  ): FlowContactReasonsConditional {
+    const newContactReasonsConditional = new FlowContactReasonsConditional(
+      component.id
+    )
+    newContactReasonsConditional.contactReasons =
+      component.content.contact_reasons
+    newContactReasonsConditional.defaultTarget =
+      component.content.default_target
+    newContactReasonsConditional.setFollowUp(botContext)
+    return newContactReasonsConditional
+  }
+
+  private setFollowUp(botContext: BotContext): void {
+    const sessionContactReasons =
+      botContext.session._hubtype_case_contact_reasons
+
+    const matchingBranch = sessionContactReasons
+      ? findMatchingContactReasonBranch(
+          sessionContactReasons,
+          this.contactReasons
+        )
+      : undefined
+
+    if (matchingBranch) {
+      this.conditionalResult = matchingBranch.name
+      this.followUp = matchingBranch.target
+    } else {
+      this.conditionalResult = 'default'
+      this.followUp = this.defaultTarget
+    }
+  }
+
+  async trackFlow(botContext: BotContext): Promise<void> {
+    const { flowThreadId, flowId, flowName, flowNodeId, flowNodeContentId } =
+      getCommonFlowContentEventArgsForContentId(botContext, this.id)
+    const eventContactReasonsConditional: EventConditionalContactReasons = {
+      action: EventAction.ConditionalContactReasons,
+      flowThreadId,
+      flowId,
+      flowName,
+      flowNodeId,
+      flowNodeContentId,
+      flowNodeIsMeaningful: false,
+      contactReasons:
+        botContext.session._hubtype_case_contact_reasons?.map(
+          contactReason => contactReason.name
+        ) || [],
+      result: this.conditionalResult,
+    }
+    const { action, ...eventArgs } = eventContactReasonsConditional
+    await trackEvent(botContext, action, eventArgs)
+    return
+  }
+
+  async processContent(botContext: BotContext): Promise<void> {
+    await this.filterContent(botContext, this)
+    await this.trackFlow(botContext)
+    return
+  }
+
+  toBotonic() {
+    return <></>
+  }
+}