ChatWoot

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 include:

• Adding new support agents to a customer service inbox.
• Updating agent assignments when team members change roles.
• Automating inbox agent updates based on external triggers or workflows.

Properties

Output

The node outputs JSON data representing the updated state of the inbox agents after the operation completes. This typically includes confirmation details such as the inbox ID and the list of user IDs now associated with it.

No binary data output is involved.

Dependencies

• Requires an API key credential for authenticating with the ChatWoot API.
• The base URL for the ChatWoot instance must be configured in the node credentials.
• The node depends on the ChatWoot REST API endpoint that manages inbox agents.

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.
• Malformed User IDs JSON: The User Ids property expects a valid JSON array. Invalid JSON syntax will cause parsing errors. Ensure the input is correctly formatted.
• Authentication Errors: Missing or invalid API credentials will prevent the node from connecting to ChatWoot. Confirm that the API key and base URL are correctly set.
• Permission Issues: The API key used must have sufficient permissions to update inbox agents. Lack of permissions will result in authorization errors.

Links and References

• ChatWoot API Documentation
• Managing Agents in ChatWoot