Webask Results Sharing

---
name: webask-results-sharing
description: "Готовит результаты опроса WebAsk для передачи другому человеку — публичную ссылку на отчёт, сводку или ответы, PDF или Word, умный отчёт с выводами. Применяется, когда человек просит прислать результаты заказчику, поделиться отчётом с коллегой, выгрузить итоги или собрать отчёт с выводами."
---

# Отдать результаты

Результаты опроса смотрят не только те, кто его делал. Заказчику, руководителю или
коллеге нужен не доступ в аккаунт, а готовая вещь: ссылка или файл.

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

## Сначала спросить, что именно нужно

Три разных вещи, и путать их дорого:

| Что просят | Что отдать | Инструмент |
|---|---|---|
| «Покажи итоги», цифры по вопросам | сводку | `share_summary_link`, `export_summary_pdf` |
| Отчёт с разрезами, по периоду или фильтру | отчёт | `share_report_link`, `export_filtered_report_pdf`, `export_filtered_report_word` |
| Отдельные прохождения, кто что ответил | ответы | `share_answers_link`, `export_answers_xlsx` |
| Текст с выводами, а не таблицы | умный отчёт | `generate_ai_report`, `get_ai_report`, `share_ai_report` |

Если из просьбы не ясно — уточнить одним вопросом. Опрос, если назван словами,
найти через `get_quiz_list`.

## Ссылка или файл

**Ссылка** живёт, пока её не отзовут, и всегда показывает свежие данные — годится,
когда результаты ещё собираются и заказчик будет заходить не раз.

**Файл** фиксирует состояние на момент выгрузки — годится для отчёта «на дату» или
когда получатель не должен видеть, что придёт позже. Ссылки на скачивание файлов
живут час: сказать об этом человеку.

## Что проверить перед тем, как отдать наружу

1. **Нет ли в опросе контактов.** `get_quiz_structure` — если есть телефон, почта
   или имя, публичная ссылка на *ответы* отдаст их всем, у кого она окажется.
   Предложить сводку или отчёт вместо ответов, а если нужны именно ответы —
   спросить, точно ли наружу.
2. **Период и состав.** Отчёт и ответы принимают отбор по датам и по статусу
   прохождения (`is_complete`). Спросить, нужны ли брошенные прохождения: обычно
   заказчику — нет.
3. **Сохранённый фильтр.** Если у отчёта уже есть настроенный срез
   (`get_quiz_report_filters`), отдавать его, а не собирать заново.

## Умный отчёт

`generate_ai_report` строит текстовый разбор: количественный, сравнительный и
анализ свободных ответов — все три или один раздел (`section`). Готовится не
мгновенно; забрать готовый — `get_ai_report`, отдать наружу — `share_ai_report`
ссылкой или PDF.

Не строить умный отчёт на десятке ответов: выводы будут выглядеть уверенно, а
опираться ни на что. Сказать, что данных мало.

## Что сказать в конце

Что именно отдано (сводка, отчёт, ответы), за какой период, с какими фильтрами,
живёт ли ссылка постоянно или час. Если отдавали ответы с контактами — напомнить,
что ссылка публичная.

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

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