Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.
What is a messaging connection?
A messaging connection links a messaging AI agent (Retell or Vapi) to your GHL location. When an inbound message arrives (SMS, WhatsApp, Instagram, etc.), a GHL workflow can route it to your messaging connection, and the AI reads the message, generates a response, and sends it back through GHL Conversations.
Messaging connections are separate from voice connections. A voice connection handles phone calls. A messaging connection handles text-based conversations. Create one of each if your AI handles both.
Create a messaging connection
Open your provider page
In the Sympana dashboard, open the Retell or Vapi page.
Switch to Messaging Connections
Click the Messaging tab at the top of the page (next to Voice).
Click Add Messaging Connection
Click the button to create a new messaging connection.
Enter a connection name
Give it a clear name like “SMS Support Agent” or “WhatsApp Sales Bot.”
Select your messaging AI agent
Choose the Retell or Vapi agent that will handle messages. This should be an agent configured for text conversations, not voice.
Select a calendar (optional)
Only needed if the messaging agent uses appointment functions (Book Appointment, Get Slots, etc.). Skip this if the agent only handles general conversations.
Configure Contact Access
Set up who the AI is allowed to message. See Contact Access below.
Select functions
Choose which functions the messaging agent can use — same 11 functions as voice connections (Book Appointment, Get Contact, Update Contact Data, etc.).
Configure dynamic variables
Add variables the agent needs in its prompt — contact name, email, custom fields, etc.
Configure Human Handoff
Set up keywords and rules for when the AI should stop and hand off to a human. See Human Handoff below.
Save the connection
Click Save or Create Connection. The connection is now available for use in GHL workflows.
Contact Access
Contact Access controls who the messaging AI is allowed to talk to. This prevents your AI from responding to contacts it shouldn’t.
Setting
What it does
Allowed Tags
If set, only contacts with at least one of these tags receive AI replies. Everyone else is skipped.
Blocked Tags
Contacts with any of these tags are skipped — AI will not respond.
Handoff Tags
Contacts with these tags are treated as “handed off to a human” — AI stops replying.
Opt-out Keywords
Words like stop, unsubscribe, wrong number. If a contact sends one of these, AI stops replying.
Recommended setup for outbound messaging
If you are sending outbound messages to contacts and want AI to handle replies:
Add a tag like ai_msg_enabled to the contacts you want AI to respond to
In the Message Received workflow, only call Send AI Message if the contact has the ai_msg_enabled tag
If a contact opts out, apply ai_msg_blocked and remove ai_msg_enabled
If a contact asks for a human, apply ai_msg_handoff to stop AI replies
Contact Access is your safety net. It ensures the AI only talks to people you’ve explicitly approved, preventing unwanted automated responses.
Human Handoff
Human handoff pauses AI responses when a contact asks for a real person or when a human team member manually replies.
How it works
Contact triggers handoff
The contact sends something like “I want to talk to a person” or “Can I speak to someone?”
Sympana detects the keyword
Sympana checks the message against your configured handoff keywords.
Conversation is paused
The conversation is marked as handed off. The AI stops replying to this contact.
Handoff Requested trigger fires
Sympana fires the Handoff Requested trigger into GHL so your workflow can take action.
Human takes over
A team member replies manually inside GHL Conversations.
Recommended handoff workflow
Build this GHL workflow to handle handoffs:
Trigger: Handoff Requested (Sympana) → Action: Add Tag "ai_msg_handoff" → Action: Assign contact to team member → Action: Send internal notification (SMS/email to your team) → Optional: Create Task "Follow up with {{contact_first_name}}"
Messaging workflow
After creating a messaging connection, build a GHL workflow to use it:
Create a new workflow
In GHL, go to Automation → Workflows and create a new workflow.
Add the Message Received trigger
Search for Message Received under Sympana Connector.
Add channel filters (optional)
Filter by channel if you only want to handle specific message types: SMS, WhatsApp, Instagram, Facebook, Webchat, TikTok, or Email.
If no channel filter is applied, the workflow responds to ALL inbound message channels. Channel filtering belongs in the GHL trigger, not in the messaging connection itself.
Add contact tag filters (optional)
Add an If/Else condition to check for the ai_msg_enabled tag before sending to AI.
Add the Send AI Message action
Search for Send AI Message under Sympana Connector. Select your messaging connection.
Publish and test
Publish the workflow and send a test message to verify the AI responds.
Complete messaging workflow example
Trigger: Message Received (Sympana) → Filter: Channel = SMS → If/Else: Contact has tag "ai_msg_enabled" → Yes: Action: Send AI Message (Sympana — SMS Support Agent) → No: Do nothing (or notify team)
Next steps
All Actions & Triggers
See every Sympana action and trigger available in GHL.
Configure Functions
Set up the functions your messaging agent can use.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema/docs.json","name":"Sympana Connector","description":"Connect GoHighLevel with Retell, Vapi, AnyReach, Smallest.ai, SigmaMind, ElevenLabs, Grok, and Bland to run AI calling, messaging workflows, automation, and CRM sync.","colors":{"primary":"#0F172A","light":"#2563EB","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/sympanallc/8DM9moU7nkRw5vQ2/images/Sympanah.png?fit=max\u0026auto=format\u0026n=8DM9moU7nkRw5vQ2\u0026q=85\u0026s=48059204854e7a2a78d24ca6b7e8ae1d","dark":"https://mintcdn.com/sympanallc/8DM9moU7nkRw5vQ2/images/Sympanah2.png?fit=max\u0026auto=format\u0026n=8DM9moU7nkRw5vQ2\u0026q=85\u0026s=1d4533e1a07c7021d9334aa0d943a82b"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Install Sympana Connector","icon":"rocket","href":"https://marketplace.gohighlevel.com/integration/6822fb63c32178f1f1b0eacb/versions/6822fb63c32178f1f1b0eacb"},{"anchor":"Pricing","icon":"dollar-sign","href":"https://www.sympana.com/connector#pricing"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/QXk7ddhmZQ"},{"anchor":"Ask AI","icon":"sparkles","href":"/ask-ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sympanallc","hasAudioNarration":false,"actualSubdomain":"sympanallc","customDomains":["docs.sympana.com"],"gitSource":{"type":"github","owner":"emanueltermure","repo":"ghl_voice_app","deployBranch":"docs/sympana-documentation","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6a98becc331460d7046eb762","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"Vapi Setup","count":14},{"language":"default","tag":"Retell Setup","count":13},{"language":"default","tag":"Actions","count":12},{"language":"default","tag":"Connect","count":10},{"language":"default","tag":"Build","count":8},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Support","count":4},{"language":"default","tag":"Messaging","count":3},{"language":"default","tag":"Functions","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"guides/messaging-connection-setup","slug":"/guides/messaging-connection-setup","pageMetadata":{"title":"Messaging Connection Setup","description":"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.","href":"/guides/messaging-connection-setup"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Info,Step,Steps,Table,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`what-is-a-messaging-connection`,children:`What is a messaging connection?`}),`\n`,_jsxs(_components.p,{children:[`A messaging connection links a `,_jsx(_components.strong,{children:`messaging AI agent`}),` (Retell or Vapi) to your GHL location. When an inbound message arrives (SMS, WhatsApp, Instagram, etc.), a GHL workflow can route it to your messaging connection, and the AI reads the message, generates a response, and sends it back through GHL Conversations.`]}),`\n`,_jsx(Warning,{children:`Messaging connections are separate from voice connections. A voice connection handles phone calls. A messaging connection handles text-based conversations. Create one of each if your AI handles both.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-messaging-connection`,children:`Create a messaging connection`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open your provider page`,icon:`gauge`,children:_jsxs(_components.p,{children:[`In the Sympana dashboard, open the `,_jsx(_components.strong,{children:`Retell`}),` or `,_jsx(_components.strong,{children:`Vapi`}),` page.`]})}),_jsx(Step,{title:`Switch to Messaging Connections`,icon:`message`,children:_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Messaging`}),` tab at the top of the page (next to Voice).`]})}),_jsx(Step,{title:`Click Add Messaging Connection`,icon:`plus`,children:_jsx(_components.p,{children:`Click the button to create a new messaging connection.`})}),_jsx(Step,{title:`Enter a connection name`,icon:`text`,children:_jsx(_components.p,{children:`Give it a clear name like “SMS Support Agent” or “WhatsApp Sales Bot.”`})}),_jsx(Step,{title:`Select your messaging AI agent`,icon:`robot`,children:_jsx(_components.p,{children:`Choose the Retell or Vapi agent that will handle messages. This should be an agent configured for text conversations, not voice.`})}),_jsx(Step,{title:`Select a calendar (optional)`,icon:`calendar`,children:_jsx(_components.p,{children:`Only needed if the messaging agent uses appointment functions (Book Appointment, Get Slots, etc.). Skip this if the agent only handles general conversations.`})}),_jsx(Step,{title:`Configure Contact Access`,icon:`shield`,children:_jsxs(_components.p,{children:[`Set up who the AI is allowed to message. See `,_jsx(_components.a,{href:`#contact-access`,children:`Contact Access`}),` below.`]})}),_jsx(Step,{title:`Select functions`,icon:`wrench`,children:_jsx(_components.p,{children:`Choose which functions the messaging agent can use — same 11 functions as voice connections (Book Appointment, Get Contact, Update Contact Data, etc.).`})}),_jsx(Step,{title:`Configure dynamic variables`,icon:`code`,children:_jsx(_components.p,{children:`Add variables the agent needs in its prompt — contact name, email, custom fields, etc.`})}),_jsx(Step,{title:`Configure Human Handoff`,icon:`user`,children:_jsxs(_components.p,{children:[`Set up keywords and rules for when the AI should stop and hand off to a human. See `,_jsx(_components.a,{href:`#human-handoff`,children:`Human Handoff`}),` below.`]})}),_jsx(Step,{title:`Save the connection`,icon:`floppy-disk`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),` or `,_jsx(_components.strong,{children:`Create Connection`}),`. The connection is now available for use in GHL workflows.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`contact-access`,children:`Contact Access`}),`\n`,_jsxs(_components.p,{children:[`Contact Access controls `,_jsx(_components.strong,{children:`who`}),` the messaging AI is allowed to talk to. This prevents your AI from responding to contacts it shouldn’t.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Allowed Tags`})}),_jsx(_components.td,{children:`If set, only contacts with at least one of these tags receive AI replies. Everyone else is skipped.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Blocked Tags`})}),_jsx(_components.td,{children:`Contacts with any of these tags are skipped — AI will not respond.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Handoff Tags`})}),_jsx(_components.td,{children:`Contacts with these tags are treated as “handed off to a human” — AI stops replying.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Opt-out Keywords`})}),_jsxs(_components.td,{children:[`Words like `,_jsx(_components.code,{children:`stop`}),`, `,_jsx(_components.code,{children:`unsubscribe`}),`, `,_jsx(_components.code,{children:`wrong number`}),`. If a contact sends one of these, AI stops replying.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`recommended-setup-for-outbound-messaging`,children:`Recommended setup for outbound messaging`}),`\n`,_jsx(_components.p,{children:`If you are sending outbound messages to contacts and want AI to handle replies:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Add a tag like `,_jsx(_components.code,{children:`ai_msg_enabled`}),` to the contacts you want AI to respond to`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Message Received`}),` workflow, only call `,_jsx(_components.strong,{children:`Send AI Message`}),` if the contact has the `,_jsx(_components.code,{children:`ai_msg_enabled`}),` tag`]}),`\n`,_jsxs(_components.li,{children:[`If a contact opts out, apply `,_jsx(_components.code,{children:`ai_msg_blocked`}),` and remove `,_jsx(_components.code,{children:`ai_msg_enabled`})]}),`\n`,_jsxs(_components.li,{children:[`If a contact asks for a human, apply `,_jsx(_components.code,{children:`ai_msg_handoff`}),` to stop AI replies`]}),`\n`]}),`\n`,_jsx(Tip,{children:`Contact Access is your safety net. It ensures the AI only talks to people you’ve explicitly approved, preventing unwanted automated responses.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`human-handoff`,children:`Human Handoff`}),`\n`,_jsx(_components.p,{children:`Human handoff pauses AI responses when a contact asks for a real person or when a human team member manually replies.`}),`\n`,_jsx(Heading,{level:`3`,id:`how-it-works`,children:`How it works`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Contact triggers handoff`,icon:`hand`,children:_jsx(_components.p,{children:`The contact sends something like “I want to talk to a person” or “Can I speak to someone?”`})}),_jsx(Step,{title:`Sympana detects the keyword`,icon:`magnifying-glass`,children:_jsx(_components.p,{children:`Sympana checks the message against your configured handoff keywords.`})}),_jsx(Step,{title:`Conversation is paused`,icon:`pause`,children:_jsx(_components.p,{children:`The conversation is marked as handed off. The AI stops replying to this contact.`})}),_jsx(Step,{title:`Handoff Requested trigger fires`,icon:`bolt`,children:_jsxs(_components.p,{children:[`Sympana fires the `,_jsx(_components.strong,{children:`Handoff Requested`}),` trigger into GHL so your workflow can take action.`]})}),_jsx(Step,{title:`Human takes over`,icon:`user`,children:_jsx(_components.p,{children:`A team member replies manually inside GHL Conversations.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`recommended-handoff-workflow`,children:`Recommended handoff workflow`}),`\n`,_jsx(_components.p,{children:`Build this GHL workflow to handle handoffs:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Trigger: Handoff Requested (Sympana)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → Action: Add Tag \"ai_msg_handoff\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → Action: Assign contact to team member`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → Action: Send internal notification (SMS/email to your team)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → Optional: Create Task \"Follow up with {{contact_first_name}}\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`messaging-workflow`,children:`Messaging workflow`}),`\n`,_jsx(_components.p,{children:`After creating a messaging connection, build a GHL workflow to use it:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Create a new workflow`,icon:`plus`,children:_jsxs(_components.p,{children:[`In GHL, go to `,_jsx(_components.strong,{children:`Automation → Workflows`}),` and create a new workflow.`]})}),_jsx(Step,{title:`Add the Message Received trigger`,icon:`bolt`,children:_jsxs(_components.p,{children:[`Search for `,_jsx(_components.strong,{children:`Message Received`}),` under Sympana Connector.`]})}),_jsxs(Step,{title:`Add channel filters (optional)`,icon:`filter`,children:[_jsx(_components.p,{children:`Filter by channel if you only want to handle specific message types: SMS, WhatsApp, Instagram, Facebook, Webchat, TikTok, or Email.`}),_jsx(Info,{children:`If no channel filter is applied, the workflow responds to ALL inbound message channels. Channel filtering belongs in the GHL trigger, not in the messaging connection itself.`})]}),_jsx(Step,{title:`Add contact tag filters (optional)`,icon:`tag`,children:_jsxs(_components.p,{children:[`Add an If/Else condition to check for the `,_jsx(_components.code,{children:`ai_msg_enabled`}),` tag before sending to AI.`]})}),_jsx(Step,{title:`Add the Send AI Message action`,icon:`robot`,children:_jsxs(_components.p,{children:[`Search for `,_jsx(_components.strong,{children:`Send AI Message`}),` under Sympana Connector. Select your messaging connection.`]})}),_jsx(Step,{title:`Publish and test`,icon:`rocket`,children:_jsx(_components.p,{children:`Publish the workflow and send a test message to verify the AI responds.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`complete-messaging-workflow-example`,children:`Complete messaging workflow example`}),`\n`,_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Trigger: Message Received (Sympana)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → Filter: Channel = SMS`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → If/Else: Contact has tag \"ai_msg_enabled\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → Yes: Action: Send AI Message (Sympana — SMS Support Agent)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → No: Do nothing (or notify team)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`All Actions \u0026 Triggers`,icon:`bolt`,href:`https://docs.sympana.com/when-to-use-each-trigger-and-action`,children:_jsx(_components.p,{children:`See every Sympana action and trigger available in GHL.`})}),_jsx(Card,{title:`Configure Functions`,icon:`wrench`,href:`https://docs.sympana.com/functions-overview`,children:_jsx(_components.p,{children:`Set up the functions your messaging agent can use.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Messaging Connection Setup","description":"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.","href":"/guides/messaging-connection-setup"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What is a messaging connection?","slug":"what-is-a-messaging-connection","depth":2,"children":[]},{"title":"Create a messaging connection","slug":"create-a-messaging-connection","depth":2,"children":[]},{"title":"Contact Access","slug":"contact-access","depth":2,"children":[{"title":"Recommended setup for outbound messaging","slug":"recommended-setup-for-outbound-messaging","depth":3,"children":[]}]},{"title":"Human Handoff","slug":"human-handoff","depth":2,"children":[{"title":"How it works","slug":"how-it-works","depth":3,"children":[]},{"title":"Recommended handoff workflow","slug":"recommended-handoff-workflow","depth":3,"children":[]}]},{"title":"Messaging workflow","slug":"messaging-workflow","depth":2,"children":[{"title":"Complete messaging workflow example","slug":"complete-messaging-workflow-example","depth":3,"children":[]}]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sympanallc","siteName":"Sympana Connector","title":"Messaging Connection Setup - Sympana Connector","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-07T20:21:02.095Z","originalFileLocation":"guides/messaging-connection-setup.md"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sympana Connector\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sympanallc/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sympanallc/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sympanallc/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sympanallc/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Messaging Connection Setup - Sympana Connector\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sympana Connector\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sympana.com/guides/messaging-connection-setup\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sympanallc.mintlify.site/_mintlify/api/og/v2?division=Build\u0026amp;title=Messaging+Connection+Setup\u0026amp;description=Create+a+messaging+AI+connection+in+Sympana+Connector+to+let+your+Retell+or+Vapi+agent+respond+to+inbound+messages+in+GoHighLevel.\u0026amp;theme=dcaf4c0248a200eb1cee74eb\u0026amp;signature=046872b592852923c191531fd079e44622e0b6307fe991a17a71c2ea05df91a6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Messaging Connection Setup - Sympana Connector\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sympanallc.mintlify.site/_mintlify/api/og/v2?division=Build\u0026amp;title=Messaging+Connection+Setup\u0026amp;description=Create+a+messaging+AI+connection+in+Sympana+Connector+to+let+your+Retell+or+Vapi+agent+respond+to+inbound+messages+in+GoHighLevel.\u0026amp;theme=dcaf4c0248a200eb1cee74eb\u0026amp;signature=046872b592852923c191531fd079e44622e0b6307fe991a17a71c2ea05df91a6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/sympanallc/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sympana Connector\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F172A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sympana.com/guides/messaging-connection-setup\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/messaging-connection-setup.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sympana.com/#organization\",\"name\":\"Sympana Connector\",\"url\":\"https://docs.sympana.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sympanallc/8DM9moU7nkRw5vQ2/images/Sympanah.png?fit=max\u0026auto=format\u0026n=8DM9moU7nkRw5vQ2\u0026q=85\u0026s=48059204854e7a2a78d24ca6b7e8ae1d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sympana.com#website\",\"name\":\"Sympana Connector\",\"url\":\"https://docs.sympana.com\",\"publisher\":{\"@id\":\"https://docs.sympana.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sympana.com/guides/messaging-connection-setup#webpage\",\"url\":\"https://docs.sympana.com/guides/messaging-connection-setup\",\"name\":\"Messaging Connection Setup\",\"description\":\"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.\",\"dateModified\":\"2026-07-07T20:21:02.095Z\",\"isPartOf\":{\"@id\":\"https://docs.sympana.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sympana.com/guides/messaging-connection-setup#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sympana.com/guides/messaging-connection-setup#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Build\",\"item\":\"https://docs.sympana.com/automation-playbook\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Messaging Connection Setup\",\"item\":\"https://docs.sympana.com/guides/messaging-connection-setup\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sympana.com/guides/messaging-connection-setup#article\",\"headline\":\"Messaging Connection Setup\",\"name\":\"Messaging Connection Setup\",\"description\":\"Create a messaging AI connection in Sympana Connector to let your Retell or Vapi agent respond to inbound messages in GoHighLevel.\",\"url\":\"https://docs.sympana.com/guides/messaging-connection-setup\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sympana.com/guides/messaging-connection-setup#webpage\"},\"dateModified\":\"2026-07-07T20:21:02.095Z\",\"publisher\":{\"@id\":\"https://docs.sympana.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sympana.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sympana Connector\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sympana Connector\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/messaging-connection-setup.md","siteName":"Sympana Connector","nav":{"global":{"anchors":[{"anchor":"Install Sympana Connector","icon":"rocket","href":"https://marketplace.gohighlevel.com/integration/6822fb63c32178f1f1b0eacb/versions/6822fb63c32178f1f1b0eacb"},{"anchor":"Pricing","icon":"dollar-sign","href":"https://www.sympana.com/connector#pricing"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/QXk7ddhmZQ"},{"anchor":"Ask AI","icon":"sparkles","href":"/ask-ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":" ","sidebarTitle":"Introduction","mode":"wide","href":"/introduction"},{"title":"How Data Moves Through Sympana","href":"/guides/how-data-moves"},{"group":"Get Started","pages":[{"title":"What Sympana Connector Can Do","mode":"wide","href":"/what-sympana-connector-can-do"},{"title":"What Sympana Connector Cannot Do","mode":"wide","href":"/what-sympana-connector-cannot-do"},{"title":"Setup Checklist","href":"/guides/setup-checklist"},{"title":"Platform Setup","mode":"wide","href":"/platform-setup"},{"title":"Testing Before You Go Live","href":"/testing-before-going-live"}]},{"group":"Build","pages":[{"title":"Build and Automate","mode":"wide","href":"/automation-playbook"},{"title":"Recommended Workflow Architecture","mode":"wide","href":"/recommended-workflow-architecture"},{"title":"Sympana Connector Build Report — July 2026","mode":"wide","href":"/sympana-connector-build-report-2026-07-09"},{"title":"When To Use Each Trigger and Action","href":"/when-to-use-each-trigger-and-action"},{"title":"Common Automation Recipes","href":"/common-automation-recipes"},{"title":"Best Practices","href":"/best-practices"},{"title":"Functions Overview","description":"Understand what functions do, when to use them, and how they fit into Retell and Vapi setups.","mode":"wide","href":"/functions-overview"},{"title":"Messaging Connection Setup","href":"/guides/messaging-connection-setup"},{"title":"Workflow Recipes","description":"Copy-paste workflow configurations for the most common Sympana Connector use cases — voice calls, messaging, handoff, opt-out, and follow-up.","href":"/guides/workflow-recipes"}]},{"group":"Support","pages":[{"title":"Help and Support","mode":"wide","href":"/help-and-support"},{"title":"Troubleshooting","mode":"wide","href":"/troubleshooting"},{"title":"Implementation by Sympana","mode":"wide","href":"/implementation-by-sympana"},{"title":"FAQs","mode":"wide","href":"/faqs"}]}]},{"tab":"Retell Setup","groups":[{"group":"Connect","pages":[{"title":"How to Connect Sympana to Retell AI (Retell)","href":"/sympana-connector-retell/how-to-connect-sympana-to-retell-ai"},{"title":"Sympana App Function Tools (Retell)","href":"/sympana-connector-retell/sympana-app-function-tools-retell"},{"title":"Dynamic Variables (Retell)","href":"/sympana-connector-retell/dynamic-variables-retell"},{"title":"Webhook Get Call (Retell)","href":"/sympana-connector-retell/webhook-get-call"},{"title":"Example Scripts and Prompts (Retell)","href":"/sympana-connector-retell/example-scripts-prompts-retell"}]},{"group":"Actions","pages":[{"title":"Place Call (Retell)","href":"/automation-triggers-actions/place-call"},{"title":"Place Call Smart Selection (Retell)","href":"/automation-triggers-actions/place-call-smart-selection"},{"title":"Call Completed (Retell)","href":"/automation-triggers-actions/call-completed"},{"title":"Fetch Call Analysis (Retell)","href":"/automation-triggers-actions/fetch-call-analysis"},{"title":"Update Lead Timezone (Retell)","href":"/automation-triggers-actions/update-lead-timezone"},{"title":"Wait Until Calling Window (Retell)","href":"/automation-triggers-actions/wait-until-calling-window"}]},{"group":"Functions","pages":[{"title":"How to Set Up Functions in Retell","href":"/guides/how-to-set-up-functions-in-retell"}]},{"group":"Messaging","pages":[{"title":"Messaging Setup (Retell)","description":"Set up a Retell messaging connection in Sympana Connector to let your AI agent respond to inbound SMS, WhatsApp, Instagram, and other messages.","href":"/sympana-connector-retell/messaging-setup-retell"},{"title":"Messaging Connection Setup","href":"/guides/messaging-connection-setup"}]}]},{"tab":"Vapi Setup","groups":[{"group":"Connect","pages":[{"title":"How to Connect Sympana to Vapi (Vapi)","description":"How to connect Sympana Connector to Vapi and create your first connection.","href":"/sympana-connector-vapi/how-to-connect-sympana-to-vapi"},{"title":"Sympana App Function Tools (Vapi)","href":"/sympana-connector-vapi/sympana-app-function-tools-vapi"},{"title":"Dynamic Variables (Vapi)","href":"/sympana-connector-vapi/dynamic-variables-vapi"},{"title":"Webhook (Get Call)","href":"/sympana-connector-vapi/webhook-get-call"},{"title":"Example Scripts and Prompts (Vapi)","href":"/sympana-connector-vapi/example-scripts-prompts-vapi"}]},{"group":"Actions","pages":[{"title":"Place Call (Vapi)","href":"/automation-triggers-actions-vapi/place-call-vapi"},{"title":"Place Call Smart Selection (Vapi)","href":"/automation-triggers-actions-vapi/place-call-smart-selection-vapi"},{"title":"Call Completed (Vapi)","href":"/automation-triggers-actions-vapi/call-completed-vapi"},{"title":"Fetch Call Analysis (Vapi)","href":"/automation-triggers-actions-vapi/fetch-call-analysis-vapi"},{"title":"Update Lead Timezone (Vapi)","href":"/automation-triggers-actions-vapi/update-lead-timezone-vapi"},{"title":"Wait Until Calling Window (Vapi)","href":"/automation-triggers-actions-vapi/wait-until-calling-window-vapi"}]},{"group":"Functions","pages":[{"title":"How to Set Up Functions in Vapi","href":"/guides/how-to-set-up-functions-in-vapi"}]},{"group":"Messaging","pages":[{"title":"Messaging Setup (Vapi)","description":"Set up a Vapi messaging connection in Sympana Connector to let your AI assistant respond to inbound SMS, WhatsApp, Instagram, and other messages.","href":"/sympana-connector-vapi/messaging-setup-vapi"},{"title":"Messaging Connection Setup","href":"/guides/messaging-connection-setup"}]}]},{"tab":"Video Tutorials","pages":[{"title":"Video Tutorials","href":"/video-tutorials"}]}]},"basePath":"","title":"Messaging Connection Setup - Sympana Connector","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}