ChatWootInstall

Overview

This node integrates with the ChatWoot API to add one or more agents (users) to a specified team within an account. It is useful in scenarios where you want to programmatically manage team memberships, such as automating onboarding processes, updating team compositions based on dynamic criteria, or synchronizing user roles across systems.

For example, if your support team grows and you need to add multiple new agents to a team in ChatWoot, this node can automate that task by taking user IDs and adding them to the designated team without manual intervention.

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. The exact structure depends on the ChatWoot API response but generally contains information about the team and its members after the update.

No binary data output is involved.

Dependencies

• Requires an active connection to the ChatWoot API.
• Needs an API authentication token configured in the node’s credentials to authorize requests.
• The base URL for the ChatWoot instance must be set in the credentials.

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 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/token is correct and has sufficient permissions.
• API Rate Limits: If too many requests are made in a short period, the API may throttle requests. Implement retries or delays if necessary.

Links and References

• ChatWoot API Documentation
• ChatWoot Teams API Reference (for detailed info on team management endpoints)