ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Account Agent Bots → List All Account Agent Bots

AI-generated

Overview

This node interacts with the ChatWoot API to list all agent bots associated with a specific account. It is useful for scenarios where you need to retrieve and manage automated agents (bots) configured within a ChatWoot account, such as displaying them in a dashboard, auditing bot configurations, or integrating bot data into other workflows.

For example, a customer support team might use this node to fetch all active agent bots for their account to monitor bot performance or update bot settings programmatically.

Properties

Name Meaning
Account Id The numeric ID of the ChatWoot account for which to list all agent bots

Output

The node outputs JSON data containing a list of agent bots associated with the specified account. Each item in the output typically includes details about an individual agent bot, such as its ID, name, status, and configuration parameters.

If the node supports binary data output, it would generally relate to attachments or media handled by the bots, but based on the provided code and operation, the output is primarily JSON structured data representing agent bots.

Dependencies

  • Requires an API key credential for authenticating with the ChatWoot API.
  • The base URL for the ChatWoot instance must be configured in the node credentials.
  • Depends on the @devlikeapro/n8n-openapi-node package for OpenAPI integration.
  • Uses an OpenAPI specification (openapi.json) bundled with the node to define available operations and properties.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Providing an incorrect or non-existent Account Id may result in empty results or errors from the API.
    • Network connectivity problems can prevent the node from reaching the ChatWoot API endpoint.
  • Error messages:

    • Authentication errors typically indicate invalid API keys or misconfigured credentials; verify and update the API key.
    • "Account not found" or similar errors suggest the Account Id does not exist or the authenticated user lacks access rights.
    • Timeout or connection errors require checking network settings and ChatWoot server availability.

Links and References

Discussion