Actions113
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- 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
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
Overview
This node operation updates a custom attribute within a specified account in the ChatWoot system. Custom attributes allow users to define additional metadata or properties related to conversations or contacts, enhancing data organization and filtering capabilities.
Typical use cases include:
- Modifying the display name or description of an existing custom attribute to better reflect its purpose.
- Changing the type of the attribute (e.g., from text to number) to accommodate different data formats.
- Updating the list of possible values for attributes that represent enumerations or lists.
- Adjusting the unique key or model type associated with the attribute.
For example, if you have a custom attribute representing customer satisfaction score as a number, you might update its display type or description to clarify its meaning.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account where the custom attribute exists. |
| Id | The ID of the custom attribute to be updated. |
| Attribute Display Name | The new display name for the custom attribute. |
| Attribute Display Type | The display type of the attribute. Possible values: 0 (text), 1 (number), 2 (currency), 3 (percent), 4 (link), 5 (date), 6 (list), 7 (checkbox). |
| Attribute Description | A textual description explaining the purpose or details of the attribute. |
| Attribute Key | The unique key identifier for the attribute. |
| Attribute Values | JSON array representing the possible values for the attribute (useful for list-type attributes). |
| Attribute Model | The model type of the attribute: 0 for conversation attribute, 1 for contact attribute. |
Output
The node outputs JSON data representing the updated custom attribute object as returned by the ChatWoot API. This typically includes all attribute fields such as id, display name, type, description, key, values, and model type reflecting the changes made.
No binary data output is involved.
Dependencies
- Requires an active connection to the ChatWoot API.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The base URL for the ChatWoot instance must be set in the credentials.
Troubleshooting
- Invalid Account Id or Attribute Id: If the provided IDs do not exist or are incorrect, the API will return an error indicating the resource was not found. Verify the IDs before running the node.
- Invalid Attribute Values Format: The
attribute_valuesproperty expects valid JSON. Malformed JSON will cause parsing errors. Ensure the JSON syntax is correct. - Insufficient Permissions: If the API token lacks permissions to update custom attributes, the request will fail with an authorization error. Confirm the API key has appropriate scopes.
- Unsupported Attribute Display Type or Model: Using unsupported numeric codes for display type or model may result in API rejection. Use only documented values.