Actions21
Overview
The "Send Contact" operation of the ZuckZapGo AI node allows users to send contact information via WhatsApp using the vCard format. This is useful for sharing business cards or personal contact details seamlessly within WhatsApp conversations. The node supports sending contacts to individual phone numbers, groups, newsletters, or LIDs.
Practical scenarios include:
- Automatically sharing a customer support representative's contact card in response to user queries.
- Broadcasting updated contact information to a WhatsApp group or newsletter subscribers.
- Integrating CRM systems to push contact cards directly into WhatsApp chats.
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) to send the contact. |
| Contact Name | The display name of the contact being sent. |
| VCard | The vCard data string containing the contact details in standard vCard format. |
| Additional Options | Optional settings including: |
| - Message ID: Custom message identifier (auto-generated if omitted). | |
| - Presence Simulation: Simulate typing/recording indicator for specified milliseconds (0-30000). | |
| - Message Duration: Disappearing message duration with options: No Expiration, 24h, 7d, 90d. | |
| - Context Information: Metadata for replies, forwards, mentions (e.g., forwarded flag, reply ID). |
Output
The node outputs a JSON object representing the API response from the WhatsApp service after attempting to send the contact message. This includes status information and any returned metadata.
If the operation succeeds, the output JSON contains details about the sent message. If an error occurs, the output JSON will contain an error field describing the issue.
No binary data is produced by this operation.
Dependencies
- Requires an active connection to the ZuckZapGo API service.
- Requires an API key credential configured in n8n for authentication with ZuckZapGo.
- The node uses internal helper functions to prepare media data and make HTTP requests to the API endpoints.
Troubleshooting
- Missing Required Fields: Ensure that the "Recipient", "Contact Name", and "VCard" fields are provided and correctly formatted.
- Invalid vCard Format: The vCard string must follow the standard format (e.g., BEGIN:VCARD ... END:VCARD). Malformed vCards may cause message sending failures.
- Binary Property Not Found: Although not applicable for this operation, other operations requiring binary data will throw errors if the specified binary property is missing.
- API Errors: Network issues or invalid API credentials will result in errors. Verify API key validity and network connectivity.
- Message ID Conflicts: Providing a custom message ID that duplicates an existing one may cause errors; omit to auto-generate.
Links and References
- ZuckZapGo GitHub Repository - Official documentation and source code for the API used by this node.
- vCard Format Specification - Details on the vCard format used for contact sharing.