# Воронка, отчёты и выгрузка в Excel

> Этапы кандидатов в Crutor, сводка по найму в боте и приложении, отчёт по вакансии и выгрузка откликов в Excel или CSV: где найти и что значат цифры.

Воронка в Crutor — это этапы, по которым команда ведёт кандидатов: «Новые», «Шорт-лист», «Интервью», «Наняты» и «Отказ». Цифры по ним показывают `/stats` в боте, вкладка «Отчёт» вакансии и страница «Расход ИИ» в приложении. Все отклики вакансии выгружаются в Excel командой `/export` или из приложения, в Excel или CSV. Ниже — четыре шага: двигать кандидатов, смотреть сводку, смотреть отчёт по вакансии и выгружать.

## Статус отклика и этап кандидата

У каждого отклика есть две независимые отметки:

- **Статус** ставит сам Crutor: «заполняется» — кандидат ещё отвечает; «отправлен» — кандидат подтвердил сводку ответов; «отозван» — кандидат отозвал отклик.
- **Этап** ставит команда: 🆕 новый → 💎 шорт-лист → 🗓 интервью → 🏆 нанят, или ⛔ отказ. Новый отклик всегда на этапе «новый». Сам по себе этап меняется только в одном случае: когда кандидат записывается на собеседование, отклик переходит на «интервью», если был на этапе «новый» или «шорт-лист».

Кандидат об этапах не узнаёт: смена этапа ему ничего не отправляет. Написать ему можно отдельно — например, при отказе (см. шаг 1).

Тестовые отклики (те, что вы проходите сами по тестовой ссылке) в цифры и выгрузку не попадают.

## Шаги

1. **Ведите кандидатов по этапам.** Это можно делать в трёх местах:
   - **В теме кандидата** в группе вакансии — кнопками на карточке отклика: **💎 В шорт-лист**, **🗓 Интервью**, **🏆 Нанять**, **⛔ Отказ**. Текущий этап отмечен точкой; повторное нажатие возвращает в «новые». Или командой `/status shortlist | interview | hire | reject | new` (понимает и русские слова: «шорт», «интервью», «нанять», «отказ»). При отказе бот спросит «⛔ …: отказ. Написать кандидату об этом?»: **✉️ Написать отказ** — ИИ подготовит вежливое письмо без причин и обещаний, вы его проверите; **🤫 Не писать** — без сообщения.
   - **На доске кандидатов в приложении**: откройте вакансию, вкладка «Кандидаты». Наверху фильтры по этапам с числами, поиск по имени, сортировка по клику на заголовок столбца. Отметьте нескольких кандидатов и переведите всех сразу; при массовом отказе можно написать одно сообщение, и каждый получит его как написано (кнопка **Отказать и отправить**). На компьютере работают клавиши: j/k — вверх/вниз, Enter — открыть, x — выбрать, s — в шорт-лист, r — отказ (кандидату ничего не уйдёт), / — поиск.
   - **На странице кандидата в приложении** — кнопки этапов с подтверждением.
     ![Кнопка этапа на карточке отклика переводит кандидата, а в теме видно, кто это сделал.](https://crutor.app/scenes/fr-stage.ru.webp)
2. **Смотрите сводку по найму.** Отправьте боту `/stats` («Сводка по найму» в меню). Бот покажет «📊 Последние 30 дн.»: всего начали, заполнили, наняты и расход ИИ, а по каждой вакансии — начали, заполнили, шорт-лист, интервью, наняты и средний балл. Учитываются отклики, начатые за эти 30 дней. Для одной вакансии то же самое показывает кнопка **📊 Статистика** на закреплённой карточке в группе. В приложении сводка — на странице «Расход ИИ», в таблице «Сводка по найму»: там можно выбрать 7, 30 или 90 дней, и есть столбец «Отказ».
3. **Откройте отчёт по вакансии.** В приложении на странице вакансии вкладка «Отчёт» показывает за всё время: «Начали отклик», «Заполнили до конца» (с долей в процентах), «Отозвали отклик», «Средний балл» и расход ИИ на отклик за последний год. Ниже — «Сводка ответов по вопросам»: сколько человек ответили, для числовых вопросов минимум, среднее и максимум, для вопросов с вариантами — самые частые ответы.
4. **Выгрузите отклики.**
   - **В боте:** отправьте `/export` («Выгрузить отклики в Excel»), на вопрос «Отклики какой вакансии выгрузить?» нажмите на вакансию. Бот пришлёт файл `.xlsx` с подписью «Откликов: N. Тестовые не включены.»
   - **В приложении:** вакансия → «Кандидаты» → меню «Сортировка и выгрузка» → **Выгрузить в Excel** или **Выгрузить в CSV**. Переключатель «Показывать тестовые отклики» там же включает тестовые отклики и в выгрузку.
     ![/stats показывает последние 30 дней, /export присылает все отклики вакансии файлом Excel.](https://crutor.app/scenes/fr-report.ru.webp)

## Что в файле выгрузки

- Одна строка на отклик: все отклики вакансии, с любым статусом — заполняется, отправлен, отозван; сначала новые. Фильтры, поиск и сортировка доски на выгрузку не влияют.
- Столбцы: Candidate (имя), Telegram (@username), Status, Stage, Score (балл), Applied (дата отклика), Completed (дата заполнения), затем по столбцу на каждый вопрос вакансии и на каждый документ. Заголовки служебных столбцов и значения статуса и этапа — на английском (например, `complete`, `shortlisted`), а столбцы вопросов называются как сами вопросы.
- Ответы-числа записаны числами, несколько вариантов — через запятую, «да» и «нет» — как ✓ и ✗. В столбцах документов — имена файлов; сами файлы и переписка в выгрузку не входят.
- Даты — в формате ГГГГ-ММ-ДД по UTC. Файл называется `<вакансия>-applications-<дата>.xlsx` (или `.csv`).
- Excel: один лист с названием вакансии, первая строка закреплена. CSV: UTF-8, разделитель — запятая; кириллица в Excel открывается правильно.
