Actions21
Overview
The "Send Link" operation of the ZuckZapGo AI node allows users to send WhatsApp messages containing clickable links with optional captions. This operation automatically ensures that the URL includes the proper protocol prefix (https://) if missing, and supports adding a descriptive caption to provide context or entice recipients to click the link.
This node is beneficial in scenarios such as:
- Sharing promotional URLs or product pages with customers.
- Sending event invitations or registration links.
- Distributing resource links like documentation or tutorials within chats.
- Enhancing engagement by providing rich link previews alongside messages.
For example, a marketing automation workflow could use this node to send personalized discount links to customers via WhatsApp, including a caption like "Check out this amazing offer!".
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) to which the link is sent. |
| Link URL | The URL to share. Automatically adds "https://" if missing. |
| Link Caption | Optional caption text accompanying the link message. |
| Additional Options | Collection of optional settings: - Message ID: Custom message identifier. - Presence Simulation: Simulate typing/recording indicator for 0-30000 ms. - Message Duration: Set disappearing message timer (No Expiration, 24 Hours, 7 Days, 90 Days). - Context Information: Reply, forward, mention options (e.g., mark forwarded, mention all, reply to message ID). |
| Optimize Response | Whether to optimize the API response for AI processing (reduces token usage). |
| Max Response Length | Maximum characters in the optimized response (100-10000). |
| Include Only Essential Fields | Whether to include only essential fields in the optimized response to reduce noise. |
| Response Format | Format of the response: Optimized, Raw, or Summary. |
Output
The node outputs JSON data representing the API response from the WhatsApp messaging service after sending the link message. The structure typically includes:
- Confirmation of message delivery status.
- Metadata about the sent message (e.g., message ID).
- Any errors encountered during sending.
If response optimization is enabled, the output may be truncated or simplified to improve AI processing efficiency, including flags indicating optimization and truncation details.
The node does not output binary data for this operation.
Dependencies
- Requires an active connection to the ZuckZapGo API service.
- Needs an API key credential configured in n8n for authentication.
- Network access to WhatsApp messaging endpoints via ZuckZapGo.
- No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
- Missing or invalid recipient: Ensure the "Recipient" field contains a valid phone number or group/newsletter/LID identifier in the correct format.
- Invalid URL format: The node auto-prepends "https://" if missing, but malformed URLs may cause errors. Verify the URL correctness.
- Binary property not found: Not applicable for Send Link operation but common in media operations; ensure referenced binary properties exist.
- API request failures: Check API key validity, network connectivity, and quota limits on the ZuckZapGo service.
- Context information errors: When using reply or mention features, ensure message IDs and participant JIDs are correctly specified.
- Response optimization issues: If enabled, some data might be truncated; disable optimization to get full raw responses for debugging.
Links and References
- ZuckZapGo GitHub Repository
- WhatsApp Business API documentation (for general message types and formats)
- n8n Documentation on custom nodes and credentials configuration