ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Overview

This node interacts with the Conversations API to list all conversations associated with a specific contact within a given inbox. It is useful for retrieving conversation history or monitoring ongoing interactions between contacts and support agents or chatbots. Practical applications include customer support dashboards, analytics on user engagement, or integration with CRM systems to fetch communication threads.

Properties

Name Meaning
Inbox Identifier The unique identifier of the inbox channel from which to retrieve conversations.
Contact Identifier The source ID of the contact whose conversations you want to list.

Output

The node outputs a JSON array containing conversation objects related to the specified contact in the given inbox. Each object typically includes details such as conversation IDs, timestamps, message summaries, statuses, and other metadata relevant to each conversation thread.

If the API supports binary data (e.g., attachments), the node would handle it accordingly, but based on the provided code and properties, the primary output is structured JSON data representing conversations.

Dependencies

  • Requires an API key credential for authenticating with the ChatWoot API.
  • The base URL for the API must be configured in the node credentials.
  • Depends on the external ChatWoot Conversations API endpoint to fetch conversation data.

Troubleshooting

  • Missing or invalid Inbox Identifier or Contact Identifier: Ensure both identifiers are correctly obtained from prior API calls or system records.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Network or API errors: Check connectivity and API availability; review error messages returned by the API for rate limits or server issues.
  • Empty results: Confirm that the contact has existing conversations in the specified inbox.

Links and References

Discussion