Actions13
- Chatwoot Integration Actions
- Instance Actions
- Message Actions
- Parser Actions
- Webhook Actions
Overview
The node integrates with the MegaAPI WhatsApp service and Chatwoot platform to manage WhatsApp conversations and messages. Specifically, the Chatwoot Integration - Create Conversation operation allows users to create a new conversation in Chatwoot linked to a WhatsApp inbox. This is useful for automating customer support workflows where incoming WhatsApp contacts need to be organized into conversations within Chatwoot for further interaction and tracking.
Practical scenarios include:
- Automatically creating a new conversation in Chatwoot when a new WhatsApp contact initiates communication.
- Integrating WhatsApp messaging data from MegaAPI into Chatwoot’s CRM system.
- Streamlining multi-channel customer support by syncing WhatsApp conversations into Chatwoot.
Properties
| Name | Meaning |
|---|---|
| Chatwoot Account ID | Your Chatwoot account identifier used to associate the conversation with your account. |
| Chatwoot Inbox ID | The specific Chatwoot inbox ID designated for WhatsApp messages where the conversation will be created. |
| Contact ID | The Chatwoot contact ID representing the WhatsApp user/contact for whom the conversation is created. |
Output
The node outputs JSON data representing the result of the conversation creation request in Chatwoot. This typically includes details such as the newly created conversation's ID, status, timestamps, and any metadata returned by Chatwoot’s API confirming successful creation.
No binary data output is involved in this operation.
Dependencies
- Requires access to the MegaAPI WhatsApp service for message and webhook processing.
- Requires valid Chatwoot account credentials (an API key or token) configured in n8n to authenticate requests.
- Needs the Chatwoot account ID, inbox ID, and contact ID to correctly route and create conversations.
- The node expects to receive input data that includes these identifiers and possibly webhook payloads from MegaAPI.
Troubleshooting
Common Issues:
- Missing or incorrect Chatwoot Account ID, Inbox ID, or Contact ID will cause failures in creating conversations.
- Network or authentication errors when connecting to Chatwoot API.
- Input data not properly formatted or missing required fields.
Error Messages:
Unknown chatwoot operation: createConversation— indicates the operation name was misspelled or not supported.- API errors from Chatwoot such as unauthorized access or invalid parameters.
Resolutions:
- Verify all required IDs are correctly set and correspond to existing entities in Chatwoot.
- Ensure API credentials are valid and have sufficient permissions.
- Confirm that the input data structure matches expected format, especially if using webhook payloads.