Read results

room_results answers with the session’s numbers, one snapshot per poll in deck order, and the same results as markdown.

The session

Field	Meaning
`title`	The deck’s name.
`status`	`lobby`, `presenting` or `ended`.
`joined`	How many people joined.
`pollCount`	Polls in the deck.
`avgResponseRate`	Answers over people joined, averaged over the polls, 0 to 1.
`liveMinutes`	How long the session ran.
`endedMinutesAgo`	When it ended, if it did.

Per poll

Every snapshot carries type, prompt, status (pending, live or final) and totalAnswers. The rest depends on how the widget takes answers.

Widgets	What the snapshot holds
Multiple choice, image choice, this or that, ranking	`options` with an `id` and `label`, and `counts` by option id. Ranking counts are Borda points.
A quiz, which is multiple choice with a `correctIndex`	`correctOptionId` once it closes, and `leaderboard` with the top ten’s `nickname`, `score` and, for anyone who changed place since the last question counted, `move` as `up` or `down`.
A quiz standings board, `quizView` set to `standings`	No options and no answers of its own. The same top-ten `leaderboard`, and `quizRound` with how many of the deck’s quiz questions have closed, `done` of `total`.
100 points	`counts` are the average points per person for each option, rounded.
Star rating, NPS, estimate	`average`, and `distribution` by bucket. Estimate adds `estimateAnswer` once final.
Radar	`dimensions` and `radar`, the room’s average per axis.
Word cloud, live map	`words` with `text` and `count`.
Open feed	`texts`, newest last.
Q&A	`qa` with `text` and `votes`, sorted by votes.
Spin the wheel	`winner`.
Place map	`pins`, one per person.

Every answer, with a name

deck_results with answers adds one row per person per poll to each session, the rows the app’s spreadsheet download holds.

Field	Meaning
`question`	The poll’s place in the session, from 1.
`prompt`, `type`	The question as asked, and the widget; `Quiz` for a multiple choice with an answer.
`name`	The name the person joined under. A session started with `askName` holds the names people typed themselves.
`answer`	A number for a star rating, NPS or estimate. Otherwise text: the options picked, a ranking in order, points per option, a score per radar axis, or what was typed.
`correct`	For a quiz question, whether the answer was right; `null` otherwise.
`answeredAt`, `seconds`	When the answer came in, and how long the poll had been open by then.

The markdown

markdown is the same results as a summary, one section per poll, ready to paste into a mail or a report:

# Town hall

Room 491026. 42 joined. 4 polls. Live for 38 minutes.

## Which one?

Multiple choice. 34 answered.

- A: 12 (35%)
- B: 18 (53%)
- C: 4 (12%)

A session started with a label carries its name in the heading, as in # Town hall · Class 3B, Tuesday, so the summaries of one deck presented to several groups stay apart. A quiz marks its answer and adds the standings. An open feed lists its answers; a word cloud or a live map lists its counts. An agent that reads the results can write the follow-up. That is usually the next thing the presenter asks it for.

Results are saved each time a poll closes and when the room ends, so room_results still answers once the app no longer holds the room, a restart included. Those saved results come back with status ended, as they stood when a poll last closed.

Get started

Concepts

Guides

Reference

The session

Per poll

Every answer, with a name

The markdown

​The session

​Per poll

​Every answer, with a name

​The markdown

The session

Per poll

Every answer, with a name

The markdown