# Воронка, звіти й вивантаження в 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.uk.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.uk.webp)

## Що у файлі вивантаження

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