Actions113
- 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
- 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
Overview
This node allows you to update an existing contact in the Contacts API of ChatWoot. It is useful when you want to modify details of a contact such as their email, name, phone number, avatar, or custom attributes after the contact has been created. Typical use cases include syncing updated customer information from your CRM or other systems into ChatWoot to keep contact data current.
For example, if a customer's phone number changes or they upload a new profile picture, this node can be used to update those details seamlessly.
Properties
| Name | Meaning |
|---|---|
| Inbox Identifier | The identifier obtained from the API inbox channel; specifies which inbox the contact belongs to. |
| Contact Identifier | The unique source ID of the contact obtained when the contact was originally created. |
| Identifier | External identifier of the contact (optional additional ID). |
| Identifier Hash | A hash of the identifier prepared for HMAC authentication (optional security feature). |
| The email address of the contact. | |
| Name | The full name of the contact. |
| Phone Number | The contact's phone number. |
| Avatar Url | URL pointing to a JPEG or PNG image file to set as the user's avatar. |
| Custom Attributes | JSON object containing any custom attributes related to the contact. |
Output
The node outputs JSON data representing the updated contact object returned by the ChatWoot API. This typically includes all the contact's fields with their latest values after the update operation.
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 uses standard HTTP headers for JSON content type and expects JSON responses.
Troubleshooting
- Missing Required Fields: Ensure that both "Inbox Identifier" and "Contact Identifier" are provided, as these are mandatory to identify which contact to update.
- Invalid JSON in Custom Attributes: If providing custom attributes, ensure the JSON is well-formed; otherwise, parsing errors may occur.
- Authentication Errors: Verify that the API key credential is valid and has sufficient permissions to update contacts.
- Network Issues: Check connectivity to the ChatWoot instance URL configured in credentials.
- API Rate Limits: Be aware of any rate limits imposed by the ChatWoot API to avoid request failures.
Links and References
- ChatWoot API Documentation (for detailed API endpoints and payload structures)
- n8n Documentation (for general usage of n8n nodes and credentials setup)