Chatwoot Bridge (n8n)

​

Features

• Bidirectional messaging — send messages to Chatwoot and receive agent responses via webhooks
• Contact management — automatically create or update Chatwoot contacts from WhatsApp interactions
• Conversation handling — create and manage conversations with proper threading
• AI agent compatible — works with n8n AI agents for automated responses
• Real-time webhooks — instant triggers for agent messages and status updates

​

Prerequisites

• n8n instance (version 0.195.0 or later)
• Active Chatwoot instance with API access
• WSAPI account with connected WhatsApp number
• Configured API channel in Chatwoot

​

Installation

@wsapichat/n8n-nodes-wsapi-chatwoot

cd /path/to/your/n8n
npm install @wsapichat/n8n-nodes-wsapi-chatwoot
npm run start

​

Credentials setup

​

Available nodes

​

Chatwoot Insert Message (Action Node)

​

Chatwoot Callback Trigger (Webhook Node)

​

Integration patterns

​

WhatsApp → Chatwoot (customer messages)

WSAPI Trigger (WhatsApp Message)
├── Transform: Format message data
├── Chatwoot Upsert Message:
│   ├── Account ID: 1
│   ├── Inbox ID: 5
│   ├── Identifier: {{ $json.from }}
│   ├── Contact Name: {{ $json.pushName }}
│   └── Message: {{ $json.body }}
└── Log: Record interaction

​

Chatwoot → WhatsApp (agent responses)

Chatwoot Callback Trigger (Agent Message)
├── Condition: Check if outgoing message
├── Transform: Extract contact identifier
├── WSAPI Send Text Message:
│   ├── To: {{ $json.contact.identifier }}@s.whatsapp.net
│   └── Message: {{ $json.message.content }}
└── Update: Mark as delivered

​

AI-powered customer service

WSAPI Trigger (WhatsApp Message)
├── Chatwoot Upsert Message: Create/update conversation
├── AI Agent:
│   ├── Context: Customer service knowledge base
│   ├── Tools: Chatwoot Upsert Message, WSAPI Send Message
│   └── Action: Provide support response
└── Log: Save AI interaction

​

Best practices

• Use webhook authentication tokens for all production deployments
• Implement error handling for failed API calls
• Set up proper agent routing rules in Chatwoot
• Test webhooks with ngrok for local development
• Monitor API rate limits (Chatwoot: 100 requests/minute per token)

​

GitHub