This is an n8n community node that lets you use Chatwoot in your n8n workflows.
Chatwoot is an open-source customer engagement platform that helps businesses manage customer conversations across multiple channels. This node provides comprehensive integration with the Chatwoot API, allowing you to automate customer support workflows, manage contacts, handle conversations, and more.
Tip
For enhanced features and optimal performance, we recommend using fazer.ai's Chatwoot, which includes additional capabilities like Kanban boards, WhatsApp integration with Baileys/Z-API providers, and more webhook events.
n8n is a fair-code licensed workflow automation platform.
Installation
Nodes
Operations
Credentials
Compatibility
Usage
Resources
Development
Follow the installation guide in the n8n community nodes documentation.
Use this package name to install:
@fazer-ai/n8n-nodes-chatwoot
This package includes two nodes:
The main node for interacting with the Chatwoot API. Supports all CRUD operations for managing your Chatwoot instance.
A webhook trigger node that listens for Chatwoot events. Automatically registers and manages webhooks in your Chatwoot instance.
| Operation | Description |
|---|---|
| Get | Retrieve detailed information about a specific Chatwoot account |
| Operation | Description |
|---|---|
| Create | Create a new contact with name, phone (E.164 format), email, and custom attributes |
| Get | Get contact information |
| Update | Update contact details |
| Delete | Delete a contact |
| List | List contacts with pagination |
| Search | Search for contacts by query |
| Set Custom Attributes | Set custom attributes on a contact |
| Destroy Custom Attributes | Remove all custom attributes from a contact |
| Operation | Description |
|---|---|
| Create | Create a new conversation for a contact |
| Get | Get a specific conversation |
| List | List conversations with filters |
| Send Message | Send a text message in a conversation |
| Send File | Send a file/attachment in a conversation |
| List Messages | List messages in a conversation with pagination |
| List Attachments | List attachments in a conversation |
| Assign Agent | Assign an agent to a conversation |
| Assign Team | Assign a team to a conversation |
| Add Labels | Append labels to a conversation (keeps existing) |
| Remove Labels | Remove specific labels from a conversation |
| Update Labels | Replace all labels on a conversation |
| Toggle Status | Change status (open, pending, resolved, snoozed) |
| Set Priority | Set conversation priority |
| Add Custom Attributes | Add custom attributes (keeps existing) |
| Remove Custom Attributes | Remove specific custom attributes |
| Set Custom Attributes | Replace all custom attributes |
| Update Last Seen | Update the last seen timestamp |
| Update Presence | Set presence status (off, typing, recording) |
| Mark Unread | Mark conversation as unread |
| Update Attachment Metadata | Update metadata on attachments (e.g., transcription) |
| Operation | Description |
|---|---|
| Create | Create a custom attribute definition (text, number, date, list, checkbox, link) |
| List | List all custom attribute definitions |
| Delete | Delete a custom attribute definition |
| Operation | Description |
|---|---|
| Get | Get information about a specific inbox |
| List | List all inboxes in an account |
| On WhatsApp ⚡ | Check if a phone number is registered on WhatsApp |
| WhatsApp Disconnect ⚡ | Disconnect a WhatsApp inbox |
| WhatsApp Get QR Code ⚡ | Get QR code for WhatsApp inbox connection |
⚡ These operations are only available with fazer.ai's Chatwoot
| Operation | Description |
|---|---|
| Create | Create a new Kanban board |
| Get | Get a specific Kanban board |
| List | List Kanban boards |
| Update | Update a Kanban board |
| Delete | Delete a Kanban board |
| Update Agents | Update agents assigned to a board |
| Update Inboxes | Update inboxes linked to a board |
| Operation | Description |
|---|---|
| Create | Create a new step (column) in a board |
| List | List steps from a board |
| Update | Update a step |
| Delete | Delete a step |
| Operation | Description |
|---|---|
| Create | Create a new task |
| Get | Get a specific task |
| List | List tasks from a board |
| Update | Update a task |
| Move | Move a task to another step |
| Delete | Delete a task |
| Operation | Description |
|---|---|
| Create | Create a new label |
| List | List all labels |
| Update | Update a label |
| Delete | Delete a label |
| Operation | Description |
|---|---|
| Get | Get the current user profile information |
| Operation | Description |
|---|---|
| Create | Create a new scheduled message in a conversation |
| Get Many | List all scheduled messages for a conversation |
| Update | Update an existing scheduled message |
| Delete | Delete a scheduled message |
| Operation | Description |
|---|---|
| Create | Create a new team |
| Delete | Delete a team |
| List | List all teams |
| Get Team Members | Get all members of a team |
| Assign Agent | Assign an agent to a team |
| Unassign Agent | Remove an agent from a team |
The Chatwoot fazer.ai Trigger node supports the following webhook events:
| Event | Description |
|---|---|
| Contact Created | Triggered when a new contact is created |
| Contact Updated | Triggered when a contact is updated |
| Conversation Created | Triggered when a new conversation is created |
| Conversation Status Changed | Triggered when conversation status changes |
| Conversation Updated | Triggered when a conversation is updated |
| Conversation Typing On | Triggered when someone starts typing |
| Conversation Typing Off | Triggered when someone stops typing |
| Message Created | Triggered when a message is created |
| Message Updated | Triggered when a message is updated |
| Message Incoming ⚡ | Triggered for incoming messages only |
| Message Outgoing ⚡ | Triggered for outgoing messages only |
| Kanban Task Created ⚡ | Triggered when a Kanban task is created |
| Kanban Task Updated ⚡ | Triggered when a Kanban task is updated |
| Kanban Task Deleted ⚡ | Triggered when a Kanban task is deleted |
| Provider Event Received ⚡ | Triggered when a provider event is received |
| Live Chat Widget Opened | Triggered when a user opens the live chat widget |
⚡ These events are only available with fazer.ai's Chatwoot
To authenticate with Chatwoot, you need:
The base URL of your Chatwoot instance (e.g., https://app.chatwoot.com or your self-hosted URL).
A Personal Access Token from your Chatwoot profile:
- Log in to your Chatwoot dashboard
- Go to Profile Settings (click your avatar → Profile settings)
- Navigate all the way down to Access Token
- Copy your token
The token is sent as the Api-Access-Token header with each request.
- Minimum n8n version: 1.0.0
- Tested with: n8n 1.x and 2.x
- Chatwoot version: Compatible with Chatwoot v4.x and later
- fazer.ai Chatwoot: Required for Kanban, WhatsApp provider operations, and additional webhook events
- Add a Chatwoot fazer.ai Trigger node
- Select your account and choose "Conversation Created" event
- Connect to a Chatwoot fazer.ai node
- Set resource to "Conversation" and operation to "Send Message"
- Use the conversation ID from the trigger output
The Contact resource supports E.164 phone number format validation (e.g., +5511999999999). You can also set social profiles and custom attributes when creating or updating contacts.
All resources support two selection modes:
- From List: Browse and search available items (accounts, inboxes, conversations, etc.)
- By ID: Enter the ID directly for dynamic workflows
Custom attributes can be specified in three ways:
- Definition mode: Select from existing attribute definitions
- Key-pair mode: Enter key-value pairs manually
- JSON mode: Provide a JSON object for complex structures
This node is enabled as an n8n AI tool (usableAsTool: true), allowing it to be used with AI agents for intelligent automation workflows.
- n8n Community Nodes Documentation
- Chatwoot API Documentation
- fazer.ai Chatwoot Repository
- fazer.ai Website
- Node.js v22 or higher
- pnpm package manager
# Clone the repository
git clone https://github.com/fazer-ai/n8n-nodes-chatwoot.git
cd n8n-nodes-chatwoot
# Install dependencies
pnpm install| Command | Description |
|---|---|
pnpm build |
Compile TypeScript sources to dist/ |
pnpm lint |
Run ESLint |
pnpm lint:fix |
Run ESLint with auto-fix |
pnpm dev |
Start development mode |
pnpm start |
Start Docker development environment |
pnpm start:log |
Start Docker development with logs |
├── credentials/ # Credential definitions
├── nodes/Chatwoot/ # Node implementations
│ ├── actions/ # Resource operations
│ ├── methods/ # List search & load options
│ └── shared/ # Shared utilities
├── icons/ # Node icons
└── dist/ # Build output (published)
Cayo Oliveira - fazer.ai
Gabriel Jablonski - fazer.ai
Made with ❤️ by fazer.ai