Actions22
- Get Actions
- Message Actions
- Friend Actions
- Group Actions
- Tool Actions
Overview
This node operation allows users to create a poll within a specified group on the Zalo platform. It is useful for gathering opinions, making decisions, or conducting surveys among group members. Typical scenarios include team decision-making, event planning, or collecting feedback in community groups.
For example, a project manager can create a poll asking team members to vote on preferred meeting times, or a community admin can survey members about upcoming activities.
Properties
| Name | Meaning |
|---|---|
| Group Id | The unique identifier of the Zalo group where the poll will be created. |
| Poll Question | The question or topic of the poll. |
| Poll Options | Comma-separated list of choices available for voting in the poll. |
| Poll Expired Time (ms) | Duration in milliseconds after which the poll expires; 0 means no expiration. |
| Allow Multiple Choices | Boolean flag to allow voters to select more than one option. |
| Allow Add New Option | Boolean flag to permit group members to add new options to the poll. |
| Hide Vote Preview | Boolean flag to hide poll results until the user has voted. |
| Anonymous Poll | Boolean flag to keep voters' identities anonymous. |
| Pin Poll | Boolean flag to pin the poll message within the group for visibility. |
Output
The node outputs an array of JSON objects representing the result of the poll creation request. Each object contains at least:
- A success indicator (
successboolean). - Details of the created poll such as poll ID, question, options, and settings.
- Error information if the poll creation failed.
No binary data output is involved.
Dependencies
- Requires an API key credential for authenticating with the Zalo API.
- The node depends on the Zalo messaging API to create polls in groups.
- Proper network connectivity to Zalo's servers is necessary.
- No additional external services are required.
Troubleshooting
- Invalid Group Id: If the provided group ID does not exist or the authenticated user lacks permission, the poll creation will fail. Verify the group ID and permissions.
- Malformed Poll Options: The poll options must be a comma-separated string. Ensure no empty options or invalid characters.
- API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Check that the API key is correctly configured.
- Timeouts or Network Issues: Network problems may prevent communication with Zalo servers. Retry or check connectivity.
- Poll Expiration Misconfiguration: Setting an invalid expiration time (negative values) might cause errors. Use zero or positive integers only.
Common error messages typically include HTTP status codes and descriptive messages from the Zalo API, indicating issues like unauthorized access, bad requests, or server errors.
Links and References
Note: Internal credential names and implementation details have been omitted to comply with security guidelines.