Zalo Poll icon

Zalo Poll

Quản bình chọn Zalo
Join our community

Actions3

Overview

This node enables creating and managing polls within Zalo groups. It is particularly useful for gathering opinions, making group decisions, or conducting quick surveys in Zalo chat groups. For example, a team leader can create a poll to decide on meeting times or project priorities, allowing members to vote directly in the group chat.

The "Tạo bình chọn" (Create Poll) operation lets you specify the poll question, options, voting rules, and additional settings such as anonymity and result visibility.

Properties

Name Meaning
ID Nhóm The ID of the Zalo group where the poll will be created (only works with groups).
Chủ đề bình chọn The poll question or topic that participants will vote on.
Kiểu nhập lựa chọn How to input poll options: either as a list of separate entries ("Danh sách") or a single text field with comma-separated options ("Văn bản").
Các lựa chọn (list) When using list input type, add multiple individual options for the poll.
Các lựa chọn (text) When using text input type, enter all options separated by commas in one field.
Thời hạn bình chọn Optional expiration date/time for the poll; leave empty if no expiration is desired.
Ghim lên đầu trò chuyện Whether to pin the poll message at the top of the chat.
Chọn nhiều phương án Allow participants to select multiple options when voting.
Có thể thêm phương án Allow participants to add new options to the poll.
Ẩn kết quả khi chưa bình chọn Hide poll results from participants until they have voted.
Ẩn người bình chọn Make votes anonymous so participants cannot see who voted for which option.

Output

The node outputs JSON data containing:

  • success: Boolean indicating if the poll creation was successful.
  • response: The raw response object returned by the Zalo API after creating the poll.
  • groupId: The ID of the group where the poll was created.
  • createPollData: An object summarizing the poll parameters used for creation (question, options, settings).

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential to authenticate with the Zalo platform.
  • Uses the Zalo API client library (zca-js) internally to perform operations.
  • The node expects valid credentials including cookie, IMEI, and user agent information for authentication.
  • Proper configuration of these credentials in n8n is necessary for the node to function.

Troubleshooting

  • Missing or invalid credentials: The node throws an error if it cannot initialize the Zalo API client due to missing or incorrect authentication details. Ensure your API key credential is correctly set up with valid cookie, IMEI, and user agent values.
  • Empty poll options: If no poll options are provided, the node will throw an error requesting at least one option. Verify that options are entered correctly according to the selected input type.
  • API errors: Any errors returned by the Zalo API during poll creation will be surfaced. Check the error messages for details and verify that the group ID and other parameters are correct.
  • Continue on Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.

Links and References

Discussion