Chatwoot icon

Chatwoot

Interact with Chatwoot API

Overview

This node interacts with the Chatwoot API to manage conversations within a specified account. The Get Conversation operation retrieves detailed information about a single conversation by its numeric ID and associated account ID.

Typical use cases include:

  • Fetching the current state and details of a specific customer support conversation.
  • Integrating conversation data into workflows for reporting, analytics, or triggering other automation steps.
  • Retrieving conversation metadata such as status, assignee, labels, messages summary, and custom attributes.

For example, a support team could use this node to pull conversation details when a new ticket is created in their helpdesk system, enabling automated routing or escalation based on conversation content or status.

Properties

Name Meaning
Account ID The numeric ID of the Chatwoot account under which the conversation exists.
Conversation ID The numeric ID of the specific conversation to retrieve details for.
Continue on Fail Whether to continue executing subsequent workflow steps if this operation fails (boolean).

Output

The output is a JSON object representing the full details of the requested conversation as returned by the Chatwoot API. This typically includes fields such as:

  • Conversation identifiers (ID, source ID)
  • Status (open, pending, resolved, snoozed)
  • Assignee information (agent or team assigned)
  • Labels attached to the conversation
  • Custom attributes set on the conversation
  • Metadata like timestamps, inbox info, contact info
  • Summary of messages or last message preview

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Chatwoot API.
  • The base URL of the Chatwoot instance must be configured in the credentials.
  • Network access to the Chatwoot API endpoint.

Troubleshooting

  • Error: "Not Found" or 404 — Verify that the provided Account ID and Conversation ID are correct and exist in the Chatwoot instance.
  • Authentication errors — Ensure the API key credential is valid and has sufficient permissions.
  • Network errors/timeouts — Check connectivity to the Chatwoot server and that the base URL is correctly configured.
  • If Continue on Fail is false, any error will stop execution; setting it to true allows the workflow to proceed despite failures.

Links and References

Discussion