Actions21
Overview
This node enables sending WhatsApp messages through the DinastiAPI service, optimized for AI workflows. It supports a wide range of message types including text, images, documents, audio, video, locations, contacts, stickers, interactive buttons, lists, polls, and links. The "Send Contact" operation specifically allows sharing contact information using vCard format, which is useful for sending business cards or personal contact details seamlessly within WhatsApp conversations.
Practical scenarios include:
- Sharing a colleague's or client's contact card during a chat.
- Broadcasting contact info to groups or newsletters.
- Automating customer support by sending contact details dynamically.
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) identifying the message recipient. |
| Contact Name | The display name of the contact being shared. |
| VCard | The vCard data string containing the contact's detailed information in standard vCard format (e.g., name, phone number). |
| Additional Options | Optional settings to customize the message: - Message ID: Custom identifier for the message. - Presence Simulation: Simulate typing/recording indicator for up to 30 seconds. - Message Duration: Set disappearing message timer (No expiration, 24h, 7d, 90d). - Context Information: Reply, forward, mentions, and other metadata to enrich the message context. |
| Optimize Response | Whether to optimize the API response to reduce token usage and improve AI processing. |
| Max Response Length | Maximum characters allowed in the response; longer responses are truncated. |
| Include Only Essential Fields | Whether to include only essential fields in the response to reduce noise. |
| Response Format | Format of the response returned by the node: Optimized (structured for AI), Raw (complete API response), or Summary (brief key info). |
Output
The node outputs JSON data representing the API response from DinastiAPI after sending the contact message. This includes status information about the sent message, any generated message IDs, and metadata related to the operation.
If the "optimizeResponse" option is enabled, the output may be truncated or simplified to improve AI processing efficiency.
No binary data is produced for the "Send Contact" operation since it deals with textual vCard data.
Dependencies
- Requires an active DinastiAPI API key credential configured in n8n.
- Internet access to communicate with the DinastiAPI endpoints.
- Properly formatted vCard data as input for the contact information.
Troubleshooting
- Error: Binary property not found — Not applicable for Send Contact but common in media operations; ensure the specified binary property exists if sending media.
- Invalid vCard format — Ensure the vCard string follows the correct syntax (BEGIN:VCARD ... END:VCARD).
- Recipient format errors — The recipient must be a valid phone number or group/newsletter/LID ID with appropriate suffixes (@g.us, @newsletter, @lid).
- API authentication failures — Verify that the API key credential is correctly set up and has necessary permissions.
- Message sending failures — Check network connectivity and API service status.
Links and References
- DinastiAPI GitHub Repository — Official documentation and source code for the DinastiAPI service.
- vCard Format Specification — Standard defining the vCard format used for contact sharing.