Build

Chat Agents

This guide explains how to create and configure a chat agent in Synthflow. Chat agents enable you to deliver conversational AI experiences through text-based interfaces, such as web chat widgets, support portals, or custom applications.

Chat agents can be launched via API, embeddable widget, WhatsApp, or SMS. WhatsApp and SMS channels require your own Twilio account and are currently available for US-region workspaces only. See Launch Chat Agents for setup instructions and region availability details.

Creating a Chat Agent (UI)

  1. Go to the Agents section in the Synthflow platform.
  2. Click Create Agent.
  3. Select Chat as the agent type.
  4. Enter a name and description for your chat agent.
  5. Configure settings, including:
    • Language model (e.g., GPT-4.1, GPT-5.1)
    • Conversation flow (single prompt or flow designer)
  6. Save your chat agent.

Creating a Chat Agent (API)

To create a chat agent via API, send a POST request to the Synthflow API endpoint. Example:

$curl -X POST \
>  https://api.synthflow.ai/v2/assistants \
>  -H 'Content-Type: application/json' \
>  -H 'Authorization: Bearer YOUR_API_KEY' \
>  -d '{
>    "name": "My Chat Agent",
>    "description": "A chat agent for customer support",
>    "type": "chat",
>    "settings": {
>      "language_model": "gpt-5.1",
>      "conversation_flow": "customer_support_flow",
>      "parameters": {
>        "max_tokens": 100,
>        "temperature": 0.7
>      }
>    }
>  }'

Next Steps

Frequently Asked Questions (FAQ)

What is pricing for chat?

Every 5 messages sent by Synthflow counts as 1 billable minute, charged at your plan’s per-minute rate. This is a platform-level fee. If you use SMS or WhatsApp through Twilio, standard Twilio messaging fees apply on top.

Yes! You can use either a single prompt or a flow designer configuration for your chat agent.

Yes. Connect your own Twilio account, configure a WhatsApp sender or SMS-capable number, and deploy the agent. See Launch Chat Agents for step-by-step instructions.

Chat will be shortly integrated into the analytics platform.