ChatWoot

Interact with ChatWoot API

Actions113

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

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 managing team members who should no longer have access to handle conversations in a particular inbox, such as when an agent leaves the team or changes roles.

Practical examples:

Removing a support agent from the "Customer Support" inbox after they leave the company.
Cleaning up inbox assignments by deleting multiple users from an inbox that is being reassigned.
Automating user management workflows where inbox memberships are updated based on external HR systems.

Properties

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

Output

The node outputs JSON data representing the response from the ChatWoot API after attempting to delete the specified agents from the inbox. This typically includes confirmation of success or details about any errors encountered.

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 the node credentials to authorize requests.
The base URL for the ChatWoot instance must be set in the credentials.

Troubleshooting

Invalid Account or Inbox ID: Ensure that the provided Account Id and Inbox Id are correct and exist in your ChatWoot instance.
User IDs Format: The User Ids property must be a valid JSON array of numeric or string IDs. Malformed JSON or incorrect types may cause request failures.
Authentication Errors: Verify that the API key credential is valid and has sufficient permissions to modify inbox memberships.
API Rate Limits: If many requests are made in a short time, you might hit rate limits imposed by ChatWoot. Implement retries or backoff strategies if needed.
Error Messages: The node will relay error messages from the ChatWoot API, which can include reasons like "User not found in inbox" or "Permission denied." Review these messages to adjust inputs or credentials accordingly.