ChatWoot

Overview

This n8n node interacts with the ChatWoot Conversations API to list all conversations associated with a specific contact within a given inbox. It is useful for automating workflows that need to retrieve and process conversation histories for customer support, CRM integrations, or analytics purposes.

Practical examples:

• Fetching all past interactions of a customer when a new ticket is created.
• Syncing conversation data from ChatWoot to another system (e.g., a CRM).
• Triggering follow-up actions based on the number or content of conversations.

Properties

Output

The node outputs a JSON array where each item represents a conversation associated with the specified contact in the given inbox. The structure of each conversation object typically includes fields such as:

{
  "id": "string",
  "inbox_id": "string",
  "contact_id": "string",
  "status": "string",
  "messages": [ /* ... */ ],
  // ...other conversation details
}

Note: The exact fields depend on the ChatWoot API's response schema.

Dependencies

• External Service: Requires access to a ChatWoot instance with API enabled.
• API Credentials: You must configure chatwootApi credentials in n8n, including the base URL and authentication token.
• n8n Configuration: Ensure the node has network access to your ChatWoot server.

Troubleshooting

• Missing or Invalid Credentials:
  Error message: "401 Unauthorized" or "Invalid credentials."
  Resolution: Check that your chatwootApi credentials are correctly set up in n8n.

• Incorrect Identifiers:
  Error message: "404 Not Found" or "Resource not found."
  Resolution: Verify that both the Inbox Identifier and Contact Identifier are correct and exist in your ChatWoot instance.

• Network Issues:
  Error message: "ECONNREFUSED" or "Request failed."
  Resolution: Ensure n8n can reach your ChatWoot server (check firewalls, VPNs, etc.).

Links and References

• ChatWoot API Documentation
• n8n Documentation: Creating Custom Nodes
• ChatWoot GitHub Repository