How to integrate Chatwoot
The AI agent can also communicate with customers via an external CRM system that already has messaging channels set up (e.g., WhatsApp or Telegram), allowing all messages to be managed in a single operator interface. Integration with Chatwoot enables the AI agent to connect to an external communications platform managed through Chatwoot, a simple CRM and helpdesk system.
What is Chatwoot?
Chatwoot is a CRM and communication platform that allows operators to chat with customers across various channels (WhatsApp, Telegram, Email, etc.) in one interface.
Flametree integrates with Chatwoot in two modes:
- Chatbot — the AI agent automatically replies to user messages
- Copilot — the AI agent suggests draft replies, and the operator decides whether to send or edit them
Step 1: Prepare Parameters in Chatwoot
You will need the following:
| Parameter | Where to Find It |
|---|---|
| Chatwoot URL | Server URL where Chatwoot is deployed (e.g., https://chat.example.com) |
| API Token | Chatwoot admin token |
| Account ID | Account (tenant) ID in Chatwoot |
| Inbox ID | Channel (inbox) ID, e.g., WhatsApp or Telegram |
| Integration Type | chatbot or copilot — defines the agent’s operating mode |
A single Chatwoot account may contain multiple inboxes. If you want to connect both WhatsApp and Telegram, create two separate integrations.
Step 2: Add the Integration in the Platform
- Go to the Integrations section
- Find the Chatwoot integration type
- Click Add +
- Fill in the following fields:
| Field | Description |
|---|---|
| Name, Description | Custom name and description for the integration |
| Chatwoot URL | Chatwoot server URL |
| API Key | Admin access token |
| Account ID | Chatwoot account ID |
| Inbox ID | ID of the channel used for communication |
| Integration Type | chatbot — agent replies directly; copilot — agent suggests drafts |
Operating Modes
| Mode | Agent Behavior |
|---|---|
| chatbot | The agent replies directly to the customer |
| copilot | The agent prepares a draft response; the operator can edit and send it |