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 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, correcting contact details, or enriching contact profiles with additional data.
For example, if a customer's phone number changes or you want to add a profile picture URL, this node can perform those updates programmatically within an n8n workflow.
Properties
| Name | Meaning |
|---|---|
| Inbox Identifier | The identifier obtained from the API inbox channel where the contact belongs. |
| Contact Identifier | The unique source ID of the contact obtained when the contact was originally created. |
| Identifier | External identifier of the contact (optional). |
| Identifier Hash | Identifier hash prepared for HMAC authentication (optional). |
| Email address of the contact (optional). | |
| Name | Full name of the contact (optional). |
| Phone Number | Phone number of the contact (optional). |
| Avatar Url | URL pointing to a JPEG or PNG file to be used as the user's avatar (optional). |
| Custom Attributes | JSON object containing any custom attributes to associate with the contact (optional). |
Output
The node outputs JSON data representing the updated contact object returned by the ChatWoot API. This typically includes all the contact's current details after the update operation, such as identifiers, contact info, and any custom attributes.
If the API supports binary data related to contacts (e.g., avatar images), it would be handled accordingly, but based on the provided code and properties, the output focuses on JSON contact data.
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 contacts.
Troubleshooting
- Missing Required Fields: Ensure that both "Inbox Identifier" and "Contact Identifier" are provided; these are mandatory to identify which contact to update.
- Invalid JSON in Custom Attributes: If providing custom attributes, ensure the JSON is well-formed to avoid parsing errors.
- Authentication Errors: Verify that the API key credential is valid and has sufficient permissions.
- Network Issues: Confirm that the ChatWoot API endpoint is reachable from the n8n environment.
- API Rate Limits: Be aware of any rate limits imposed by ChatWoot that might cause request failures.