ChatWootInstall

Overview

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

Practical examples include:

• Automatically adding newly hired support agents to their designated 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 a JSON object representing the result of the API call to add agents to the team. This typically includes confirmation details such as updated team membership information or status messages from the service.

No binary data output is involved in this operation.

Dependencies

• Requires an API key credential for authenticating with the ChatWoot API.
• The node depends on the ChatWoot API endpoint configured via credentials, including the base URL and authentication headers.
• Proper permissions are needed on the API key to modify team memberships.

Troubleshooting

• Invalid Account or Team ID: If the provided account or team ID does not exist or is incorrect, the API will return an error. Verify that these IDs are correct and accessible by the authenticated user.
• 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.
• Insufficient Permissions: If the API key lacks permission to update teams, the request will fail. Confirm that the API key has adequate rights.
• Network or Authentication Errors: Check network connectivity and ensure the API key and base URL are correctly configured in the node credentials.

Links and References

• ChatWoot API Documentation – For detailed API endpoints and payload formats.
• n8n Documentation – For general guidance on using n8n nodes and managing credentials.