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
Chat Contacts → Bulk Create Contacts
AI-generatedOverview
This node integrates with the WaliChat WhatsApp API to bulk create chat contacts associated with a specified WhatsApp number. It allows users to add multiple contacts at once, which is useful for managing large contact lists efficiently within WhatsApp business workflows.
Common scenarios include:
- Importing a list of customer contacts into WhatsApp for marketing or support.
- Synchronizing CRM contacts in bulk to WhatsApp.
- Quickly setting up contact databases for outreach campaigns.
For example, a user can provide a WhatsApp number and a list of up to 1000 contacts (each with phone number, name, surname, email, and company) to create or update these contacts in one operation.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number to which the contacts will be linked. |
| Contacts | A collection 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) | |
| - 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 existing contacts should be updated if they already exist. |
Output
The node outputs JSON data representing the result of the bulk create operation. This typically includes information about each contact created or updated, such as success status or any errors encountered per contact.
No binary data output is involved.
Dependencies
- Requires an active connection to the WaliChat WhatsApp API via an API key credential.
- The node depends on the WaliChat API service being available and properly configured.
- The WhatsApp number used must be valid and authorized within the WaliChat system.
Troubleshooting
Common issues:
- Invalid phone number format: Ensure all phone numbers are in E.164 format.
- Exceeding contact limit: The bulk create supports up to 1000 contacts per execution.
- API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
- Network or API downtime: Check connectivity and WaliChat service status.
Error messages:
- Errors related to invalid input fields usually specify which contact or field caused the problem.
- Authentication failures indicate issues with the provided API key.
- Rate limiting or quota exceeded errors suggest too many requests in a short time; consider adding delays or reducing batch size.
Resolving these generally involves validating inputs, checking credentials, and ensuring compliance with API usage limits.