Actions21
Overview
The "Send Location" operation of the ZuckZapGo AI node allows users to send geographic location messages via WhatsApp using the ZuckZapGo API. This operation is useful for sharing meeting points, navigation coordinates, or any place of interest with WhatsApp contacts, groups, newsletters, or LIDs.
Typical use cases include:
- Sending a meeting location to a client or colleague.
- Sharing a restaurant or event location with a group.
- Broadcasting a location update in newsletters or channels.
This operation supports adding an optional location name and various additional message options such as custom message IDs, presence simulation (typing indicator), disappearing message durations, and context information for replies or mentions.
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) to which the location will be sent. |
| Latitude | Latitude coordinate of the location to share. |
| Longitude | Longitude coordinate of the location to share. |
| Location Name | Optional name or label for the location (e.g., "Central Park"). |
| Additional Options | Collection of optional settings: - Message ID: Custom message identifier (auto-generated if omitted). - Presence Simulation: Simulate typing/recording indicator duration in milliseconds (0-30000). - Message Duration: Set WhatsApp disappearing message timer (No expiration, 24h, 7d, 90d). - Context Information: Settings for marking message as forwarded, replying to specific messages, mentioning users or all group members. (Note: Some options apply only to certain message types.) |
Output
The node outputs a JSON object representing the response from the ZuckZapGo API after sending the location message. The structure typically includes:
data: Contains details about the sent message or operation result._aiOptimized(optional): Indicates if the response was optimized for AI processing._truncated(optional): If optimization truncated data, this field shows original vs returned counts and reason.
If the node is used as a tool with response optimization enabled, it may truncate large datasets or clean the response for easier AI consumption.
No binary data output is generated for the "Send Location" operation since it deals with geographic coordinates and text metadata only.
Dependencies
- Requires an active connection to the ZuckZapGo API service.
- Needs 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
- Error: Binary property "X" not found — Not applicable for Send Location but common in media operations; ensure the specified binary property exists in input data.
- Unknown operation error — Ensure the operation parameter is correctly set to "sendLocation".
- Invalid phone number or recipient format — The recipient must be a valid phone number or group/newsletter/LID ID with correct suffixes (
@g.us,@newsletter,@lid). - API request failures — Check network connectivity and validity of the API key credential.
- Missing required parameters — Latitude, Longitude, and Recipient are mandatory; missing these will cause errors.
Links and References
- ZuckZapGo GitHub Repository — Official source and documentation for the ZuckZapGo API.
- WhatsApp Location Message Documentation (general reference): https://faq.whatsapp.com/general/chats/how-to-share-your-location
This summary focuses on the "Send Location" operation of the ZuckZapGo AI node, describing its purpose, inputs, outputs, dependencies, and common troubleshooting tips based on static code analysis.