ChatWootInstall

Overview

This node interacts with the ChatWoot API to update the list of agents assigned to a specific inbox within an account. It allows users to add or modify which agents (users) have access to handle conversations in that inbox. This is useful for managing team assignments dynamically, ensuring the right agents are linked to the correct communication channels.

Practical examples:

• Adding new support agents to a customer service inbox after hiring.
• Updating agent assignments when teams are reorganized.
• Automating inbox-agent mappings based on business rules or schedules.

Properties

Output

The node outputs JSON data representing the response from the ChatWoot API after updating the agents in the specified inbox. This typically includes confirmation of the updated inbox details and the list of assigned agents.

If the API supports it, binary data output is not expected for this operation.

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.

Troubleshooting

• Invalid Account or Inbox ID: Ensure the provided Account Id and Inbox Id exist and are correct; otherwise, the API will return errors.
• Malformed User Ids JSON: The User Ids property expects a valid JSON array of user IDs. Invalid JSON will cause parsing errors.
• Authentication Errors: Verify that the API key or token is correctly configured and has sufficient permissions to update inbox agents.
• API Rate Limits: Frequent updates may hit rate limits imposed by ChatWoot; consider adding delays or retries.

Links and References

• ChatWoot API Documentation
• Managing Agents and Inboxes in ChatWoot