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 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, logging incoming messages, or posting templated content programmatically.
Common scenarios include:
- Automatically replying to customer inquiries with predefined messages.
- Adding private notes to conversations for internal use.
- Sending rich content like cards, forms, or articles within conversations.
- Using template parameters to send localized or customized WhatsApp messages.
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. |
| 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 containing additional attributes specific to the chosen content type. |
| Template Params | JSON object defining parameters for message templates, useful especially for WhatsApp channel messages. |
Output
The node outputs JSON data representing the created message object returned by the ChatWoot API. This typically includes details such as message ID, content, timestamps, sender information, and status.
If binary data were involved (e.g., attachments), it would be included accordingly, but this operation focuses on message creation with JSON content.
Dependencies
- Requires an active ChatWoot account and valid API credentials (an API key/token).
- The node uses the ChatWoot REST API endpoint configured via credentials.
- Proper permissions to post messages in the specified account and conversation are necessary.
Troubleshooting
- Invalid Account or Conversation ID: Ensure that the provided numeric IDs correspond to existing entities in your ChatWoot instance.
- Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Malformed JSON in Content Attributes or Template Params: Make sure JSON inputs are well-formed; parsing errors can cause failures.
- Unsupported Content Type: Use only the supported content types listed; unsupported types may result in API errors.
- Private Flag Misuse: Setting the private flag incorrectly might hide messages from intended recipients.