ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Overview

This node integrates with the ChatWoot API to update the agent bot assigned to a specific inbox within an account. It is useful for automating the management of inbox configurations, particularly when you need to change which agent bot handles conversations in a given inbox. For example, if your support team uses different bots for various product lines or languages, this node can programmatically switch the bot associated with an inbox without manual intervention.

Properties

Name Meaning
Account Id The numeric ID of the ChatWoot account that owns the inbox.
Id The numeric ID of the inbox whose agent bot you want to update.
Agent Bot The numeric ID of the agent bot to assign to the specified inbox.

Output

The node outputs JSON data representing the updated inbox resource after the agent bot has been changed. This typically includes details such as the inbox ID, the newly assigned agent bot ID, and other inbox metadata returned by the ChatWoot API. There is no indication that binary data is output by this node.

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.
  • Uses the ChatWoot REST API endpoint to update inbox settings.

Troubleshooting

  • Invalid Account or Inbox ID: If the provided account or inbox ID does not exist or is incorrect, the API will return an error. Verify these IDs in your ChatWoot dashboard.
  • Agent Bot Not Found: Providing an invalid agent bot ID will cause the update to fail. Ensure the agent bot ID exists and is active.
  • Authentication Errors: Missing or incorrect API credentials will result in authentication failures. Confirm that the API key and base URL are correctly set in the node credentials.
  • API Rate Limits: Frequent updates may hit rate limits imposed by ChatWoot. Implement retry logic or reduce request frequency if errors occur.
  • Network Issues: Connectivity problems between n8n and the ChatWoot server can cause timeouts or failed requests.

Links and References

Discussion