ChatWootInstall

Overview

This node operation allows you to create a new user within a specified account in the system. It is useful for managing team members by assigning them roles such as administrator or agent on an account basis. For example, when onboarding a new support agent or admin to your customer service platform, this node can programmatically add that user to the relevant account with the appropriate permissions.

Properties

Output

The output JSON contains the response from the API after creating the account user. This usually includes details about the newly created account-user relationship, such as confirmation of the user being added, their assigned role, and possibly metadata like timestamps or IDs. There is no indication that binary data is returned by this operation.

Dependencies

• Requires an API key credential for authenticating requests to the ChatWoot API.
• The base URL for the API must be configured in the node credentials.
• The node depends on the external ChatWoot API service to perform the user creation.

Troubleshooting

• Common issues:
  • Invalid or missing Account Id or User Id may cause the API to reject the request.
  • Incorrect role values (anything other than allowed roles like "administrator" or "agent") might result in errors.
  • Network or authentication failures if the API key or base URL is misconfigured.
• Error messages:
  • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly set up.
  • "Invalid account or user ID": Verify that the provided IDs exist and are correct.
  • "Role not recognized": Ensure the role value matches one of the accepted roles.

Links and References

• ChatWoot API Documentation (for detailed API usage and role definitions)