ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Overview

This node updates an existing Agent Bot in the ChatWoot system. It allows users to modify properties such as the bot's name, description, and webhook URL by specifying the bot's unique identifier. This operation is useful for maintaining or improving automated chat agents without recreating them from scratch. For example, you might update the outgoing webhook URL if your bot’s backend service endpoint changes, or revise the bot’s description to reflect new capabilities.

Properties

Name Meaning
Id The unique numeric identifier of the agent bot to be updated (required).
Name The new name to assign to the agent bot.
Description A textual description providing details about the agent bot.
Outgoing Url The webhook URL where the bot sends outgoing messages or events.

Output

The node outputs JSON data representing the updated state of the agent bot after the update operation completes successfully. This typically includes the bot’s ID, name, description, outgoing URL, and possibly other metadata returned by the ChatWoot API. There is no indication that binary data is output by this node.

Dependencies

  • Requires an active connection to the ChatWoot API.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The base URL for the ChatWoot instance must be set in the credentials.
  • The node uses standard HTTP headers for JSON content negotiation.

Troubleshooting

  • Invalid or missing Id: If the provided bot ID does not exist or is omitted, the API will likely return a "not found" or validation error. Ensure the ID is correct and provided.
  • Authentication errors: Missing or invalid API credentials will cause authorization failures. Verify that the API key/token is correctly configured.
  • Invalid URL format: Providing an improperly formatted webhook URL may cause the update to fail. Confirm the URL is valid.
  • Empty update fields: If none of the optional fields (name, description, outgoing URL) are provided, the update request may have no effect or be rejected. Provide at least one field to update.
  • API connectivity issues: Network problems or incorrect base URL settings can prevent communication with ChatWoot.

Links and References

Discussion