WaliChat icon

WaliChat

Interact with WaliChat WhatsApp API

Actions148

Send messages → Send votes in a poll

AI-generated

Overview

This node enables sending votes in a poll message via WhatsApp using the WaliChat API. It is designed to interact with existing poll messages by submitting user votes programmatically. This functionality is useful for automating responses in group chats, channels, or direct phone conversations where polls are used to gather opinions or make decisions.

Common scenarios:

  • Automatically casting votes on behalf of users in WhatsApp polls.
  • Integrating poll voting into workflows that analyze poll results or trigger actions based on votes.
  • Managing poll participation in large groups or channels without manual intervention.

Practical example:
A customer support team uses WhatsApp polls to decide on preferred meeting times. This node can automatically submit votes collected from an external scheduling system, ensuring the poll reflects all participants' preferences without manual input.

Properties

Name Meaning
WhatsApp number The target WaliChat Number ID used to send the vote message. This identifies which WhatsApp number/account will deliver the vote.
Target Type of chat to send the vote to. Options: Phone (individual contact), 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 group chat (e.g., 12345678902401234@g.us). Required if Target is Group.
Channel ID The ID of the target 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 One or more options to vote for in the poll. Each option can be specified either by its numeric ID (0-11) or by the exact text of the poll option. Leaving this empty removes all votes.
Options Additional message options including:
- Priority (Normal, High, Low)
- Custom label to categorize the message
- Reference ID for tracking
- Agent on whose behalf the message is sent
- Real-time sending mode toggle
- Delivery queue mode (default, always queue, never queue, opportunistic)
- Maximum retries for delivery
- Post-delivery chat actions (assign, resolve, add/remove labels, set metadata, etc.)
Message Expiration Defines time-to-live (TTL) for the message. Can specify expiration in seconds, duration (e.g., "1h"), or at a specific date/time.
Mark Chat as Read Whether to notify WhatsApp that previous unread messages in the chat should be marked as read after sending the vote (blue double-check).
Typing simulation Seconds to simulate typing or recording status before sending the vote (0 disables). Range: 2-30 seconds.
Quote Message Message ID to quote when sending the vote, allowing the vote message to reference another message in the same conversation.
Strict Message Order Ensures messages are sent in strict order to the chat. Useful for chatbots or sequences but incompatible with real-time or never queue delivery modes.

Output

The node outputs JSON data representing the result of the vote submission operation. This typically includes confirmation details such as message IDs, status codes, or error messages if the vote could not be submitted.

If binary data were involved (not applicable here), it would represent media content or files related to the message.

Dependencies

  • Requires a valid API key credential for authenticating with the WaliChat WhatsApp API.
  • The node depends on the WaliChat service being accessible and properly configured.
  • Some properties load dynamic options (e.g., devices, groups, channels, agents, labels) via API calls, so proper permissions and connectivity are necessary.
  • No additional environment variables are explicitly required beyond the API key credential.

Troubleshooting

  • Invalid Poll Message ID: If the poll message ID does not match the required hexadecimal format or length, the node will throw a validation error. Ensure the ID is correct and matches the poll message you intend to vote on.
  • Invalid Phone Number Format: Phone numbers must be in E.164 format (e.g., +1234567890). Incorrect formatting will cause validation errors.
  • Missing Required Fields: Omitting required fields like device ID, target chat ID, or vote options will cause the node to fail.
  • Delivery Failures: Using real-time delivery mode (live or never queue) for high-volume messaging may increase the risk of WhatsApp bans or message loss. Use queue modes appropriately.
  • Agent or Department IDs: When assigning chat actions post-delivery, agent and department IDs must be valid 24-character hexadecimal strings.
  • Typing Simulation Limits: Typing simulation must be between 2 and 30 seconds; otherwise, it will be ignored or cause errors.
  • Strict Message Order Conflicts: Enabling strict message order is incompatible with live mode or never queue delivery options and may cause errors.

To resolve issues:

  • Double-check all input parameters against their expected formats.
  • Use the default queue mode for bulk or frequent messaging.
  • Validate IDs and references carefully.
  • Review API key permissions and network connectivity.

Links and References

Discussion