Chat agents

A chat agent handles text conversations. The same bot can answer in the on-site widget, over SMS and WhatsApp, and from your own backend — each is a channel on the same agent.

Greeting & behavior

Set a chat greeting — the opener shown when a new conversation starts. Beyond that, the agent's behavior comes from its system prompt, its knowledge, and its tools. Starting a brand-new conversation returns the greeting instantly without a model call.

Where it runs

• Web — the embeddable widget on your site, and the built-in test chat in the dashboard.
• SMS & WhatsApp — text messaging channels.
• API — your backend, via the Chat API (channel=api), passing your own external_user_id.

Every message lands in a conversation tagged with its channel, so you can review and filter by where it happened.

Driving it from code

To integrate a chat agent into your product, call POST /api/v1/chat/send (or the streaming /chat/send-stream) with the bot id and the user's message. Persist the returned conversation_id to keep a thread going. See the Chat API for the full contract.

Test it

Use the dashboard's test chat to talk to the agent as a user would, watch tool calls run, and inspect the trace before you put it in front of customers.