Actions21
Overview
This node enables sending WhatsApp messages using the ZuckZapGo API, 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 List" operation specifically allows creating structured list messages with multiple selectable options, ideal for menus, catalogs, or organized choices in WhatsApp conversations.
Practical scenarios include:
- Sending interactive menus to customers for product selection.
- Broadcasting catalog options in an organized list format.
- Creating user-friendly choice prompts within chatbots or customer support flows.
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) to which the list message will be sent. |
| Button Text | Text displayed on the list button that users click to open the list. |
| Description | Description text shown alongside the list to guide the user. |
| Top Text | Header text displayed above the list. |
| Footer Text | Optional footer text displayed below the list. |
| List Items | Collection of items in the list. Each item includes: • Title (required): The title of the list item. • Description (optional): Additional description for the item. • Row ID (required): Unique identifier for the item. |
| Additional Options | Optional settings affecting message behavior: • Message ID: Custom message identifier. • Presence Simulation: Simulate typing/recording indicator for specified milliseconds. • Message Duration: Disappearing message timer. • View Once: Whether media can only be viewed once (not applicable here). • Context Information: Metadata for replies, forwards, mentions (e.g., forwarded flag, mention all, specific mentions, reply to message ID). |
| 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: Clean, structured response. • Raw: Complete raw API response. • Summary: Brief summary with key info only. |
Output
The node outputs JSON data representing the API response from the ZuckZapGo service after sending the list message. This typically includes message metadata such as message IDs, status, timestamps, and any error information if the send failed.
If the "Optimize Response" option is enabled, the output may be truncated or filtered to include only essential fields to facilitate AI processing.
No binary data is produced by the "Send List" operation.
Dependencies
- Requires an active connection to the ZuckZapGo API via an API key credential configured in n8n.
- The node uses HTTP requests to communicate with the ZuckZapGo backend endpoints.
- No additional external dependencies beyond the configured API credential.
Troubleshooting
- Missing Required Fields: Ensure all required properties like Recipient, Button Text, Description, Top Text, and List Items with valid titles and row IDs are provided.
- Invalid Recipient Format: The recipient must be a valid phone number or group/newsletter/LID ID with correct suffixes (
@g.us,@newsletter,@lid). - Binary Property Not Found: Although not applicable for Send List, other operations requiring binary data will throw errors if the specified binary property is missing.
- API Errors: Network issues or invalid credentials will cause request failures. Verify API key validity and network connectivity.
- Context Info Misconfiguration: If using context info for replies or mentions, ensure proper formatting of JIDs and message IDs.
- Message ID Conflicts: Providing a custom message ID that duplicates existing ones may cause errors; omit to auto-generate.
Links and References
- ZuckZapGo GitHub Repository - Official documentation and source code for the ZuckZapGo API.
- WhatsApp Interactive Messages Documentation (general reference): https://developers.facebook.com/docs/whatsapp/api/messages/interactive
This summary covers the "Send List" operation of the ZuckZapGo AI node, detailing its purpose, input properties, output structure, dependencies, and common troubleshooting tips.