ChatWoot

Overview

This node operation allows users to create a custom filter within the ChatWoot platform. Custom filters help segment or organize data such as conversations, contacts, or reports based on specific criteria defined by the user. This is particularly useful for automating workflows, reporting, or managing large datasets by applying reusable query filters.

For example, a support team might create a custom filter to isolate all conversations tagged as "urgent" or a sales team could filter contacts based on region or engagement level.

Properties

Output

The node outputs JSON data representing the newly created custom filter as returned by the ChatWoot API. This typically includes details such as the filter's ID, name, type, query parameters, and associated account information.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the ChatWoot API.
• Needs an API authentication token configured in n8n credentials to authorize requests.
• The base URL for the ChatWoot instance must be set in the credentials.

Troubleshooting

• Invalid Account Id: Ensure the provided account ID exists and the API key has access rights to it.
• Malformed Query JSON: The Query property must be valid JSON; otherwise, the API will reject the request.
• Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
• Filter Type/Type Mismatch: Both Filter Type and Type properties should match one of the allowed options (conversation, contact, report). Mismatches may cause errors.
• API Connectivity Issues: Check network connectivity and the correctness of the ChatWoot base URL.

Links and References

• ChatWoot API Documentation
• n8n Documentation - Creating Custom Nodes