Телеграм-бот для онбординга сотрудников

Задача

Нужен был Телеграм-бот для обучения новых сотрудников. Человек приходит в компанию, запускает бота, проходит учебные материалы, отвечает на вопросы и двигается по маршруту без отдельного сопровождения на каждом шаге.

Проблема не только в том, чтобы отправить текст в чат. В обучении есть роли, дни, медиа, тесты, попытки, напоминания, руководители и отчёты. Если всё это держать вручную, руководитель постоянно уточняет статус, методолог боится править сценарии, а сотрудник легко теряет место, где остановился.

Публично показываю кейс без имени клиента, логотипов, живой ссылки на бота и реальных учебных материалов. Суть работы можно раскрыть безопасно: я собрал бот, который превращает обучение в управляемый маршрут.

Что я собрал

Бот работает как сценарный онбординг внутри Телеграма. Сотрудник видит материалы по шагам, нажимает кнопки, проходит тесты и возвращается к обучению с того места, где остановился.

Сценарии хранятся в xlsx. Это важно для команды клиента: учебный контент можно менять в привычном формате, а не просить разработчика переписать каждый текст, кнопку или тестовый блок. В таблицах лежит логика прохождения, материалы, тесты и служебные подсказки для бота.

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

Для руководителей есть отдельный контур контроля. Система показывает прогресс сотрудников, результаты тестов и события прохождения. Руководителю не нужно руками собирать, кто начал обучение, кто сдал тест, а кто остановился на середине.

Почему это не просто бот с кнопками

Кнопки здесь только поверхность. Главная работа в том, что бот сохраняет состояние человека и не ломает маршрут, если он вышел из Телеграма, нажал старую кнопку, вернулся позже, не сдал тест или попал на обновлённый сценарий.

Я закрыл несколько типичных краёв для учебного бота:

прогресс не сбрасывается случайным /start
старые кнопки не двигают сотрудника в неправильный шаг
активный тест не перебивается напоминанием
обновлённый xlsx не ломает пользователя, который уже идёт по маршруту
медиа подтягиваются из хранилища и не зависят от ручной пересылки
результаты уходят в таблицу, чтобы их можно было смотреть вне бота

Такой контур нужен в проектах, где обучение живёт дольше одной инструкции. Сегодня поменяли материал, завтра добавили тест, послезавтра руководителю нужен статус по команде. Бот должен спокойно принять эти изменения, а не превращаться в набор одноразовых сообщений.

Как устроен маршрут

xlsx-сценарии
  -> парсер материалов, кнопок и тестов
  -> Телеграм-бот для сотрудника
  -> сохранение прогресса и попыток
  -> напоминания и служебные события
  -> отчёт для руководителя
  -> экспорт в таблицу

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

Что проверял перед сдачей

Для такого бота важно проверять не только первый успешный проход. Ошибки обычно появляются не в первом сообщении, а в середине сценария: старая кнопка, активный тест, повторная попытка, обновление контента, длинный вариант ответа, закрытый следующий день или пользователь, который возвращается через время.

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

Результат

Получился бот, который превращает обучение сотрудников в управляемый процесс. Сотрудник идёт по маршруту, бот помнит место, тесты фиксируют знания, руководитель видит прогресс, а контент можно обновлять через xlsx и медиа-хранилище.

Это подходит не только для розницы. Такой же подход можно использовать для регламентов, адаптации менеджеров, внутреннего обучения, проверки знаний, инструкций по продукту и команд, где нельзя держать обучение только в чатах и памяти руководителя.

Если нужен похожий контур, ближе всего услуги боты в мессенджерах, автоматизация и интеграции API.

Проблема