Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Send messages → Send poll message
AI-generatedOverview
This node allows sending poll messages via WhatsApp using the WaliChat API. It is designed to create interactive polls within WhatsApp chats, enabling users to gather opinions or votes from recipients directly in their conversations.
Common scenarios where this node is beneficial include:
- Conducting quick surveys or feedback polls with customers or team members.
- Engaging WhatsApp groups or channels by asking questions and collecting responses.
- Running informal voting sessions for decision-making within chat communities.
Practical example:
- A business wants to ask customers which new product feature they prefer. Using this node, it sends a poll message with multiple options to a customer’s WhatsApp number or group chat, collects votes, and processes results downstream.
Properties
| Name | Meaning |
|---|---|
| WhatsApp number | The target WaliChat Number ID used to send the poll message. This identifies the WhatsApp account/device that will deliver the message. |
| Target | Type of target chat: Phone (individual phone number), Group (WhatsApp group chat), or Channel (broadcast channel). |
| Phone Number | The recipient's phone number in international E.164 format (e.g., +1234567890). Required if Target is Phone. |
| Group ID | The ID of the target WhatsApp group chat (e.g., 12345678902401234@g.us). Required if Target is Group. |
| Channel ID | The ID of the target broadcast channel (e.g., 12345678902402200@newsletter). Required if Target is Channel. |
| Poll Question | The question or title text for the poll message. |
| Poll Options | The list of poll options (minimum 2, maximum 10). Each option is a string representing one choice in the poll. |
| Options | Additional optional settings for the message delivery and behavior: - Priority: Normal, High, Low - Label: Custom label to categorize the message - Reference ID: Custom reference for tracking - Team Agent: Optionally send on behalf of an agent - Live mode: Send immediately without queue (riskier) - Delivery Queue Mode: Controls queuing strategy (default, always queue, never queue, opportunistic) - Maximum Retries: Number of retry attempts for delivery - Chat Actions: Post-delivery actions like assigning chat, resolving, adding/removing labels or metadata |
| Message Expiration | Defines time-to-live (TTL) for the message with options to expire after seconds, duration (e.g., "1h"), or at a specific date/time. |
| Mark Chat as Read | Boolean to notify WhatsApp that previous unread messages are read after sending this message (blue double-check). Requires WhatsApp read confirmation enabled. |
| Typing simulation | Number of seconds (0-30) to simulate typing or recording status before sending the message. Useful for more natural interaction. |
| Quote Message | Message ID to quote when sending the poll message, allowing referencing a previous message in the same conversation. |
| Strict Message Order | Boolean to ensure messages are sent in strict order to the chat. Useful for chatbots or sequences but incompatible with live mode or never queue delivery. |
Output
The node outputs JSON data representing the result of the poll message sending operation. This typically includes details such as message IDs, status, and any metadata returned by the WaliChat API confirming successful delivery or errors.
No binary data output is expected from this operation.
Dependencies
- Requires an API key credential for authenticating with the WaliChat WhatsApp API.
- The node depends on WaliChat services for sending messages, managing devices, groups, channels, agents, labels, and chat actions.
- Proper configuration of the WaliChat API key credential in n8n is necessary.
- The node uses dynamic loading methods to fetch available devices, groups, channels, labels, team agents, and departments based on the selected device.
Troubleshooting
- Invalid phone number format: If the phone number does not match the E.164 format (e.g., missing "+" or country code), the node will throw a validation error. Ensure numbers are correctly formatted.
- Missing required fields: Omitting required properties like Poll Question or Poll Options will cause errors. Make sure all mandatory inputs are provided.
- Exceeding poll options limits: The poll must have between 2 and 10 options. Adding fewer or more will result in validation failure.
- Delivery failures: Messages may fail due to network issues, invalid device IDs, or WhatsApp restrictions. Use the retry and queue options to manage delivery robustness.
- Live mode risks: Sending many messages in real-time mode without queuing can increase the risk of WhatsApp bans. Use queue modes appropriately.
- Action misconfiguration: When specifying chat actions post-delivery, ensure required fields like Agent ID or Department ID are valid and properly formatted.
- Quote message errors: Quoting a message ID that does not exist in the same conversation or has invalid length/format will cause errors.