[Integration Request] Chatwoot

Chatwoot – Integration Request

---

Description

Chatwoot is a popular open-source customer support platform (20k+ GitHub stars) that provides live chat, email, social media, and API-based messaging channels — all in one dashboard. It's widely used by teams self-hosting their support stack, which makes it a natural fit for Automatisch's audience.

Adding a Chatwoot integration would allow users to automate customer support workflows without depending on proprietary platforms.

Suggested Triggers

Trigger	Description
New Conversation	Fires when a new conversation is created
New Message	Fires when a new message is received in a conversation
Conversation Status Changed	Fires when a conversation is resolved, reopened, or set to pending
New Contact	Fires when a new contact is created
Contact Updated	Fires when contact attributes are updated
Assignee Changed	Fires when a conversation is assigned or reassigned

Chatwoot supports webhooks natively, which simplifies trigger implementation.

Suggested Actions

Action	Description
Create Contact	Create a new contact in Chatwoot
Send Message	Send a message to an existing conversation
Update Conversation Status	Resolve, reopen, or set a conversation to pending
Assign Conversation	Assign a conversation to an agent or team
Add Label	Add a label to a conversation
Search Contacts	Look up contacts by email, phone, or identifier

Authentication

Chatwoot uses a simple API Access Token (per-user or platform-level), passed via the api_access_token header or query parameter. This is straightforward to implement — similar to how existing API-key-based integrations work in Automatisch.

API Reference

• REST API docs: https://www.chatwoot.com/developers/api/
• Webhooks docs: https://www.chatwoot.com/docs/product/features/webhooks
• GitHub repo: https://github.com/chatwoot/chatwoot

Use Case Examples

• Lead capture → CRM sync: New Chatwoot contact → create lead in HubSpot/Pipedrive
• Escalation alerts: Conversation unresolved for X minutes → send Slack/Discord notification
• Ticket creation: New Chatwoot conversation → create issue in GitHub/GitLab/Linear
• Auto-tagging: New message containing keywords → add label to conversation
• Contact enrichment: New contact created → look up in Clearbit/Clay → update Chatwoot contact attributes