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 operation allows you to add one or more agents (users) to a specific inbox within an account on the ChatWoot platform. It is useful for managing team members who can access and respond to conversations in that inbox. For example, when onboarding new support staff or reassigning responsibilities, this operation helps update inbox membership dynamically.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the ChatWoot account where the inbox exists. |
| Inbox Id | The unique identifier of the inbox to which agents will be added. |
| User Ids | A JSON array containing the IDs of users (agents) to be added to the specified inbox. |
Output
The node outputs JSON data representing the result of the API call to add agents to the inbox. This typically includes confirmation details such as the updated list of agents or status messages from the ChatWoot API. There is no binary output involved.
Dependencies
- Requires an active connection to the ChatWoot API.
- Needs an API authentication token configured in the node credentials.
- The base URL for the ChatWoot instance must be set in the credentials.
- The node uses HTTP requests with JSON payloads to interact with the ChatWoot service.
Troubleshooting
- Invalid Account or Inbox ID: Ensure 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 user IDs. Invalid JSON or incorrect formatting will cause errors.
- Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions to modify inbox memberships.
- API Rate Limits: If many users are added frequently, watch out for rate limiting by the ChatWoot API.
- Empty or Null User IDs: Adding null or empty user IDs may lead to API errors; ensure the array contains valid user identifiers.