Actions36
- Account Actions
- Canned Response Actions
- Contact Actions
- Conversation Actions
- Inbox Actions
- Label Actions
- Message Actions
- Team Actions
- Webhook Actions
Overview
The node integrates with the Chatwoot API to manage contacts within a Chatwoot account. Specifically, the "Update Contact" operation allows users to modify existing contact details by specifying the contact's numeric ID and providing updated information either through structured fields or custom JSON.
This operation is useful in scenarios where you need to keep contact information up-to-date automatically, such as syncing customer data from a CRM, updating contact preferences, or managing contact statuses (e.g., blocking a contact). For example, you might update a contact's email address, phone number, or add custom attributes based on interactions tracked elsewhere.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique numeric identifier of the contact to update. |
| Send | Method to send update data: either via "Structured Fields" (individual form inputs) or "Custom JSON" (full control over the request payload). |
| Custom JSON | A JSON object representing the full payload to send for the update. This overrides all structured fields if used. |
| Fields to Update | Collection of individual fields to update when using "Structured Fields" mode. Includes: - Name: Contact's name. - Email: Contact's email address. - Phone Number: Contact's phone number. - Identifier: Unique external system ID. - Blocked: Boolean flag whether the contact is blocked. - Avatar URL: URL to an avatar image (JPG or PNG). - Inbox ID: Numeric ID of the inbox associated with the contact. - Additional Attributes: JSON key-value pairs for extra contact attributes. - Custom Attributes: JSON key-value pairs for predefined custom attributes. |
| Continue on Fail | Whether to continue processing subsequent items if this update operation fails. |
| Debug Logging | Enables detailed console logging of request construction and responses for debugging purposes. |
Output
The output is a JSON object representing the updated contact as returned by the Chatwoot API after a successful update operation. It contains all the contact's current properties including any changes made.
If the update is successful, the node outputs the updated contact data under the json field. If the operation fails and "Continue on Fail" is enabled, the output will contain an error message describing the failure.
The node does not output binary data.
Dependencies
- Requires an API authentication token credential for Chatwoot with access to the target account.
- The node makes HTTP requests to the Chatwoot API endpoints, so network connectivity to the Chatwoot instance is required.
- No additional external dependencies beyond the Chatwoot API and n8n's HTTP request helper.
Troubleshooting
- Invalid JSON Errors: When using the "Custom JSON" or JSON fields like "Additional Attributes" or "Custom Attributes," invalid JSON syntax will cause errors. Ensure JSON is well-formed.
- Contact Not Found: Providing an incorrect or non-existent Contact ID will result in an error from the API indicating the contact could not be found.
- Authentication Issues: Missing or invalid API tokens will cause authorization failures. Verify that the API key credential is correctly configured.
- Blocked Field: Setting the "Blocked" boolean incorrectly may affect contact behavior; ensure it is set intentionally.
- Debug Logging: Enable debug logging to see detailed request and response information in the console, which helps diagnose issues.