Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Overview
This node integrates with the Wassenger WhatsApp API to bulk create chat contacts associated with a specified WhatsApp number. It allows users to add multiple contacts at once, optionally updating existing contacts if they already exist. This is particularly useful for businesses or teams managing large contact lists on WhatsApp, enabling efficient onboarding or synchronization of contacts in bulk.
Practical examples:
- Importing a customer list into WhatsApp for marketing or support purposes.
- Synchronizing CRM contacts with WhatsApp contacts in one operation.
- Updating contact details in bulk when information changes.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) under which the contacts will be created. |
| Contacts | A list of contacts to create in bulk (up to 1000). Each contact includes: |
| - Phone Number: Contact's phone number in E.164 format (e.g., +447362053576) (required). | |
| - Name: Contact's first name (max 30 characters). | |
| - Surname: Contact's last name (max 50 characters). | |
| - Email: Contact's email address. | |
| - Company: Contact's company name. | |
| Upsert Existing Contacts | Boolean flag indicating whether to update existing contacts if they already exist (true or false). |
Output
The node outputs an array of JSON objects representing the result of the bulk contact creation operation. Each object corresponds to the response from the API for each input item processed. The exact structure depends on the API response but generally includes confirmation of created or updated contacts and any relevant metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Wassenger WhatsApp API via an API key credential.
- The node expects the WhatsApp number (device) to be pre-configured and accessible through the API.
- No additional external dependencies beyond the Wassenger API are required.
Troubleshooting
Common issues:
- Invalid phone number format: Ensure all phone numbers are in E.164 format (e.g., +123456789).
- Exceeding contact limits: The API may limit bulk operations to 1000 contacts per request.
- Missing or invalid WhatsApp number ID: Verify that the WhatsApp number/device ID is correct and authorized.
- API authentication errors: Confirm that the API key credential is valid and has necessary permissions.
Error messages:
"error": "Invalid phone number format"— Check and correct the phone number formatting."error": "Unauthorized"— Verify API key credentials and permissions."error": "Contact limit exceeded"— Reduce the number of contacts in the batch to within allowed limits.
To resolve errors, review the input data carefully, ensure proper configuration of credentials, and consult the Wassenger API documentation for specific error codes.