---
name: webask-results-digest
description: Объясняет, что показал опрос в WebAsk: собирает сводку, срезы и
  выгрузки и превращает их в выводы. Применяется, когда человек спрашивает про
  итоги опроса, просит показать результаты, сравнить периоды или подготовить
  цифры для отчёта.
---

# Что показал опрос

Человек спрашивает «ну и что там по опросу». Ответ — не выгрузка сырых ответов, а
несколько цифр с объяснением, что они значат.

Отвечай человеку на том языке, на котором он пишет.

## Что чем брать

Здесь чаще всего берут не тот инструмент. Разница такая:

| Что нужно | Инструмент | Что вернёт |
|---|---|---|
| Общая картина по всем вопросам | `get_quiz_summary` | распределения ответов, готовые проценты |
| Срез с фильтрами | `get_quiz_report` | то же, но по отобранным ответам |
| Отдельные прохождения | `get_quiz_answers` | сырые ответы, по одному |
| Свободные тексты одного вопроса | `get_quiz_report_inputs` | все текстовые ответы вопроса |
| Файл для человека | `export_answers_xlsx` и другие `export_*` | ссылку на скачивание |

**Начинать со сводки, а не с ответов.** Сырые ответы нужны, когда спрашивают про
конкретное прохождение или когда надо посмотреть примеры формулировок.

## Порядок

1. `get_quiz_summary` — общая картина: сколько прохождений, распределения.
2. Понять, полные ли это данные: сколько дошло до конца, сколько брошено. Если
   брошенных много — сказать об этом, выводы по ним считать отдельно.
3. Если человек назвал условие — «только за сентябрь», «только те, кто из
   рассылки» — собрать срез через `get_quiz_report` с фильтрами. Значения меток
   ссылки для отбора берутся из `get_answer_extra_field_values`.
4. Выгрузку делать, только если человек просит файл. Ссылка живёт час.

## Как отвечать

- **Сначала вывод, потом цифры.** Не «в вопросе 3 распределение такое-то», а «две
  трети недовольны сроками — вот распределение».
- **Проценты от чего.** Всегда указывать базу: от всех прохождений или только от
  завершённых.
- **Не выдавать выводы по десяти ответам за факт.** Если данных мало, сказать об
  этом прямо.
- **Свободные тексты не пересказывать по одному** — сгруппировать по темам и
  привести пару характерных цитат.

## Чего не делать

- **Не выгружать файл без просьбы** — в чате нужны цифры, а не ссылка на XLSX.
- **Не считать вручную то, что уже посчитано** в сводке.
- **Не смешивать завершённые и брошенные** в одной цифре без оговорки.
- **Не предлагать смену тарифа и не вести на оплату.** Если упёрлись в лимит —
  назвать факт и остановиться.