Messaging
AI agents that use Chatwoot
UtilitySpaces gives an AI agent scoped access to Chatwoot through its own encrypted connection, not your password. The agent can call 4 named Chatwoot tools, and the one that writes waits for a person's approval unless an admin has set the connection to run without asking. Every call is written to a hash-chained audit log with its arguments and its result.
What an agent can do in Chatwoot
Support inbox conversations across WhatsApp, email, and Instagram. An agent calls these by name, and matching is exact.
| Tool | What it does | Waits for approval by default |
|---|---|---|
| List conversations | List conversations in the inbox. | No — read only |
| Get conversation | Get a conversation with its messages. | No — read only |
| Send message | Send a reply into a conversation. | Yes — it writes |
| Search contacts | Search contacts by name/email/phone. | No — read only |
3 read tools, 1 write tool. Generated from the connector catalogue the product runs on, so it cannot list a tool that does not exist.
What teams hand an agent in Chatwoot
Support teams hand an agent the first pass on the shared inbox: reading a conversation across WhatsApp, email, or Instagram, pulling the contact with Search contacts, and writing the reply. Reading is free-running; Send message is the write. A Chatwoot connection made before write policies existed was kept on Run without asking, so its replies reach the customer without a person reviewing them first; a new connection starts on Ask a person first, and an admin can switch either one.
- Triage the open inbox every hour by listing conversations and summarising which ones have waited longest without a reply.
- Pull a customer's history when a new conversation arrives by searching contacts and reading their earlier threads for context.
- Reply to routine questions such as opening hours or order status when the answer is already in the thread (unattended only if the connection runs without asking)
What waits for a person
Reads run on their own. These do not — each one waits in Approvals for an owner or admin unless an admin has set this connection to run writes without asking, and every call toChatwoot, approved, rejected or unattended, is logged.
- Send message POST
What connecting Chatwoot takes
Chatwoot uses an API key you create in Chatwoot and paste in once. A workspace admin sets the connection up; the fields are:
- Chatwoot URL
- Account ID
- API Access Token
Credentials are encrypted and bound to your workspace, never read back, and every outbound call passes one guarded fetch — the connector security posture sets out exactly how, and the security page covers the platform around it.
Where Chatwoot fits
Give an agent Chatwoot work by writing a message in the inbox, or put its tools in a scheduled flow. What the run cost is on the cost breakdown.
Other messaging integrations: Discord, Gmail, Microsoft Outlook. Or see every application agents can connect to.
See it doing your actual work
Open a demo workspace, connect one app, and give an agent a real job. No card, no sales call.
We reply to every message within one business day.