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 → Delete votes in a poll
AI-generatedOverview
This node interacts with the WaliChat WhatsApp API to manage messages, specifically supporting operations related to sending and managing WhatsApp messages. The "Delete votes in a poll" operation under the "Send messages" resource allows users to remove votes from a specific poll message within a WhatsApp chat.
Common scenarios for this operation include:
- Moderating polls by removing inappropriate or mistaken votes.
- Managing interactive polls in group chats or channels where vote corrections are needed.
- Automating poll management workflows in customer engagement or community groups.
Practical example:
- A user runs this node to delete a vote from a poll message identified by its unique poll message ID in a group chat, ensuring the poll results reflect accurate participation.
Properties
| Name | Meaning |
|---|---|
| WhatsApp number | The target WaliChat Number ID used for message delivery. This identifies which WhatsApp number/account will send the request. |
| Target | Type of target chat: Phone (individual), Group, or Channel. Determines where the poll vote deletion applies. |
| 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 from which votes should be removed. Must be 18 to 32 hexadecimal characters. |
| Options | Collection of optional settings including: - Priority (Normal, High, Low) - Label (custom categorization label) - Reference ID (custom reference for the message) - Team Agent (send on behalf of an agent) - Live mode (real-time delivery without queue) - Delivery Queue Mode (default, always queue, never queue, opportunistic) - Maximum Retries (number of delivery retries) - Chat Actions (post-delivery actions like assign, resolve, add/remove 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 will be marked as read after this operation (blue double-check). |
| Typing simulation | Number of seconds (0-30) to simulate typing or recording status before delivery. |
| Quote Message | Message ID to quote when sending the message (must be in the same conversation). |
| Strict Message Order | Boolean to ensure messages are sent in strict order, useful for chatbots or sequences. Not compatible with live mode or never queue delivery. |
Output
The node outputs JSON data representing the result of the delete poll vote operation. This typically includes confirmation of success or details about the deleted votes. The exact structure depends on the WaliChat API response but generally contains fields indicating the status of the operation.
No binary data output is expected for this operation.
Dependencies
- Requires an active WaliChat WhatsApp API account with a valid API key credential configured in n8n.
- The node depends on the WaliChat API endpoints for message and poll management.
- Proper permissions and access to the specified WhatsApp number/device are necessary.
- For loading options such as devices, groups, channels, agents, labels, and departments, the node uses dynamic option loading methods connected to the WaliChat API.
Troubleshooting
- Invalid Poll Message ID: Ensure the poll message ID is a valid hexadecimal string between 18 and 32 characters. Errors here indicate incorrect or malformed IDs.
- Target Mismatch: If the target type (phone, group, channel) does not match the provided ID or number, the operation may fail. Verify the correct target and corresponding identifier.
- Permission Denied: Lack of permission for the selected WhatsApp number or agent can cause failures. Confirm API credentials and device access rights.
- Rate Limits and Delivery Modes: Using real-time delivery modes ("live" or "never queue") with high message volumes may lead to temporary bans or throttling by WhatsApp. Use queue modes appropriately.
- Network or API Errors: Transient network issues or API downtime can cause errors. Implement retry logic and check API status.
- Incorrect Metadata or Labels: When using chat actions involving metadata or labels, ensure keys and values conform to allowed formats and exist in the system.
Links and References
- WaliChat Official Documentation (for API details and usage)
- WhatsApp Business API Guidelines
- E.164 Phone Number Formatting
This summary covers the static analysis of the "Delete votes in a poll" operation within the "Send messages" resource of the WaliChat node for n8n.