webask-results-sharing
Готовит результаты опроса 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.
Ссылка или файл
Ссылка живёт, пока её не отзовут, и всегда показывает свежие данные — годится, когда результаты ещё собираются и заказчик будет заходить не раз.
Файл фиксирует состояние на момент выгрузки — годится для отчёта «на дату» или когда получатель не должен видеть, что придёт позже. Ссылки на скачивание файлов живут час: сказать об этом человеку.
Что проверить перед тем, как отдать наружу
- Нет ли в опросе контактов.
get_quiz_structure— если есть телефон, почта или имя, публичная ссылка на ответы отдаст их всем, у кого она окажется. Предложить сводку или отчёт вместо ответов, а если нужны именно ответы — спросить, точно ли наружу. - Период и состав. Отчёт и ответы принимают отбор по датам и по статусу
прохождения (
is_complete). Спросить, нужны ли брошенные прохождения: обычно заказчику — нет. - Сохранённый фильтр. Если у отчёта уже есть настроенный срез
(
get_quiz_report_filters), отдавать его, а не собирать заново.
Умный отчёт
generate_ai_report строит текстовый разбор: количественный, сравнительный и
анализ свободных ответов — все три или один раздел (section). Готовится не
мгновенно; забрать готовый — get_ai_report, отдать наружу — share_ai_report
ссылкой или PDF.
Не строить умный отчёт на десятке ответов: выводы будут выглядеть уверенно, а опираться ни на что. Сказать, что данных мало.
Что сказать в конце
Что именно отдано (сводка, отчёт, ответы), за какой период, с какими фильтрами, живёт ли ссылка постоянно или час. Если отдавали ответы с контактами — напомнить, что ссылка публичная.
Чего не делать
- Не отдавать ответы с контактами по публичной ссылке, не спросив прямо.
- Не выгружать файл, если просили ссылку, и наоборот — это разные вещи.
- Не строить умный отчёт молча — это долгая операция, предупредить.
- Не предлагать смену тарифа и не вести на оплату. Если упёрлись в лимит — назвать факт и остановиться.