Wassenger icon

Wassenger

Interact with Wassenger WhatsApp API
Join our community

Actions148

Overview

The "Update Contact" operation in the Chat Contacts resource allows users to modify existing WhatsApp contact details within their Wassenger account. This node is useful for keeping contact information up-to-date, such as changing names, phone numbers, company details, or other metadata associated with a contact.

Practical scenarios include:

  • Updating a customer's email or phone number after receiving new information.
  • Changing the contact's company role or address when they switch jobs.
  • Removing outdated fields from a contact record.
  • Adding or updating custom metadata key-value pairs for better segmentation or CRM integration.

This operation helps maintain accurate and enriched contact data, which is essential for personalized messaging and effective customer relationship management.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) associated with the contact.
Contact ID The unique identifier of the contact to update (e.g., 447362053576@c.us).
Contact Fields A collection of fields to update on the contact, including:
- Name (first name, max 30 chars)
- Surname (last name, max 50 chars)
- Title (max 15 chars)
- Contact Type: Personal or 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 code
- Address, City, Postal Code, Country
- Notes (internal, max 3000 chars)
- Birthday (date/time)
- Notifications: On, Mute, Ignore
- Timezone
- CRM source and reference
- Sync Across All Numbers (boolean)
Metadata Key-value pairs to add or update as metadata for 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 record. Options include most contact fields like Name, Surname, Email, Company details, Address, Notes, Gender, Birthday, etc.

Output

The node outputs JSON data representing the updated contact object returned by the Wassenger API. This typically includes the contact's current state after the update, reflecting all changed fields and metadata.

If the operation fails, and "Continue On Fail" is enabled, the output will contain an error message describing the failure.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Wassenger WhatsApp API via an API key credential configured in n8n.
  • The node depends on the Wassenger API endpoints for chat contacts.
  • Proper permissions on the Wassenger account to update contacts are necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing WhatsApp Number (device) ID or Contact ID will cause errors.
    • Attempting to update fields with invalid formats (e.g., phone numbers not in E.164 format) may fail.
    • Removing fields that do not exist might be ignored or cause warnings depending on the API behavior.
    • Exceeding character limits on fields like name, notes, or description can result in validation errors.

  • Error Messages:

    • "Contact not found": Verify the Contact ID is correct and exists under the specified WhatsApp number.
    • "Invalid field value": Check the format and length of the input fields.
    • "Unauthorized" or authentication errors: Ensure the API key credential is valid and has required permissions.

  • Resolution Tips:

    • Double-check IDs and formats before running the node.
    • Use the "Fields to Remove" property carefully to avoid unintended data loss.
    • Enable "Continue On Fail" during testing to capture errors without stopping workflow execution.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions. It does not include runtime behavior or dynamic API responses.

Discussion