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 updates an existing contact in the Contacts resource of the ChatWoot system. It is useful when you need to modify details of a contact such as their name, email, phone number, avatar, or custom attributes. Typical scenarios include synchronizing contact information from another system, correcting outdated data, or enriching contact profiles with additional metadata.
For example, you might use this node to update a customer's phone number after they provide a new one, or to add a unique external identifier for integration purposes.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account to which the contact belongs (required). |
| Id | The unique numeric ID of the contact to update (required). |
| Name | The updated name of the contact. |
| The updated email address of the contact. | |
| Phone Number | The updated phone number of the contact. |
| Avatar | The avatar image data sent as form data binary or string. |
| Avatar Url | A URL pointing to a JPEG or PNG file to be used as the contact's avatar. |
| Identifier | A unique identifier for the contact in an external system. |
| Custom Attributes | A JSON object containing custom key-value pairs to store additional attributes for 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 after the update, such as id, name, email, phone number, avatar URL, identifiers, and any custom attributes.
If the node supports binary data for the avatar, it handles sending that data but does not output binary data itself.
Dependencies
- Requires an API key credential for authenticating with the ChatWoot API.
- Needs the base URL of the ChatWoot instance configured in the credentials.
- Depends on the ChatWoot REST API being accessible and operational.
Troubleshooting
- Missing required fields: Ensure both "Account Id" and "Id" of the contact are provided; otherwise, the API will reject the request.
- Invalid JSON in Custom Attributes: The "Custom Attributes" field must be valid JSON; invalid syntax will cause parsing errors.
- Avatar upload issues: If providing avatar image data, ensure it is correctly formatted and matches expected content types.
- API authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Network or URL errors: Confirm the base URL is correct and the ChatWoot server is reachable.
Links and References
- ChatWoot API Documentation (for detailed API endpoints and payloads)
- n8n Documentation (for general usage of nodes and credentials)