Как подключить бота Telegram к чатам Teleport
Клиенты пишут вашему боту в Telegram, а вы и ваши операторы отвечаете им из личного кабинета Teleport. Подключение занимает около 3 минут, модерации нет — бот начинает работать сразу.
- 1
Откройте @BotFather
В Telegram найдите официального бота @BotFather (с синей галочкой) и нажмите «Старт». Через него создаются и настраиваются все боты Telegram. Регистрация организации и модерация не нужны.
- 2
Создайте бота
Отправьте команду
/newbot. BotFather попросит:- имя — его клиенты видят в чате, например «Поддержка Teleport»;
- username — уникальный адрес латиницей, обязательно оканчивается на «bot», например
teleport_support_bot.
- 3
Скопируйте токен
В ответ BotFather пришлёт сообщение с токеном вида
1234567890:AAH…— скопируйте его целиком, вместе с цифрами и двоеточием.Токен даёт полный доступ к боту — не пересылайте его в чатах и не публикуйте. Если потеряли — в BotFather откройте
/mybots→ ваш бот → «API Token». - 4
Оформите бота (по желанию)
В BotFather:
/setuserpic— аватар,/setdescription— текст, который клиент видит до нажатия «Старт»,/setabouttext— описание в профиле бота. - 5
Подключите бота в личном кабинете Teleport
Откройте «Чаты» → «Боты», выберите «Telegram», вставьте токен и нажмите «Подключить». Мы проверим токен и автоматически настроим webhook — в BotFather ничего указывать не нужно.
Важно: у бота Telegram может быть только один получатель сообщений. Если бот уже работал с другим сервисом или скриптом, после подключения к Teleport сообщения будут приходить только сюда.
- 6
Настройте сценарий
В карточке бота задайте приветствие, слова для вызова оператора и автоответы на частые вопросы. В разделе «Операторы» добавьте сотрудников, в «Шаблонах» — готовые ответы.
- 7
Проверьте
Откройте ссылку
t.me/имя_вашего_бота(кнопка «Открыть в Telegram» есть в карточке бота), нажмите «Старт» и напишите сообщение — диалог появится в разделе «Диалоги». Эту же ссылку можно разместить на сайте, в email-рассылке или в QR-коде.
Как работает бот после подключения
- Клиент нажимает «Старт» — бот отправляет приветствие и кнопку «Позвать оператора».
- Пока диалог «у бота», сообщения проверяются по вашим автоответам.
- Если клиент пишет «оператор» (или другие ваши слова), нажимает кнопку или бот не нашёл ответ — диалог получает статус «Ждёт оператора».
- Оператор отвечает из кабинета: текст, фото, видео, документы. Короткий текст уходит подписью к файлу.
- Диалоги из Telegram и MAX — в одном списке, их можно фильтровать по мессенджеру.
- Все действия и ошибки доставки записываются в журналы.
Особенности Telegram
- Бот не может написать клиенту первым: клиент должен сам открыть бота и нажать «Старт».
- Если клиент заблокировал бота, ответы не доставляются — в истории диалога появится отметка «Клиент остановил бота», а в журнале ошибок — причина.
- Файлы от клиентов сохраняются, если они не больше 20 МБ (ограничение Telegram Bot API). Отправлять клиентам можно файлы до 50 МБ.
- Работают только личные чаты с ботом: если добавить бота в группу или канал, сообщения оттуда не попадут в «Диалоги».
Безопасность и данные
- Токен бота хранится только в зашифрованном виде и не отображается после сохранения.
- Кнопка «Отозвать токен» снимает webhook в Telegram и удаляет токен из нашей базы. Если токен мог утечь — также выпустите новый в BotFather командой /revoke и подключите бота заново.
- Входящие запросы от Telegram проверяются по секретному заголовку, известному только Telegram и нам.
- По запросу клиента его данные (профиль, переписку и файлы) можно удалить из карточки диалога.