ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Agent Bots → Update An Agent Bot

AI-generated

Overview

This node operation 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 include:

  • Changing the display name of a bot to reflect a new campaign.
  • Updating the description to provide more context about the bot’s purpose.
  • Modifying the outgoing webhook URL to point to a new endpoint handling bot interactions.

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. This typically includes the bot's ID, name, description, outgoing URL, and possibly other metadata returned by the ChatWoot API confirming the successful update.

No binary data output is involved in this operation.

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 configuration.

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 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 and reachable.
  • Empty required fields: Although only the ID is strictly required, sending empty strings for other fields might overwrite existing values unintentionally. Double-check input values before updating.

Links and References

Discussion