Actions21
Overview
The "Send Poll" operation of the ZuckZapGo AI node allows users to create and send interactive poll messages via WhatsApp. This feature is useful for gathering opinions, conducting surveys, or making group decisions by enabling recipients to vote on multiple-choice questions directly within WhatsApp chats.
Typical use cases include:
- Collecting feedback from team members in a group chat.
- Running quick polls among customers or subscribers.
- Engaging community members with decision-making questions.
For example, a user can send a poll asking "What's your favorite color?" with options like "Red, Blue, Green, Yellow" to a WhatsApp group, and participants can respond by selecting their preferred choice.
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) to which the poll will be sent. |
| Poll Question | The question text that will appear at the top of the poll (e.g., "What's your favorite color?"). |
| Poll Options | Comma-separated list of options that recipients can choose from (e.g., "Red,Blue,Green,Yellow"). |
| Additional Options | Collection of optional settings including: |
| - Message ID | Custom message identifier; if not provided, it is auto-generated. |
| - Presence Simulation | Simulate typing or recording indicator for a specified duration (0-30000 ms). |
| - Message Duration | Duration in seconds for disappearing messages (No Expiration, 24 Hours, 7 Days, 90 Days). |
| - Context Information | Context metadata for replies, forwards, mentions, including forwarded flag, mention all, mentioned users, participant, and reply-to message ID. |
Output
The node outputs a JSON object containing the API response data related to the poll message sent. This typically includes confirmation details such as message IDs, status, and any relevant metadata returned by the WhatsApp API.
If the operation is used as a tool with optimization enabled, the output may be truncated or structured to reduce token usage for AI processing.
No binary data is produced by the "Send Poll" operation.
Dependencies
- Requires an active connection to the ZuckZapGo API service.
- Requires an API key credential configured in n8n for authentication with ZuckZapGo.
- The node uses HTTP requests to communicate with the ZuckZapGo backend endpoints.
Troubleshooting
- Missing or invalid recipient: Ensure the "Recipient" field contains a valid phone number or group/newsletter/LID identifier in the correct format.
- Empty poll question or options: Both the poll question and options are required; leaving them empty will cause errors.
- Invalid poll options format: Options must be a comma-separated string; improper formatting may lead to unexpected behavior.
- API request failures: Network issues or invalid API credentials will result in errors. Verify API key validity and network connectivity.
- Binary property not found: Not applicable for this operation but common in media sending operations; ensure binary data exists when required.
- Context information misuse: Incorrectly formatted context info (mentions, replies) may cause the message to fail or behave unexpectedly.
Links and References
- ZuckZapGo GitHub Repository – Official source and documentation for the ZuckZapGo API.
- WhatsApp Business API documentation (general reference for message types and capabilities).
This summary focuses exclusively on the "Send Poll" operation of the ZuckZapGo AI node as requested.