add_poll_to_session
ChatGPTAdd another poll to an EXISTING CrowdHum session by its room code (e.g. "add a sentiment poll to room XKCD") — CrowdHum's one-QR-many-polls model. The new poll shares the same room code and links. You must own the session. Adding to a session that already has a live poll does NOT switch the screen — the presenter activates it when ready. Same poll fields as create_poll.
create_poll
ChatGPTCreate a CrowdHum poll in a NEW session + room code that voters can immediately use. Returns the room code plus the voter and presenter URLs. To add another poll to an EXISTING room instead, use add_poll_to_session. Call list_visualizations first to choose visualization.mode. Choice-based modes (column-drift, rising-bubbles, ranking) need 2-6 choices; word-cloud, grid-2x2, and qa (Q&A) need none. For qa you may optionally pass qaSettings { moderation: 'auto'|'pending', upvoting: 'on'|'off' } (defaults: auto + on). IMPORTANT: title, choices, and visualization are all TOP-LEVEL parameters — do NOT nest choices or title inside visualization. Example for a choice-based poll: { "title": "How did you get here?", "visualization": { "mode": "rising-bubbles" }, "choices": [ { "id": 1, "label": "Bike" }, { "id": 2, "label": "Walked" } ] } Example for word-cloud (no choices): { "title": "One word for this team", "visualization": { "mode": "word-cloud" } } Do NOT pass a room code here — create_poll ALWAYS makes a new room. To add a poll to an EXISTING room, use add_poll_to_session instead.
get_poll_results
ChatGPTGet vote results for a poll in a room (by room code). Returns the recorded vote count and a per-option tally. By default it reads the ACTIVE poll; pass poll (a 1-based number matching the order shown by get_session) to read a specific poll. For an ENDED run it shows the final frozen results; for a still-LIVE run it aggregates the current votes (choice totals, 2D quadrant counts, Borda ranking points, or grouped word responses). For a Q&A poll it returns the question count, total upvotes, answered count, and the top questions by upvote. You must own the session.
get_room_links
ChatGPTReturn the voter and presenter URLs for an existing room code. The voter URL is what the room's QR code encodes; the QR image itself is rendered on the presenter screen, not returned here.
get_session
ChatGPTShow a session (event) and the polls in it, by room code — title, live/idle, voter/presenter links, and each poll's title, mode, and recorded vote count. Use this to see what's in a room before adding polls.
get_session_recap
ChatGPTFetch the AI-generated recap for a session (by room code), if one has been generated, with the per-poll insight summary. Fetch-only — it does not generate a recap. You must own the session.
invite_co_owner
ChatGPTGrant co-ownership of a session (by room code) to another CrowdHum user by email, so they can co-edit and co-present it. You must OWN the session (co-owners cannot invite further co-owners). The invitee must already have a CrowdHum Pro account; they are notified by email. Idempotent — re-inviting an existing co-owner is a no-op.
list_my_polls
ChatGPTList the polls you own, newest first — with visualization mode, room code, and title.
list_my_sessions
ChatGPTList the CrowdHum sessions (events) you own, newest first — room code, title, whether it's currently live, poll count, and recap status. Use this to find a session by name (e.g. 'my Copenhagen session') and get its room code for add_poll_to_session, get_session, or get_session_recap.
list_visualizations
ChatGPTList CrowdHum's visualization modes with guidance on when to use each (bestFor, ideal choice count, example questions, anti-patterns). Call this before create_poll to choose visualization.mode.
