Wassenger icon

Wassenger

Interact with Wassenger WhatsApp API
Join our community

Actions148

Overview

The "Create Contact" operation under the "Chat Contacts" resource allows users to add a new contact to their WhatsApp number's contact list via the Wassenger WhatsApp API. This node is useful for automating the management of contacts in WhatsApp, such as adding new leads, customers, or personal contacts programmatically. It supports detailed contact information including personal details, company info, metadata, and synchronization options.

Practical examples include:

  • Automatically creating a contact when a new lead is captured from a web form.
  • Syncing customer contact details from a CRM system into WhatsApp contacts.
  • Adding business contacts with detailed company information for marketing campaigns.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) where the contact will be created.
Phone Number The phone number of the contact in E.164 format (e.g., +447362053576).
Contact Fields A collection of optional fields describing the contact:
- Name: First name (max 30 chars)
- Surname: Last name (max 50 chars)
- Title: Contact's title (max 15 chars)
- Contact Type: Personal or Business
- Gender: Male, Female, Other
- Alternative Phone: Secondary phone number in E.164 format
- Email: Contact's email address
- Description: Short description (max 100 chars)
- Languages: Up to 3 language codes (e.g., en, fr, es)
- Company Name, Code, Tax ID, Role, Website, Email, Phone, Country
- Currency code
- Address, City, Postal Code, Country
- Notes: Internal notes (max 3000 chars)
- Birthday
- Notifications: On, Mute, Ignore
- Timezone
- CRM source and reference
- Sync Across All Numbers: Boolean to sync contact across all WhatsApp numbers
- Assign to User: User ID to assign the contact
- Upsert: Boolean to update existing contact instead of error
Metadata Key-value pairs for additional metadata about the contact. Keys must be alphanumeric or underscore; values up to 300 characters. Multiple metadata entries can be added.

Output

The node outputs JSON data representing the result of the create contact operation. This typically includes the newly created contact's details as returned by the Wassenger API, such as contact ID, phone number, and any other relevant fields confirming the creation.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Wassenger WhatsApp API.
  • The node depends on the Wassenger service being accessible and properly configured.
  • The WhatsApp number (device) must be registered and active within the Wassenger account.

Troubleshooting

  • Common issues:
    • Invalid phone number format: Ensure the phone number is in E.164 format.
    • Missing required fields: WhatsApp Number and Phone Number are mandatory.
    • API authentication errors: Verify that the API key credential is correctly set up.
    • Duplicate contact error: If the contact already exists and upsert is false, the API may return an error.
  • Error messages:
    • "Invalid phone number": Check the phone number formatting.
    • "Unauthorized": Check API key validity and permissions.
    • "Contact already exists": Use the upsert option to update existing contacts instead of failing.
  • To resolve errors, verify input data correctness, ensure credentials are valid, and consider enabling upsert if updating existing contacts is desired.

Links and References

Discussion