Wassenger icon

Wassenger

Interact with Wassenger WhatsApp API
Join our community

Actions148

Overview

This node integrates with the Wassenger WhatsApp API to send votes in a poll message within WhatsApp chats. It allows users to programmatically cast votes on existing polls by specifying the poll message and the options to vote for. This is useful in automating interactions with WhatsApp polls, such as gathering user feedback or conducting surveys via chatbots or automated workflows.

Practical scenarios include:

  • Automatically voting on behalf of users in WhatsApp group polls.
  • Integrating poll voting into customer service automation.
  • Collecting responses from multiple WhatsApp contacts without manual intervention.

Properties

Name Meaning
WhatsApp number The target Wassenger Number ID used to send the vote message. This identifies the WhatsApp account/device sending the vote.
Target Type of target chat where the vote will be sent: Phone (individual), Group, or 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 WhatsApp channel (e.g., 12345678902402200@newsletter). Required if Target is "Channel".
Poll Message ID The unique identifier of the poll message to vote on. Must be a hexadecimal string between 18 and 32 characters.
Vote Options The options to vote for in the poll. Multiple options can be specified (up to 12). Each option can be identified either by its numeric ID (0-11) or by the exact text of the option. Leave empty to remove all votes.
Options Additional message options including:
- Priority (Normal, High, Low)
- Label (custom categorization label)
- Reference ID (custom reference)
- Team Agent (send on behalf of an agent)
- Live mode (real-time send)
- Delivery queue mode (default, always queue, never queue, opportunistic)
- Maximum retries
- Chat actions after delivery (assign, resolve, mark read/unread, add/remove/set labels or metadata)
- Message expiration (TTL) settings
- Mark chat as read acknowledgment
- Typing simulation duration before sending
- Quote message ID to reply to
- Strict message order enforcement

Output

The node outputs JSON data representing the result of the vote submission operation. This typically includes confirmation details about the vote sent, status messages, or error information if the operation failed.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Wassenger WhatsApp API integration with a valid API key credential configured in n8n.
  • Dependent on the availability of the Wassenger service endpoints for sending messages and managing polls.
  • Some properties load dynamic options (e.g., devices, groups, channels, team agents, labels) which require proper API access and permissions.

Troubleshooting

  • Invalid Poll Message ID: Ensure the poll message ID is a valid hexadecimal string of length 18, 20, 24, or 32 characters.
  • Invalid Phone Number Format: Phone numbers must follow the E.164 international format (e.g., +1234567890).
  • Missing Required Fields: Device, target type, and corresponding target identifiers (phone, group ID, or channel ID) are mandatory.
  • Vote Option Identification: When specifying vote options, ensure that either the option ID (0-11) or exact option text matches the poll options exactly.
  • Delivery Mode Conflicts: Using real-time delivery modes ("live" or "never queue") at high message rates may increase the risk of WhatsApp bans.
  • Agent and Department IDs: If assigning chats to agents or departments post-message, ensure IDs are valid 24-character hexadecimal strings.
  • Message Quoting: Quoted message IDs must belong to the same conversation.
  • Strict Order Mode: Not compatible with live or never queue delivery modes; using them together may cause errors.

Links and References

Discussion