ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Overview

This node updates a contact in the Contacts resource of the ChatWoot system. It allows users to modify existing contact details such as name, email, phone number, avatar, and custom attributes by specifying the contact's unique ID and account ID. This is useful for keeping contact information current in customer support or CRM workflows.

Practical examples include:

  • Updating a customer's email address after they notify support of a change.
  • Adding or changing a contact's avatar image via URL or binary data.
  • Modifying custom attributes like customer type or age to reflect new information.

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 use as the contact's avatar image.
Identifier A unique identifier for the contact in an external system.
Custom Attributes 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 from the ChatWoot API. This typically includes all contact fields with their latest values after the update operation.

If the avatar is sent as binary data, the node handles it accordingly but the output remains focused on the JSON representation of the contact.

Dependencies

  • Requires an API key credential for authenticating with the ChatWoot API.
  • Needs the base URL of the ChatWoot instance configured in credentials.
  • Uses the ChatWoot REST API endpoint for updating contacts.

Troubleshooting

  • Missing required fields: Ensure both Account Id and Contact Id 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 errors.
  • Avatar upload issues: When sending avatar as binary, ensure the data is correctly formatted and the content type is set properly.
  • 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 reachable.

Links and References

Discussion