---
name: polls
description: Custom polls with buttons, live vote counts, and duplicate vote prevention. Use when asked for polls, voting, or surveys.
category: engagement
version: 1
platforms: [discord, telegram]
author: adraalabs
---

## Setup

Create `/poll` with options: question (string, required), option1-option4 (strings).

The command:
1. Build buttons from the provided options, each with unique ID like "poll_{random}_opt1"
2. `send_interactive` with embed: title=question, description lists options, color="#5865F2"
3. For each button, `put` key:"interaction:poll_{id}_optN" value:{unique_per_user:true, steps:[{tool:"increment_data", args:{key:"poll_vote:{message_id}:optN"}}, ...], update_source:{description with updated counts}}

## Key patterns

- `unique_per_user: true` prevents double voting — one click per user per button
- `update_source` updates the poll embed after each vote with new counts
- Each option has its own counter: "poll_vote:{message_id}:opt1", "poll_vote:{message_id}:opt2"
- Use {incremented_value} for the count of the option that was just voted

## Key rules

- unique_per_user is critical — without it users can vote unlimited times
- update_source reads from the data store to show all current counts, not just the one that changed
- Button IDs must be unique per poll — include a random component
- The poll embed is the single source of truth — update_source keeps it current