ChatWootInstall

Overview

This node operation allows you to add one or more agents (users) to an existing team within a specified account. It is useful in scenarios where you need to manage team memberships dynamically, such as onboarding new support agents into teams or reorganizing team structures programmatically.

Practical examples include:

• Automatically adding newly hired support agents to their respective teams.
• Bulk updating team memberships based on changes in organizational structure.
• Integrating with HR or CRM systems to synchronize team assignments.

Properties

Output

The node outputs JSON data representing the result of the API call to add agents to the team. This typically includes confirmation of the updated team membership or details about the added users. There is no indication that binary data is output by this node.

Dependencies

• Requires an API key credential for authenticating with the ChatWoot API.
• The base URL for the ChatWoot instance must be configured in the credentials.
• The node uses the ChatWoot REST API endpoint related to team management.

Troubleshooting

• Invalid Account or Team ID: If the provided account or team ID does not exist or is incorrect, the API will likely return an error. Verify these IDs before running the node.
• Malformed User IDs JSON: The User Ids property expects a valid JSON array of user IDs. Invalid JSON syntax or incorrect formatting will cause parsing errors.
• Authentication Errors: Ensure the API key credential is correctly set up and has sufficient permissions to modify team memberships.
• API Rate Limits or Network Issues: Temporary failures may occur due to rate limiting or connectivity problems; retrying after some time may resolve these.

Links and References

• ChatWoot API Documentation – For detailed information on team and user management endpoints.
• n8n Documentation – For guidance on using credentials and configuring HTTP request nodes.