ChatWoot icon

ChatWoot

Interact with ChatWoot API
Join our community

Actions113

Overview

This node integrates with the Messages API of ChatWoot to create and send messages within a specified conversation. It is useful for automating message sending in customer support workflows, chatbots, or any system that needs to programmatically interact with conversations managed by ChatWoot.

Typical use cases include:

  • Automatically sending follow-up messages to customers.
  • Integrating external systems to push notifications or updates into chat conversations.
  • Creating messages based on triggers or events from other parts of an automation workflow.

Properties

Name Meaning
Inbox Identifier The unique identifier of the inbox channel where the message will be sent.
Contact Identifier The source ID of the contact who is the sender or recipient of the message.
Conversation Id The numeric ID of the conversation to which the message belongs.
Content The textual content of the message to be created and sent.
Echo Id A temporary identifier used for tracking the message via websockets (optional).

Output

The node outputs JSON data representing 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.

If binary data were involved (e.g., attachments), it would be included accordingly, but this operation focuses on text message creation only.

Dependencies

  • Requires an active ChatWoot account and API access.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for the ChatWoot instance must be set in the credentials.
  • Uses the ChatWoot REST API endpoint for messages.

Troubleshooting

  • Missing or invalid identifiers: Ensure that the Inbox Identifier, Contact Identifier, and Conversation Id are correct and correspond to existing entities in ChatWoot.
  • Authentication errors: Verify that the API key/token is valid and has sufficient permissions.
  • Network issues: Confirm that the ChatWoot instance URL is reachable from the n8n environment.
  • Empty content: Sending a message without content may result in an error; always provide meaningful text.
  • Echo Id usage: If using Echo Id for websocket tracking, ensure it is unique per message to avoid confusion.

Common error messages might include unauthorized access, resource not found, or validation errors related to missing required fields.

Links and References

Discussion