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
Messages → Create A New Message In A Conversation
AI-generatedOverview
This node allows you to create a new message within an existing conversation in a ChatWoot account. It is useful for automating communication workflows, such as sending outgoing messages or notes to customers, or logging incoming messages programmatically. Typical use cases include customer support automation, chatbot integrations, and CRM updates where messages need to be created dynamically based on external triggers or data.
For example, you could use this node to send a follow-up message to a customer after a support ticket is updated, or to log internal private notes related to a conversation.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the ChatWoot account where the conversation exists. |
| Conversation Id | The numeric ID of the conversation to which the message will be added. |
| Content | The textual content of the message to be sent or logged. |
| Message Type | Specifies if the message is "Outgoing" (sent by agent) or "Incoming" (received from customer). |
| Private | Boolean flag indicating if the message is a private note (true) or visible to the customer (false). |
| Content Type | The type of message content; options include: Input Email, Cards, Input Select, Form, Article. |
| Content Attributes | JSON object with additional attributes specific to the chosen content type. |
| Template Params | JSON object containing template parameters used when sending templated messages (e.g., WhatsApp). |
Output
The node outputs the response from the ChatWoot API after creating the message. This typically includes details about the newly created message such as its ID, timestamps, content, and status. The output is structured as JSON under the json field.
If binary data were involved (not indicated here), it would represent attachments or media associated with the message, but this node focuses on textual and structured message content only.
Dependencies
- Requires an active ChatWoot account.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- Depends on the ChatWoot REST API endpoint URL provided in the credentials.
- Uses the
@devlikeapro/n8n-openapi-nodepackage internally for OpenAPI-based request building.
Troubleshooting
- Invalid Account or Conversation ID: Ensure that the numeric IDs provided correspond to existing entities in your ChatWoot instance.
- Authentication Errors: Verify that the API key/token credential is correctly set up and has sufficient permissions.
- Malformed JSON in Content Attributes or Template Params: Make sure JSON inputs are valid and properly formatted to avoid parsing errors.
- Message Type or Content Type Mismatch: Use supported values exactly as specified; unsupported types may cause API rejections.
- Private Flag Misuse: Setting the private flag incorrectly might result in messages not being visible to intended recipients.
Common error messages usually come from the ChatWoot API and relate to invalid parameters, unauthorized access, or resource not found. Checking the API response body can help identify the exact issue.