Обновлено и проверено:
Подготовьте бота
Создайте бота через BotFather и передайте токен в защищённое серверное хранилище выбранного приложения. Не публикуйте токен в коде сайта или инструкции для клиентов. Опишите команды и минимальные данные, необходимые для обработки обращения.
Сделайте короткий маршрут
Первое сообщение объясняет назначение бота. Дайте выбор темы и явный способ связаться с человеком. Не заставляйте клиента проходить длинную анкету, если вопрос можно передать оператору сразу.
Проверьте доставку событий
Протестируйте повторный запуск, неизвестную команду, вложение и передачу менеджеру. В Bot API входящие события получают через webhook либо getUpdates; способ выбирают в реализации интеграции. Не включайте два независимых обработчика без согласованной архитектуры.
Перенос из другого приложения
До отключения старой системы определите момент переключения и ответственного. Проверьте, где обрабатываются новые события, и сохраните необходимую историю разрешённым способом. Один токен нельзя просто выдать нескольким независимым обработчикам и ожидать, что каждый получит полный поток.
Проверка пути от ссылки до оператора
Откройте публичную ссылку бота новым пользователем. Проверьте приветствие, команду запуска, обычный текст, документ и просьбу связаться с человеком. Сравните сообщения в Telegram и CRM. Если автоматизация отвечает одновременно с менеджером, сначала устраните конфликт правил.
Сбой и восстановление
Отозванный токен требует обновить подключение. Не публикуйте новый ключ в задаче поддержки: используйте защищённый способ передачи выбранного приложения. После восстановления отправьте новое контрольное сообщение и проверьте, как обработались пропущенные события.
Пример проверки
После выбора «Вопрос по заказу» бот уточняет номер, затем сообщает о передаче оператору. Повторное нажатие не создаёт второй запрос.
Перед следующим шагом
- Токен хранится защищённо
- Есть связь с человеком
- Повторный запуск не дублирует заявку