ChatWootInstall

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

Output

The node outputs JSON data representing the response from the ChatWoot API after adding the labels to the conversation. This typically includes confirmation of the updated conversation details, including the newly added labels.

No binary data output is produced by this node.

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 JSON array of strings. Invalid JSON or incorrect formatting may cause request failures. Use proper JSON syntax when specifying labels.
• API Rate Limits: Frequent calls may hit rate limits imposed by ChatWoot. Implement retry logic or reduce call frequency if needed.

Links and References

• ChatWoot API Documentation
• n8n Documentation on Creating Custom Nodes