Actions113
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
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
- ChatWoot API Documentation – Official API docs for reference on inbox and agent bot management.
- n8n Documentation – General guidance on using API nodes and managing credentials.