ChatWootInstall

Overview

This node interacts with the ChatWoot API to list metadata about conversations filtered by various criteria. It is useful for retrieving summarized information about conversations in a ChatWoot account, such as counts or statuses, without fetching full conversation details.

Common scenarios include:

• Monitoring the number of open or resolved conversations in a support inbox.
• Filtering conversations by team or label to analyze workload distribution.
• Searching conversations containing specific keywords to identify trends or issues.

For example, a user might configure this node to get the count of all open conversations assigned to a particular team or inbox, helping customer support managers prioritize resources.

Properties

Output

The node outputs JSON data representing the metadata of conversations matching the specified filters. This typically includes summary information such as counts or aggregated data about the conversations.

No binary data output is indicated.

Dependencies

• Requires an API key credential for authenticating with the ChatWoot API.
• Needs the base URL of the ChatWoot instance configured in credentials.
• Depends on the ChatWoot REST API being accessible and properly configured.

Troubleshooting

• Invalid Account Id: Ensure the provided account ID exists and is correct; otherwise, the API may return errors or empty results.
• Incorrect Status Value: Use one of the allowed status options (open, resolved, pending, snoozed) to avoid invalid query errors.
• API Authentication Errors: Verify that the API key credential is valid and has sufficient permissions.
• Empty Results: If no conversations are returned, check if the filters (inbox, team, labels, search term) are too restrictive or incorrect.
• Malformed Labels JSON: Ensure the labels property contains valid JSON array syntax.

Links and References

• ChatWoot API Documentation
• ChatWoot Conversations API Reference