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

Создание бота, токен, проверка и частые проблемы.

Клиенты пишут боту вашей компании в Telegram, а сотрудники отвечают из раздела «Чаты» в CRM. Из первого сообщения клиента создаётся заявка. Подключить бота может администратор компании.

Шаг 1. Создайте бота у @BotFather

Откройте в Telegram бота @BotFather и отправьте команду /newbot.
Введите название бота: его увидят клиенты в заголовке чата.
Введите имя пользователя бота. Оно должно заканчиваться на bot, например moya_firma_bot.
@BotFather пришлёт токен: длинную строку из цифр, двоеточия и букв. Скопируйте её целиком.

Токен даёт полный доступ к боту. Не публикуйте его и не пересылайте в чатах.

Шаг 2. Вставьте токен в CRM

В CRM откройте «Настройки компании» -> «Интеграции». Если вкладок каналов несколько, выберите «Telegram».
В поле «Токен бота» вставьте токен.
Нажмите «Подключить».

В строке «Состояние» появится «Подключаем бота, это займёт несколько секунд», а затем «Работает». Токен хранится в зашифрованном виде и после сохранения не показывается.

Один бот можно подключить только к одной компании.

Шаг 3. Проверьте

Найдите своего бота в Telegram по имени пользователя и нажмите «Старт» или напишите ему сообщение.
Откройте раздел «Чаты» в CRM: там появится переписка, а в разделе «Заявки» новая заявка.
Ответьте из CRM и убедитесь, что ответ пришёл в Telegram.

Если бот занят другой программой

Бот Telegram может отдавать сообщения только одному сервису. Если токен уже используется в другой программе (например, в другой CRM или конструкторе ботов), CRM не станет отбирать бота молча.

Состояние сменится на «Нужно подтверждение» с пояснением: «У бота настроен вебхук другого сервиса. Если подключить бота к CRM, тот сервис перестанет получать сообщения».
Если вы согласны, нажмите «Подтвердить подключение». Прежний сервис перестанет получать сообщения этого бота.
Если бот нужен прежнему сервису, нажмите «Отключить» и создайте для CRM отдельного бота.

Пока подключение не подтверждено, ответы клиентам не уходят.

Частые проблемы

Что видно	Что делать
Состояние «Токен не принят»: «Telegram не принимает токен»	Токен отозван или скопирован не полностью. Выпустите новый токен в @BotFather, вставьте его в поле «Новый токен бота» и нажмите «Заменить токен».
Состояние «Ошибка»	Бот временно не отвечает. CRM повторяет попытки автоматически. Если ошибка не уходит, проверьте, не удалён ли бот.
В чате пометка «Заблокировал бота»	Клиент остановил бота. Сообщения ему не доставляются, пока он не запустит бота снова.
Файл клиента не загрузился	Telegram не даёт боту скачать файл больше 20 МБ. Попросите клиента прислать ссылку на файл.

Настройки после подключения

Когда бот работает, на странице становятся доступны карточки:

«Канал»: название источника заявок, менеджер канала, автоответы, расписание работы и запрос номера телефона. Всё это описано на странице Автоответы и права.
«Ссылки с меткой»: генератор ссылок на бота с меткой (например, avito или site_footer). Метка попадает в источник заявки, например «Telegram · avito», и в UTM-кампанию. В метке латинские буквы, цифры, «_» и «-», до 64 знаков.
«Стикеры»: наборы стикеров для панели в чате. Вставьте ссылку вида https://t.me/addstickers/Название и нажмите «Добавить набор». До 20 наборов.

Что видит клиент

Клиент переписывается с ботом компании. Личные аккаунты и номера сотрудников он не видит.
Ответы сотрудников приходят ему как сообщения бота: текст, фото, файлы, голосовые и стикеры.
Если включено приветствие, бот отправит его один раз, на первое обращение.
Если включён ответ в нерабочее время, клиент получит его вне расписания, не чаще раза в 12 часов.
Если включён запрос телефона, бот предложит кнопку, которая отправляет номер клиента.

Отключение

Откройте «Настройки компании» -> «Интеграции» -> «Telegram».
Нажмите «Отключить» и подтвердите.

Клиенты перестанут получать ответы, а переписка сохранится и останется доступной для чтения. Чтобы подключить бота снова, вставьте токен и нажмите «Подключить».