Actions113
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Contacts API Actions
- Inbox API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Custom Attributes Actions
- Canned Response Actions
Overview
The "Update A Team" operation in the Teams resource allows users to modify the details of an existing team within their account. This node is useful for managing team configurations dynamically, such as changing a team's name, description, or auto-assignment settings without manually updating them through a user interface.
Practical examples include:
- Renaming a support team after restructuring.
- Updating the description to reflect new responsibilities.
- Enabling or disabling automatic assignment of conversations to agents within the team.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account to which the team belongs. |
| Team Id | The numeric ID of the team that you want to update. |
| Name | The new name for the team. |
| Description | A textual description of the team’s purpose or role. |
| Allow Auto Assign | Boolean flag indicating whether conversations assigned to the team should be automatically assigned to an agent within the team (true or false). |
Output
The node outputs JSON data representing the updated team object returned by the API. This typically includes the updated fields such as team ID, name, description, and auto-assign setting, confirming the changes were applied successfully.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the ChatWoot API.
- The base URL for the ChatWoot instance must be configured in the credentials.
- The node depends on the ChatWoot REST API being accessible and the user having appropriate permissions to update teams.
Troubleshooting
- Invalid Account or Team ID: If the provided account or team ID does not exist or the user lacks permission, the API will return an error. Verify IDs and access rights.
- Missing Required Fields: Both Account Id and Team Id are required. Omitting these will cause the request to fail.
- API Authentication Errors: Ensure the API key credential is valid and has not expired.
- Network Issues: Connectivity problems to the ChatWoot server will prevent updates; check network and endpoint availability.
- Invalid Field Values: For example, providing non-boolean values for "Allow Auto Assign" may cause errors.
Links and References
- ChatWoot API Documentation (for detailed API endpoints and payloads)
- n8n Documentation on Creating Custom Nodes