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 is useful for maintaining or improving automated agents that interact with customers, ensuring their information and behavior remain current.

Practical examples:

  • Changing the display name of a bot after a rebranding.
  • Updating the webhook URL if the bot’s backend service endpoint changes.
  • Adding or modifying the description to better reflect the bot’s purpose.

Properties

Name Meaning
Id The unique numeric identifier of the agent bot to update (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 operation completes successfully. This typically includes the bot’s ID, updated fields (name, description, outgoing URL), and possibly metadata returned from the ChatWoot API confirming the update.

No binary data output is involved.

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.

Troubleshooting

  • Invalid or missing Id: If the provided bot ID does not exist or is omitted, the API will return an error indicating the bot cannot be found. Ensure the correct numeric ID is supplied.
  • Authentication errors: Failure to provide valid API credentials will result in authorization errors. Verify the API key/token and base URL are correctly configured.
  • Invalid webhook URL: Providing a malformed URL for the outgoing webhook may cause the update to fail or the bot to malfunction. Use a valid URL format.
  • Empty required fields: Although only the ID is strictly required, ensure other fields are properly formatted if provided to avoid partial or failed updates.

Links and References

Discussion