Actions113
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
Overview
This node allows you to create a new conversation in the ChatWoot platform. It is useful for automating customer support workflows by programmatically initiating conversations linked to specific accounts, inboxes, and contacts. For example, you can use this node to start a conversation when a user submits a form on your website or when an event triggers a support ticket creation.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account under which the conversation will be created. |
| Source Id | The source identifier of the conversation (e.g., a unique external reference). |
| Inbox Id | The ID of the inbox where the conversation is created. Allowed types include Website, Phone, API, Email. |
| Contact Id | The contact's ID for whom the conversation is created. |
| Additional Attributes | JSON object specifying extra attributes like browser information. |
| Custom Attributes | JSON object for saving custom key-value pairs related to the conversation (e.g., priority number). |
| Status | The status of the conversation; options are Open, Resolved, or Pending. |
| Assignee Id | The agent ID to whom the conversation is assigned. |
| Team Id | The team ID to which the conversation is assigned. |
| Message | JSON object representing the initial message sent to the conversation, including template parameters. |
Output
The node outputs the response from the ChatWoot API after creating the conversation. This typically includes details about the newly created conversation such as its ID, status, timestamps, and associated metadata. The output is structured as JSON data. There is no binary data output.
Dependencies
- Requires an API key credential for authenticating with the ChatWoot API.
- The base URL for the ChatWoot instance must be configured in the credentials.
- The node uses standard HTTP headers for JSON content type and expects JSON responses.
Troubleshooting
- Missing Required Fields: Ensure that required fields like Account Id, Source Id, and Inbox Id are provided; otherwise, the API call will fail.
- Invalid JSON in Attributes or Message: The
additional_attributes,custom_attributes, andmessagefields expect valid JSON strings. Invalid JSON will cause parsing errors. - Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Inbox Type Restrictions: The Inbox Id must correspond to allowed inbox types (Website, Phone, API, Email); using unsupported types may result in errors.
- Status Value Errors: Only "open", "resolved", or "pending" are accepted for the status field.
Links and References
- ChatWoot API Documentation (for detailed API usage and schema)
- n8n Documentation (for general guidance on using n8n nodes and credentials)