ChatWoot

Overview

This n8n node allows you to toggle the priority of a conversation in ChatWoot. It is useful for customer support teams who need to programmatically update the urgency of conversations based on workflow automation, such as escalating high-priority tickets or de-escalating resolved issues.

Practical examples:

• Automatically set incoming VIP customer conversations to "Urgent".
• Lower the priority of conversations that have been inactive for a certain period.
• Integrate with other systems to adjust priorities based on external triggers.

Properties

Output

The node outputs a json object containing the response from the ChatWoot API after updating the conversation's priority. The structure typically includes details about the updated conversation, such as its ID, current priority, and possibly other metadata returned by the API.

Note: The exact fields depend on the ChatWoot API response for this operation.

Dependencies

• External Service: Requires access to a ChatWoot instance.
• API Key: Needs valid ChatWoot API credentials configured in n8n under the name chatwootApi.
• Environment Variable: The base URL for ChatWoot must be provided via credentials (url field).

Troubleshooting

Common Issues:

• Invalid Credentials: If the API key or URL is incorrect, authentication errors will occur. Ensure your credentials are correct and have sufficient permissions.
• Missing Required Fields: If Account Id, Conversation Id, or Priority are not provided, the node will fail. Double-check all required properties.
• Invalid Priority Value: Only the specified options (Urgent, High, Medium, Low, None) are accepted. Using any other value will result in an error.

Error Messages:

• 401 Unauthorized: Check your API credentials and URL.
• 404 Not Found: Verify that the Account Id and Conversation Id exist in your ChatWoot instance.
• 400 Bad Request: Ensure all required fields are filled and the priority value is valid.

Links and References

• ChatWoot API Documentation
• n8n Documentation
• ChatWoot Website