ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Overview

This node allows you to create a new Agent Bot in the ChatWoot platform. An Agent Bot is an automated entity that can interact with customers, typically used to handle common queries, route conversations, or provide instant responses without human intervention.

Common scenarios where this node is beneficial include:

  • Automating customer support by setting up bots that respond to FAQs.
  • Creating webhook-driven bots that trigger external workflows or services.
  • Managing multiple bots programmatically as part of a larger automation pipeline.

For example, you could use this node to create a bot named "SupportBot" with a description explaining its role and specify a webhook URL that receives events when the bot interacts with users.

Properties

Name Meaning
Name The name of the agent bot to be created.
Description A textual description providing details about the agent bot's purpose or behavior.
Outgoing Url The webhook URL that the bot will call for outgoing messages or events (bot's callback).

Output

The node outputs JSON data representing the newly created Agent Bot object as returned by the ChatWoot API. This typically includes fields such as the bot's unique identifier, name, description, webhook URL, status, and other metadata related to the bot configuration.

No binary data output is involved.

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 or missing API credentials: Ensure your API key/token is correctly configured and has sufficient permissions to create agent bots.
  • Webhook URL issues: The provided outgoing URL must be reachable and accept incoming requests; otherwise, the bot may not function properly.
  • API errors: If the API returns validation errors (e.g., missing required fields like name), verify all mandatory properties are set.
  • Network connectivity: Confirm that n8n can reach the ChatWoot server endpoint specified in the credentials.

Links and References

Discussion