Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sympana.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

A messaging connection lets your Retell AI agent handle text-based conversations — inbound SMS, WhatsApp, Instagram DMs, Facebook messages, webchat, and more. The AI reads each message, generates a response, and sends it back through GHL Conversations.
Messaging connections are separate from voice connections. If your agent handles both calls and messages, create one voice connection and one messaging connection.

​
Create a Retell messaging connection

Open the Retell page

In the Sympana dashboard, click Retell.

Switch to Messaging

Click the Messaging tab at the top (next to Voice).

Click Add Messaging Connection

Click the button to create a new messaging connection.

Name your connection

Give it a clear name like “SMS Support Agent” or “Instagram Sales Bot.”

Select your Retell messaging agent

Choose the Retell agent that will handle messages. This should be an agent configured for text conversations.

Link a GHL calendar (optional)

Only needed if the messaging agent uses appointment functions (Book Appointment, Get Slots, etc.).

Configure Contact Access

Control who the AI is allowed to message:
SettingWhat it does
Allowed TagsOnly contacts with these tags get AI replies
Blocked TagsContacts with these tags are skipped
Handoff TagsContacts with these tags are treated as handed-off to a human
Opt-out KeywordsWords like “stop”, “unsubscribe” — AI stops replying

Select functions

Enable the functions your messaging agent needs — same 11 functions as voice (Book Appointment, Get Contact, Update Contact Data, etc.).

Configure dynamic variables

Add variables the agent needs — contact name, email, custom fields, etc.

Configure Human Handoff

Set up handoff keywords. When a contact says “talk to a person” or “human”, the AI stops and fires the Handoff Requested trigger in GHL.

Save

Click Save. The connection is now available for GHL workflows.

​
Build a messaging workflow

After creating the connection, build a GHL workflow to use it: 
Trigger: Message Received (Sympana)
  → Optional: Filter by channel (SMS, WhatsApp, Instagram, etc.)
  → Optional: If/Else — Contact has tag "ai_msg_enabled"
  → Action: Send AI Message (Sympana) — select your Retell messaging connection
Channel filtering belongs in the GHL trigger, not in the messaging connection. The connection is channel-agnostic — GHL decides which messages to route to AI.

​
Build a handoff workflow

Trigger: Handoff Requested (Sympana)
  → Action: Add Tag "ai_msg_handoff"
  → Action: Assign contact to team member
  → Action: Send internal notification to your team
  → Optional: Create Task "Follow up with {{contact_first_name}}"
TagWhen to apply
ai_msg_enabledWhen you outbound a contact or opt them in for AI messaging
ai_msg_blockedWhen the contact opts out (says “stop”, “unsubscribe”)
ai_msg_handoffWhen handoff is triggered — AI pauses

​
Test your messaging connection

  1. Make sure the messaging connection is active in Sympana
  2. Publish the Message Received workflow in GHL
  3. Send a test inbound message (SMS or other channel) to your GHL number
  4. Verify the AI responds in GHL Conversations
  5. Test handoff by sending a handoff keyword (e.g., “I want to talk to a person”)
  6. Verify the Handoff Requested workflow fires
If the AI doesn’t respond, check: Is the workflow published? Does the contact have the required tags? Is the connection active? Is the Retell API key valid?

​
Next steps

Messaging Connection Setup

Full guide with Contact Access and Human Handoff details.

Workflow Recipes

Copy-paste messaging workflow configurations.