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," "billing," or "technical 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.

If the API supports binary data (e.g., attachments), it would be handled accordingly, but based on the provided code and properties, the output focuses on JSON responses related to conversation labeling.

Dependencies

• Requires an active connection to the ChatWoot API.
• Needs an API authentication token configured in the node credentials.
• The base URL for the ChatWoot instance must be set in the credentials.
• The node uses the @devlikeapro/n8n-openapi-node package to build request properties from the OpenAPI specification.

Troubleshooting

• Invalid Account or Conversation ID: Ensure that the numeric IDs provided correspond to existing entities in your ChatWoot instance.
• Labels Format Error: The labels property expects a JSON array of strings. Invalid JSON or incorrect formatting may cause errors.
• Authentication Errors: Verify that the API key or token is correctly configured and has sufficient permissions.
• Network Issues: Check connectivity to the ChatWoot server and ensure the base URL is correct.
• API Rate Limits: If many requests are made in a short time, the API might throttle requests; handle such errors by retrying after some delay.

Links and References

• ChatWoot Official Documentation
• ChatWoot API Reference