TalkITАкадемияОглавление

Статья 2.1.3

Подключение Telegram-бота

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

Как подготовить бота

В Telegram откройте официальный BotFather и отправьте команду /newbot. Задайте отображаемое имя и уникальное имя пользователя, заканчивающееся на bot. Полученный токен сохраните в защищённом месте: он даёт доступ к управлению ботом. В снимках экрана показывайте имя и полностью скрывайте токен.

Если бот уже работал в другом сервисе, сначала выясните, кто управляет его webhook. У бота один действующий адрес webhook, и замена может нарушить прежнюю интеграцию. Не пересоздавайте бота и не перевыпускайте токен только из-за отсутствия первого сообщения в TalkIT.

Как привязать бота к пространству

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

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

Кто отправляет первое сообщение

С отдельного аккаунта Telegram откройте бота по имени пользователя или ссылке, при необходимости нажмите Start и отправьте личное сообщение: «Здравствуйте! Хочу узнать срок подготовки предложения». Для теста используйте текст, не группу или вложение. Первое сообщение направляет пользователь.

В TalkIT найдите диалог по боту, времени и тексту. Оператор отвечает: «Для предложения уточните город доставки». Проверьте ответ в Telegram, затем отправьте «Алматы» и убедитесь, что продолжение появилось в той же истории TalkIT. Если ответ не дошёл, см. статью 2.7.1.

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

Подробнее в статьях 2.1.5 «Изменение и отключение канала», 2.1.6 «Как открыть сотруднику доступ к переписке конкретного номера или бота» и 2.7.1 «Как проверить прохождение сообщения».

Перед публикацией: сверить точные названия элементов интерфейса, наличие форм самостоятельного подключения, права на источники и ограничения сообщений для конкретного выпуска TalkIT. Сценарий WABA через Meta не следует выдавать за Tech API.