Actions21
Overview
The "Send Link" operation of the DinastiAPI AI node allows users to send WhatsApp messages containing clickable links with optional captions. This operation automatically ensures that the URL starts with "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 informational links in group chats.
- Distributing newsletters or updates with direct access links.
- Enhancing communication by embedding rich link previews (if supported).
Example use case: A business wants to send a new product launch page link to a customer or group with a caption like "Check out this amazing website!" to increase engagement.
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 prepends "https://" if missing. |
| Link Caption | Optional text caption accompanying the link message. |
| Additional Options | Collection of optional settings including: |
| - Message ID: Custom message identifier (auto-generated if omitted). | |
| - Presence Simulation: Simulate typing/recording indicator for specified milliseconds (0-30000ms). | |
| - Message Duration: Set disappearing message duration (No expiration, 24h, 7d, 90d). | |
| - Context Information: Reply, forward, mention all or specific users in groups. | |
| Optimize Response | Whether to optimize the API response for AI processing (only relevant if used as a tool). |
| Max Response Length | Maximum characters in the optimized response (when optimization enabled). |
| Include Only Essential Fields | Whether to include only essential fields in the optimized response. |
| Response Format | Format of the response: Optimized, Raw, or Summary (for AI agent understanding). |
Output
The node outputs JSON data representing the API response from the DinastiAPI service after sending the link message. The structure typically includes status information about the message delivery and any metadata returned by the API.
If the node is used as a tool with response optimization enabled, the output may be truncated or simplified to reduce token usage and improve AI processing efficiency.
No binary data is produced by the "Send Link" operation.
Dependencies
- Requires an active connection to the DinastiAPI WhatsApp messaging service.
- Requires configuration of an API key credential for authenticating requests to DinastiAPI.
- The node uses HTTP POST requests to the
/chat/send/linkendpoint of the DinastiAPI. - No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
- Error: Binary property not found — Not applicable for "Send Link" but common in media operations; ensure correct binary property name if using media inputs.
- Invalid phone number or recipient format — Ensure the recipient is correctly formatted as a phone number or valid group/newsletter/LID identifier.
- Missing or invalid URL — The link URL must be a valid string; the node auto-prepends "https://" if missing but malformed URLs will cause errors.
- API authentication errors — Verify that the API key credential is correctly configured and has necessary permissions.
- Message delivery failures — Could be due to invalid recipient, network issues, or WhatsApp restrictions; check API response details for error messages.
- Context info misuse — When using reply or mention options, ensure correct message IDs and participant JIDs are provided to avoid errors.
Links and References
- DinastiAPI GitHub Repository — Official documentation and source code for the DinastiAPI service.
- WhatsApp Business API documentation (general concepts on message types and formats).
- n8n Documentation on creating and using custom nodes and credentials.