bot/docs/automation/poll.md at fix/default-provider-hanzo

mirror of https://github.com/hanzoai/bot.git synced 2026-10-30 17:24:26 +00:00

Files

T

zeekay 4bdc9ee3e4 chore: rebrand openclaw → hanzo-bot for bridge merge

Comprehensive rename of all openclaw references to hanzo-bot equivalents:
- Package: openclaw → @hanzo/bot
- Binary: openclaw → hanzo-bot
- Types: OpenClaw* → Bot*
- Env vars: OPENCLAW_* → BOT_*
- Android: ai.openclaw.android → ai.hanzo.bot.android
- iOS/macOS: ai.openclaw.* → ai.hanzo.*
- Swift modules: OpenClaw* → Bot*
- Plugins: openclaw.plugin.json → bot.plugin.json
- Paths: .openclaw/ → .hanzo/bot/
- URLs: github.com/openclaw → github.com/hanzoai

2026-02-26 22:36:01 -08:00

2.3 KiB

Raw Permalink Blame History

summary, read_when, title

summary

read_when

title

Poll sending via gateway + CLI

Adding or modifying poll support

Debugging poll sends from the CLI or gateway

Polls

Supported channels

WhatsApp (web channel)
Discord
MS Teams (Adaptive Cards)

CLI

# WhatsApp
hanzo-bot message poll --target +15555550123 \
  --poll-question "Lunch today?" --poll-option "Yes" --poll-option "No" --poll-option "Maybe"
hanzo-bot message poll --target [email protected] \
  --poll-question "Meeting time?" --poll-option "10am" --poll-option "2pm" --poll-option "4pm" --poll-multi

# Discord
hanzo-bot message poll --channel discord --target channel:123456789 \
  --poll-question "Snack?" --poll-option "Pizza" --poll-option "Sushi"
hanzo-bot message poll --channel discord --target channel:123456789 \
  --poll-question "Plan?" --poll-option "A" --poll-option "B" --poll-duration-hours 48

# MS Teams
hanzo-bot message poll --channel msteams --target conversation:19:[email protected] \
  --poll-question "Lunch?" --poll-option "Pizza" --poll-option "Sushi"

Options:

--channel: whatsapp (default), discord, or msteams
--poll-multi: allow selecting multiple options
--poll-duration-hours: Discord-only (defaults to 24 when omitted)

Gateway RPC

Method: poll

Params:

to (string, required)
question (string, required)
options (string[], required)
maxSelections (number, optional)
durationHours (number, optional)
channel (string, optional, default: whatsapp)
idempotencyKey (string, required)

Channel differences

WhatsApp: 2-12 options, maxSelections must be within option count, ignores durationHours.
Discord: 2-10 options, durationHours clamped to 1-768 hours (default 24). maxSelections > 1 enables multi-select; Discord does not support a strict selection count.
MS Teams: Adaptive Card polls (Hanzo Bot-managed). No native poll API; durationHours is ignored.

Agent tool (Message)

Use the message tool with poll action (to, pollQuestion, pollOption, optional pollMulti, pollDurationHours, channel).

Note: Discord has no “pick exactly N” mode; pollMulti maps to multi-select. Teams polls are rendered as Adaptive Cards and require the gateway to stay online to record votes in ~/.hanzo/bot/msteams-polls.json.

2.3 KiB Raw Permalink Blame History