ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

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 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.

Links and References

Discussion