ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

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 sales collaboration. For example, when onboarding new agents or reorganizing teams, this node can automate updating team members without manual intervention.

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 result of the update operation from the ChatWoot API. This typically includes confirmation of the updated team details and the list of agents now assigned to the team. 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 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 likely 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 incorrect API credentials will prevent successful API calls. Confirm that the API key and base URL are correctly set.
  • API Rate Limits or Network Issues: Temporary failures may occur due to rate limiting or connectivity problems. Retrying after some time or checking network status can help.

Links and References

Discussion