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 → Create Contact
AI-generatedOverview
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 WaliChat WhatsApp API. This node is useful for automating the management of contacts in WhatsApp, such as adding new customers, leads, or personal contacts directly from workflows.
Typical use cases include:
- Automatically creating contacts when receiving new customer data from CRM or form submissions.
- Syncing contacts from external systems into WhatsApp for streamlined communication.
- Enriching contact information with detailed fields and metadata for better segmentation and personalization.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) where the contact will be created. Loaded dynamically from available devices. |
| Phone Number | The phone number of the contact in E.164 format (e.g., +447362053576). This is required to identify the contact uniquely. |
| Contact Fields | A collection of optional fields to provide additional details about the contact: - Name, Surname, Title - Contact Type: Personal or Business - Gender: Male, Female, Other - Alternative Phone - Description - Languages (up to 3 codes) - Company details (Name, Code, Tax ID, Role, Website, Email, Phone, Country) - Currency code - Address, City, Postal Code, Country - Notes (internal) - Birthday - Notifications setting: On, Mute, Ignore - Timezone - External CRM source and reference - Sync Across All Numbers (boolean) - Assign to User by ID - Upsert flag (boolean) to update if contact exists instead of error |
| Metadata | Key-value pairs for custom metadata associated with the contact. Multiple entries allowed. Keys must be alphanumeric or underscore; values up to 300 characters. |
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 WaliChat API, such as contact ID, phone number, and any other relevant fields confirming the creation.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the WaliChat WhatsApp API.
- The WhatsApp number (device) must be configured and accessible via the API.
- Proper formatting of phone numbers in E.164 format is necessary.
- If using the "Assign to User" property, valid user IDs must exist in the system.
Troubleshooting
- Invalid Phone Number Format: Ensure the phone number is in E.164 format (e.g., +1234567890). Errors may occur if the format is incorrect.
- Duplicate Contact Error: If the contact already exists and "Upsert" is false, the API may return an error. Enable "Upsert" to update existing contacts instead.
- Missing Required Fields: The WhatsApp number and phone number are mandatory. Omitting these will cause errors.
- Invalid Metadata Keys: Metadata keys must only contain alphanumeric characters and underscores; invalid keys will cause rejection.
- API Authentication Failures: Verify that the API key credential is correctly set up and has sufficient permissions.
- User Assignment Issues: When assigning a contact to a user, ensure the user ID is valid and correctly formatted (24 hexadecimal characters).