ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Contacts → Contact Update

AI-generated

Overview

This node updates an existing contact in a specified account within the ChatWoot system. It is useful for scenarios where you need to modify contact details such as name, email, phone number, avatar, or custom attributes programmatically. For example, you might use this node to synchronize updated customer information from your CRM into ChatWoot or to correct contact data after receiving new input.

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 contact's name.
Email The contact's email address.
Phone Number The contact's phone number.
Avatar Binary data representing the contact's avatar image, sent as form data.
Avatar Url 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 for additional contact attributes, e.g., {"type":"customer", "age":30}.

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 their ID, name, email, phone number, avatar URL, identifiers, and any custom attributes.

If the avatar is provided as binary data, it is sent as part of the request but not outputted separately by the node.

Dependencies

  • Requires an active connection to the ChatWoot API.
  • Needs an API authentication token configured in the node credentials.
  • The base URL for the ChatWoot instance must be set in the credentials.

Troubleshooting

  • Missing required fields: Ensure that 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 expects valid JSON. Malformed JSON will cause parsing errors.
  • Avatar upload issues: When sending avatar as binary data, ensure the binary property is correctly attached and the content type is supported.
  • API errors: Common errors include unauthorized access (check API token), resource not found (verify account and contact IDs), and validation errors on fields like email format.

Links and References

Discussion