WaliChat icon

WaliChat

Interact with WaliChat WhatsApp API

Actions148

Chat Contacts → Update Contact

AI-generated

Overview

The "Update Contact" operation in the Chat Contacts resource allows users to modify existing contact information associated with a WhatsApp number. This node is useful for keeping contact details up-to-date, such as names, phone numbers, company info, and custom metadata. It supports both updating specific fields and removing unwanted fields from a contact.

Practical scenarios include:

  • Synchronizing CRM updates with WhatsApp contacts.
  • Correcting or adding missing contact details like email or address.
  • Managing contact preferences such as notification settings or language codes.
  • Adding or updating metadata key-value pairs for enhanced contact categorization.
  • Removing obsolete or incorrect contact fields.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) under which the contact exists.
Contact ID The unique identifier of the contact to update (e.g., 447362053576@c.us).
Contact Fields Collection of contact attributes to update. Options include:
- Name (first name, max 30 chars)
- Surname (last name, max 50 chars)
- Title (max 15 chars)
- Contact Type (Personal, Business)
- Gender (Male, Female, Other)
- Alternative Phone (E.164 format)
- Email
- Description (max 100 chars)
- Languages (up to 3 language codes)
- Company Name, Code, Tax ID, Role, Website, Email, Phone, Country
- Currency (ISO 4217)
- Address, City, Postal Code, Country (ISO 3166-2)
- Notes (internal, max 3000 chars)
- Birthday (date/time)
- Notifications (On, Mute, Ignore)
- Timezone (e.g., America/New_York)
- CRM source and reference
- Sync Across All Numbers (boolean)
Metadata Key-value pairs to add or update as metadata on the contact. Keys must be alphanumeric or underscores; values up to 300 characters. Multiple metadata entries can be added.
Fields to Remove List of contact fields to remove from the contact. Possible fields include Name, Surname, Alternative Phone, Email, Company details, Title, Country, Address, City, CRM info, Notes, Gender, Currency, Birthday, Description, Languages, Links, Sync.

Output

The node outputs JSON data representing the updated contact object after applying changes. This typically includes all current contact fields reflecting the updates and removals performed. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the WaliChat WhatsApp API.
  • The WhatsApp number (device) must be valid and accessible via the connected account.
  • Proper permissions to update contacts on the specified WhatsApp number are necessary.

Troubleshooting

  • Error: Contact ID not found — Ensure the Contact ID is correct and exists under the specified WhatsApp number.
  • Invalid field values — Check that string lengths and formats conform to the described limits (e.g., max characters, E.164 phone format).
  • API authentication errors — Verify that the API key credential is correctly configured and has sufficient permissions.
  • Field removal issues — Attempting to remove fields that do not exist may cause errors; confirm the fields are present before removal.
  • Metadata key format errors — Metadata keys must only contain alphanumeric characters and underscores; invalid keys will cause failures.

To resolve most issues, verify input parameters carefully and ensure the API credentials and WhatsApp number are properly set up.

Links and References

Discussion