ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Overview

This node integrates with the ChatWoot API to add labels to a specific conversation within an account. It is useful for categorizing or tagging conversations automatically based on certain criteria, which helps in organizing and filtering conversations in customer support workflows.

For example, you might use this node to tag conversations as "urgent" or "billing issue" after analyzing the conversation content or metadata in previous workflow steps.

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 labels will be added.
Labels A JSON array of label strings to add to the conversation (e.g., ["urgent", "sales"]).

Output

The node outputs the response from the ChatWoot API after adding the labels. This output is typically a JSON object containing details about the updated conversation or confirmation of the label addition.

No binary data output is involved.

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 uses HTTP requests to interact with the ChatWoot REST API.

Troubleshooting

  • Invalid Account or Conversation ID: If the provided IDs do not exist or are incorrect, the API will return an error. Verify that the IDs correspond to valid entities in your ChatWoot account.
  • Authentication Errors: Ensure the API key credential is correctly set up and has sufficient permissions.
  • Malformed Labels JSON: The labels property expects a valid JSON array of strings. Invalid JSON or wrong format may cause request failures.
  • API Rate Limits: Frequent calls may hit rate limits imposed by ChatWoot; handle such errors by implementing retries or backoff.

Links and References

Discussion