Actions36
- 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 an existing conversation in Chatwoot, a customer engagement platform. It supports sending various types of messages such as plain text, interactive options, forms, cards, and articles. The node is useful for automating communication workflows, sending notifications, or responding to customers programmatically.
Typical use cases include:
- Sending a simple text reply to a customer conversation.
- Delivering interactive content like selectable options or forms to gather user input.
- Sharing rich media cards or helpful articles within a conversation.
- Using WhatsApp templates with parameters for standardized messaging.
Properties
| Name | Meaning |
|---|---|
| Conversation ID | The numeric ID of the conversation where the message will be created. |
| Send | How to send the data: either using structured fields (predefined form inputs) or providing custom JSON for full control over the request payload. |
| Message Type | The type of message to send. Options are: Text Message, Interactive Options (input_select), Interactive Form, Interactive Cards, Interactive Articles. |
| Content | The main content of the message (used for text messages). |
| Additional Options | Extra settings for the message, including: - Private Message: whether this is an internal note. - WhatsApp Template Parameters: category, language, template name, and processed parameters for WhatsApp templates. |
| Custom JSON | A JSON object representing the entire message payload. When used, it overrides all other structured fields. |
| Message Content | For interactive options, the text displayed with the options. |
| Options | For interactive options, a list of selectable options each with a title and value. |
| Form Content | For interactive forms, the message text displayed with the form. |
| Form Fields | For interactive forms, the fields to display, including field name, type (text, email, textarea, select), label, placeholder, default value, and select options if applicable. |
| Cards Content | For interactive cards, the message text displayed with the cards. |
| Cards | For interactive cards, a collection of cards each with title, description, media URL, and actions (link or postback buttons). |
| Articles Content | For interactive articles, the message text displayed with the articles. |
| Articles | For interactive articles, a collection of articles each with title, description, and link URL. |
| Continue on Fail | Whether to continue processing subsequent items if this operation fails. |
| Debug Logging | Whether to output detailed debug information about the HTTP requests to the console. |
Output
The node outputs the response from the Chatwoot API as JSON under the json property. This typically includes details of the created message such as its ID, content, timestamps, and metadata.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Chatwoot API.
- Needs the base URL and account ID configured in the credentials.
- Uses HTTP requests to communicate with the Chatwoot REST API endpoints.
Troubleshooting
- Invalid JSON errors: When using the "Custom JSON" option or entering JSON in template parameters, ensure the JSON syntax is correct. Errors will indicate invalid JSON with details.
- Missing required fields: The conversation ID and message content (or appropriate fields depending on message type) must be provided; otherwise, the API will reject the request.
- API authentication failures: Verify that the API key credential is valid and has access to the specified account.
- Debug logging: Enable debug logging to see detailed request URLs, headers, and bodies which can help diagnose issues.
- Continue on Fail: If enabled, the node will continue processing even if one item fails, returning error details in the output JSON.