ChatWoot

Overview

This node interacts with the ChatWoot API to list all labels associated with a specific conversation within an account. It is useful for scenarios where you want to retrieve and manage metadata tags (labels) applied to conversations, such as categorizing customer support tickets or filtering conversations by topic.

For example, a customer support team might use this node to fetch all labels on a conversation to understand its context before responding or to automate workflows based on label presence.

Properties

Output

The node outputs JSON data representing the list of labels attached to the specified conversation. Each label typically includes properties such as label name, color, and ID. This structured output allows further processing or conditional logic in your workflow.

If the API supports binary data related to labels (e.g., icons), it would be included accordingly, but based on the provided code and operation, the output focuses on JSON label data.

Dependencies

• Requires an API key credential for authenticating with the ChatWoot API.
• The base URL for the ChatWoot instance must be configured in the node credentials.
• The node depends on the @devlikeapro/n8n-openapi-node package for OpenAPI integration.

Troubleshooting

• Missing or invalid Account Id or Conversation Id: Ensure these numeric IDs are correct and correspond to existing entities in ChatWoot.
• Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
• Network or API errors: Check connectivity to the ChatWoot instance and confirm the base URL is correctly set.
• Empty label list: This may indicate no labels are assigned to the conversation; verify via the ChatWoot dashboard.

Links and References

• ChatWoot API Documentation
• n8n OpenAPI Node Integration