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
- Webhooks Actions
- Teams Actions
- Custom Filters Actions
- Reports Actions
Overview
This node updates an existing contact in the Contacts API of ChatWoot. It is useful when you need to modify contact details such as email, name, phone number, avatar URL, or custom attributes after the contact has been created. Typical scenarios include syncing updated customer information from a CRM system, correcting contact data, or enriching contact profiles with additional metadata.
For example, if a customer's phone number changes or you want to add a profile picture URL, this node allows you to send those updates directly to the ChatWoot contact record identified by its unique contact identifier.
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). |
| Identifier Hash | Identifier hash prepared for HMAC authentication (optional). |
| Email address of the contact (optional). | |
| Name | Name of the contact (optional). |
| Phone Number | Phone number of the contact (optional). |
| Avatar Url | URL to a JPEG or PNG file used as the user's avatar (optional). |
| Custom Attributes | JSON object containing custom attributes for the contact, allowing flexible metadata storage. |
Output
The node outputs JSON data representing the updated contact object returned by the ChatWoot API. This typically includes all the contact's current fields such as identifiers, email, name, phone number, avatar URL, and any custom attributes after the update operation.
No binary data output is produced by this node.
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 they are mandatory for identifying which contact to update.
- Invalid JSON in Custom Attributes: If providing custom attributes, ensure the JSON is well-formed; otherwise, the request may fail.
- Authentication Errors: Verify that the API key credential is valid and has sufficient permissions to update contacts.
- Network or URL Issues: Confirm that the base URL for the ChatWoot API is correct and accessible from your n8n environment.
- API Rate Limits: Be aware of any rate limits imposed by the ChatWoot API that might cause requests to be throttled.