Actions35
- Account Actions
- Canned Response Actions
- Contact Actions
- Conversation Actions
- Inbox Actions
- Label Actions
- Message Actions
- Team Actions
- Webhook Actions
Overview
This node allows you to create a new message within a specific conversation in a Chatwoot account. It supports sending various types of messages including plain text, articles, cards, forms, and input select options. This flexibility makes it useful for automating customer support interactions, sending rich interactive content, or integrating Chatwoot messaging into broader workflows.
Common scenarios:
- Sending automated replies or notifications to customers.
- Creating interactive messages with buttons, forms, or selectable options.
- Posting informational cards or articles as part of a conversation.
- Integrating Chatwoot messaging with CRM or ticketing systems.
Example:
You can use this node to send a welcome message with selectable options to guide users through common queries, or send product cards with links and actions directly inside a conversation.
Properties
| Name | Meaning |
|---|---|
| Account ID | The numeric ID of the Chatwoot account where the message will be created. |
| Conversation ID | The numeric ID of the conversation in which to post the message. |
| Content | The main content of the message (e.g., text or description). |
| Message Type | The type of message: either "Incoming" (from customer) or "Outgoing" (from agent/system). Default is "Outgoing". |
| Content Type | The format/type of the message content. Options include: text, article, cards, form, and input_select (selectable options). Default is text. |
| Options Items | (For input_select content type) A collection of selectable options, each with a title and value that users can choose from. |
| Form Items | (For form content type) A collection of form fields, each with properties like label, name, placeholder, default value, and type (email, text, text_area, select). Select fields can have their own options. |
| Card Items | (For cards content type) A collection of cards, each containing media URL, title, description, and actions. Actions can be links or postbacks with associated URIs or payloads. |
| Article Items | (For article content type) A collection of articles, each with a title, description, and link URL. |
| Continue on Fail | Whether to continue executing subsequent items if this operation fails (boolean). |
Output
The output contains the JSON response from the Chatwoot API representing the created message object. This includes all details of the message as stored in Chatwoot, such as IDs, timestamps, content, message type, and any interactive content attributes.
The node does not output binary data.
Dependencies
- Requires an active Chatwoot account and API access.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The base URL of the Chatwoot instance must be set in the credentials.
- Uses HTTP POST requests to the Chatwoot API endpoint
/api/v1/accounts/{accountId}/conversations/{conversationId}/messages.
Troubleshooting
- Invalid Account or Conversation ID: Ensure the provided numeric IDs exist and belong to your Chatwoot instance.
- Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Content Validation Errors: When using complex content types (cards, forms, input_select), ensure all required fields are properly filled and formatted.
- API Rate Limits: If many messages are sent rapidly, you might hit rate limits imposed by Chatwoot.
- Continue on Fail: Enable this option if you want the workflow to proceed even if one message creation fails; otherwise, errors will stop execution.
Common error messages usually come from the Chatwoot API and relate to invalid parameters or authorization issues. Check the error message returned in the node output for guidance.
Links and References
If you need further details about other operations or resources, feel free to ask!