ChatWoot

Overview

This node operation updates the agents assigned to a specific team within an account. It allows users to modify the membership of a team by specifying which user IDs should be added as agents. This is useful in scenarios where team compositions change frequently, such as customer support teams adjusting their agent assignments based on workload or availability.

Practical examples include:

• Adding new support agents to a team after hiring.
• Reassigning agents between teams to balance workloads.
• Automating team updates based on external HR or scheduling systems.

Properties

Output

The node outputs JSON data representing the result of the update operation. This typically includes confirmation of the updated team details and the list of agents now assigned to the team. 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 for updating team agents.

Troubleshooting

• Invalid Account or Team ID: If the provided account or team ID does not exist, the API will return an error. Verify that these IDs are correct.
• Malformed User IDs JSON: The User Ids property expects a valid JSON array. Ensure the input is correctly formatted JSON; otherwise, parsing errors may occur.
• Authentication Errors: Missing or invalid API credentials will cause authentication failures. Confirm that the API key and base URL are correctly set.
• Permission Issues: The API user must have sufficient permissions to update team memberships. Lack of permissions will result in authorization errors.

Links and References

• ChatWoot API Documentation
• n8n Documentation - Creating Custom Nodes