ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Teams → Update Agents In Team

AI-generated

Overview

This node interacts with the ChatWoot API to update the list of agents assigned to a specific team within an account. It is useful in scenarios where you need to programmatically manage team memberships, such as adding multiple users to a team for customer support or collaboration purposes. For example, when onboarding new support agents, this node can be used to add their user IDs to the appropriate team automatically.

Properties

Name Meaning
Account Id The numeric ID of the account where the team exists.
Team Id The ID of the team whose agent membership will be updated.
User Ids A JSON array containing the IDs of users to be added to the team.

Output

The node outputs JSON data representing the response from the ChatWoot API after updating the team's agents. This typically includes confirmation of the update and details about the team and its members. There is no binary output.

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 @devlikeapro/n8n-openapi-node package for OpenAPI integration.

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: If the API key or base URL is incorrect or missing, authentication will fail. Check the credential configuration.
  • API Rate Limits: Frequent updates might hit rate limits imposed by ChatWoot. Implement retry logic or reduce request frequency if needed.

Links and References

Discussion