ChatWoot

Interact with ChatWoot API

Actions113

Accounts Actions
- Create An Account
- Get Details Of An Account
- Delete An Account
- Update An Account
Account Users Actions
- List All Account Users
- Create An Account User
- Delete An Account User
Agent Bots Actions
- Create An Agent Bot
- Get Details Of A Single Agent Bot
- Delete An Agent Bot
- Update An Agent Bot
Users Actions
- Create A User
- Get Details Of A User
- Delete A User
- Update A User
- Get Sso Url Of A User
Inbox API Actions
- Get Details Of A Inbox
Contacts API Actions
- Create A Contact
- Get Details Of A Contact
- Update A Contact
Conversations API Actions
- List All Contact Conversations
- Create A Conversation
Messages API Actions
- List All Converation Messages
- Create A Message
- Update A Message
CSAT Survey Page Actions
- Get Csat Survey Page
Account Agent Bots Actions
- List All Account Agent Bots
- Create An Account Agent Bot
- Get Details Of A Single Account Agent Bot
- Delete An Account Agent Bot
- Update An Account Agent Bot
Agents Actions
- Get Account Agents
- Add New Agent To Account
- Delete Agent From Account
- Update Agent In Account
Canned Responses Actions
- Get Account Canned Response
- Add New Canned Response To Account
- Delete Canned Response From Account
Canned Response Actions
- Update Canned Response In Account
Custom Attributes Actions
- Get Account Custom Attribute
- Add New Custom Attribute To Account
- Get Details Of A Single Custom Attribute
- Delete Custom Attribute From Account
- Update Custom Attribute In Account
Contacts Actions
- Contact List
- Contact Create
- Contact Details
- Contact Update
- Contact Delete
- Contact Conversations
- Contact Search
- Contact Filter
Contact Actions
- Contact Inbox Creation
- Contactable Inboxes Get
Automation Rule Actions
- Get Account Automation Rule
- Add New Automation Rule To Account
- Get Details Of A Single Automation Rule
- Delete Automation Rule From Account
- Update Automation Rule In Account
Help Center Actions
- Get Portal
- Add New Portal To Account
- Update New Portal To Account
- Add New Category To Account
- Add New Article To Account
Conversations Actions
- Conversation List Meta
- Conversation List
- New Conversation
- Conversation Filter
- Get Details Of A Conversation
- Toggle Status Of A Conversation
- Toggle Priority Of A Conversation
Conversation Assignment Actions
- Assign A Conversation
Conversation Labels Actions
- List All Labels Of A Conversation
- Conversation Add Labels
Inboxes Actions
- List All Inboxes
- Get Inbox
- Inbox Creation
- Update Inbox
- Get Inbox Agent Bot
- Update Agent Bot
- Get Inbox Members
- Add New Agent To Inbox
- Delete Agent In Inbox
- Update Agents In Inbox
Messages Actions
- List All Messages
- Create A New Message In A Conversation
- Delete A Message
Integrations Actions
- Get Details Of All Integrations
- Create An Integration Hook
- Delete An Integration Hook
- Update An Integrations Hook
Webhooks Actions
- Delete A Webhook
- List All Webhooks
- Create A Webhook
- Update A Webhook
Teams Actions
- List All Teams
- Create A Team
- Get Details Of A Single Team
- Delete A Team
- Update A Team
- Get Team Members
- Add New Agent To Team
- Delete Agent In Team
- Update Agents In Team
Custom Filters Actions
- List All Filters
- Create A Custom Filter
- Get Details Of A Single Custom Filter
- Delete A Custom Filter
- Update A Custom Filter
Reports Actions
- List All Conversation Statistics
- List All Conversation Statistics Summary
- Get Account Conversation Metrics
- Get Agent Conversation Metrics

Overview

This node operation allows you to remove one or more agents (users) from a specific inbox within an account on the ChatWoot platform. It is useful when you want to revoke access or remove agents who should no longer handle conversations in that inbox.

Common scenarios include:

Managing team members dynamically by removing agents who have left a project or changed roles.
Cleaning up inbox assignments to ensure only relevant agents have access.
Automating user management workflows in customer support setups.

For example, if you have an inbox dedicated to a product support channel and an agent leaves the team, you can use this operation to delete their access from that inbox programmatically.

Properties

Name	Meaning
Account Id	The numeric ID of the ChatWoot account where the inbox exists.
Inbox Id	The unique identifier of the inbox from which agents will be removed.
User Ids	A JSON array containing the IDs of users (agents) to be deleted from the specified inbox.

Output

The output of this node operation typically contains a JSON object reflecting the result of the deletion request. This may include confirmation of successful removal or details about any errors encountered.

No binary data is output by this operation.

Dependencies

Requires an API key credential for authenticating with the ChatWoot API.
The node expects the base URL of the ChatWoot instance to be configured in the credentials.
Network connectivity to the ChatWoot API endpoint is necessary.

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 before running the node.
User IDs Format: Ensure the User Ids property is a valid JSON array of numeric or string IDs. Malformed JSON or invalid user IDs will cause the request to fail.
Authentication Errors: Missing or invalid API credentials will prevent the node from executing successfully. Confirm that the API key and base URL are correctly set.
Permission Issues: The authenticated user must have sufficient permissions to modify inbox agents. Lack of permissions will result in authorization errors.

Links and References

ChatWoot API Documentation - For detailed information on API endpoints and payloads.
ChatWoot Official Website

ChatWootInstall