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
This node allows updating a custom attribute within a specific account in the ChatWoot system. Custom attributes are metadata fields that can be attached to conversations or contacts, enabling users to store additional structured information relevant to their workflows.
Typical use cases include:
- Modifying the display name or description of an existing custom attribute.
- Changing the data type of an attribute (e.g., from text to number).
- Updating the list of possible values for attributes that support multiple options.
- Adjusting the unique key or model type associated with the attribute.
For example, a customer support team might update a "Priority Level" attribute on an account to change its display type from text to a dropdown list with predefined values.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account where the custom attribute exists. |
| Id | The numeric 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 indicating whether the attribute applies to conversations (0) or contacts (1). |
Output
The node outputs JSON data representing the updated custom attribute object as returned by the ChatWoot API. This typically includes all properties of the custom attribute after the update, such as its ID, display name, type, description, key, values, and model.
No binary data output is involved.
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 uses the ChatWoot REST API endpoint for updating custom attributes within accounts.
Troubleshooting
- Invalid Account Id or Custom Attribute Id: Ensure that the provided IDs exist and belong to your ChatWoot instance.
- Incorrect Attribute Display Type: Use only the allowed numeric codes (0-7) for the display type; otherwise, the API may reject the request.
- Malformed JSON in Attribute Values: When providing attribute values, ensure valid JSON format to avoid parsing errors.
- Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- API Endpoint Issues: Confirm the base URL is correct and reachable.
Links and References
- ChatWoot API Documentation
- Custom Attributes Guide in ChatWoot (if available)