Actions113
- 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
- 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
- Webhooks Actions
- Teams Actions
- Custom Filters Actions
- Reports Actions
Overview
This node allows you to delete an existing Agent Bot in the ChatWoot platform by specifying its unique identifier. It is useful for managing and maintaining your chatbot agents, especially when you need to remove outdated or unnecessary bots from your system.
Practical examples include:
- Cleaning up old or test agent bots that are no longer needed.
- Automating the removal of agent bots as part of a workflow triggered by certain events (e.g., project completion).
- Managing bot lifecycle programmatically without manual intervention in the ChatWoot dashboard.
Properties
| Name | Meaning |
|---|---|
| Id | The unique numeric identifier of the agent bot to be deleted. This is a required field. |
Output
The node outputs JSON data representing the response from the ChatWoot API after attempting to delete the specified agent bot. Typically, this will confirm whether the deletion was successful or provide error details if it failed.
No binary data output is expected from this operation.
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: Ensure the "Id" property is provided and corresponds to an existing agent bot. An incorrect ID will result in an error indicating the bot was not found.
- Authentication errors: Verify that the API key or token used has sufficient permissions to delete agent bots.
- Network issues: Check connectivity to the ChatWoot server and ensure the base URL is correct.
- API rate limits: If many deletions are performed rapidly, you might hit rate limits imposed by ChatWoot.
Common error messages may include:
- "Agent bot not found": The specified Id does not exist.
- "Unauthorized": Authentication credentials are invalid or missing.
- "Request failed": General network or server error; check logs and retry.
Links and References
- ChatWoot API Documentation - For detailed API endpoints and usage.
- ChatWoot Official Website - To learn more about the platform and features.