Telegram Bot + Битрикс24 не работает: что проверить

Telegram Bot + Битрикс24 не работает: что проверить в Битрикс24: токен, тумблер «Интеграция включена», подписка Битрикс24.Маркет, чёрный список и переустановка интеграции.

Коротко. Бот молчит — пройдите по 8 пунктам, отсортированным от самых частых к редким. Топ-3: (1) токен обновили в BotFather, но не в RadistWeb — самое частое, скопировать и вставить новый токен в «Подключения → Telegram Bot → Редактировать»; (2) тот же бот подключён где-то ещё — у Telegram-бота только один активный webhook, где-то один или другой; (3) выключен тумблер «Интеграция включена» — все боты сразу молчат. Только что подключили — подождите 15 минут. Не помогло всё это — переустановите интеграцию (без переустановки приложения из маркетплейса Битрикс24).

Сообщения от клиентов перестали приходить в Битрикс24 или ответы не уходят? Пройдите по списку ниже — причины перечислены от самых частых к редким.

Если вы только что подключили бота — просто подождите: чаты появляются в личном кабинете и в Битрикс24 в течение 15 минут.

1. Токен обновили в BotFather, но не обновили в RadistWeb

Самая частая причина. Команда /revoke в @BotFather сразу выпускает новый токен, а старый перестаёт работать — бот «замолкает», пока новый токен не окажется в личном кабинете.

Что сделать: скопируйте новый токен и вставьте его в Подключения → Telegram Bot → Редактировать. Подробнее — в Частые вопросы: Telegram Bot в RadistWeb.

2. Тот же бот подключён в другом сервисе

У Telegram-бота может быть только один активный webhook. Если тот же токен подключили куда-то ещё — во встроенный канал Битрикс24, в другой портал или в другой сервис, — бот будет работать только там, где его подключили последним.

Что сделать: убедитесь, что бот подключён только в Radist.Online. Если он раньше работал через встроенный канал Битрикс24, отключите тот канал в Контакт-центре — как это сделать, описано в инструкции «Перенос Telegram-бота с нативной интеграции Битрикс24».

3. Выключен тумблер «Интеграция включена»

Этот тумблер выключает интеграцию на конкретном аккаунте Битрикс24 сразу по всем подключённым к нему Telegram-ботам — то есть «молчат» все боты разом.

Что сделать: откройте Настройки → Интеграции → TelegramBot+BITRIX, включите тумблер «Интеграция включена» и нажмите «Сохранить изменения».

4. Бота отключили от интеграции

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

Что сделать: подключите бота обратно — «+добавить бота» и выберите открытую линию. Подробнее — «Отключение бота от интеграции».

5. Закончилась подписка Битрикс24.Маркет

Интеграция работает только по платной подписке Битрикс24.Маркет — если закончился тестовый период (15 дней) или сама подписка, интеграция останавливается.

Что сделать: оформить подписку — bitrix24.ru/apps/subscribe.php.

6. Заблокированы оплаты и закрыты лимиты в RadistWeb

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

Что сделать: напишите нам — разберёмся с лимитами.

7. Чат клиента в чёрном списке

Если чат клиента заблокирован, сообщения от него приходить не будут.

Что сделать: откройте карточку подключения Telegram Bot в разделе «Подключения» и проверьте список заблокированных чатов — при необходимости нажмите «Разблокировать» (нужно право «Подключения — Редактирование»). Изменения вступят в силу в течение 15 минут. Подробнее — в разделе «Чёрный список».

8. Ничего из перечисленного не помогло

Переустановите интеграцию — это не требует повторной установки приложения в маркетплейсе Битрикс24: «Как переустановить интеграцию Telegram Bot + Битрикс24».

Не помогло — напишите в поддержку. Приготовьте ID компании из личного кабинета: без него мы не сможем подтвердить, что обращается сотрудник вашей компании. Где взять ID.

Частые вопросы

Что такое «активный webhook» бота?

Webhook — это URL, на который Telegram отправляет обновления бота (новые сообщения от клиентов, изменения статусов и т. д.). У бота один активный webhook в один момент времени — это правило Telegram Bot API. Если тот же токен привязать к другому сервису, webhook переключится туда, а наш сервис перестанет получать сообщения. Проверить текущий webhook можно командой getWebhookInfo в BotAPI.

Почему запуск команды `/revoke` ломает интеграцию?

/revoke в BotFather — это отзыв старого токена и генерация нового. Старый токен моментально становится недействительным. Наш сервис хранит старый токен и продолжает пытаться с ним подключаться — Telegram отклоняет запросы. Пока новый токен не окажется в RadistWeb, бот молчит. Правило: обновили токен в BotFather → сразу же обновите в RadistWeb.

Логи Telegram Bot-сообщений хранятся сколько дней?

5–6 дней, как и в остальных интеграциях. Если сбой был раньше — восстановить сообщения не получится. Поэтому в поддержку пишите сразу, как заметили.

Тумблер «Интеграция включена» — это то же, что подключение бота?

Нет. Тумблер отключает интеграцию с Битрикс24 сразу для всех ботов, привязанных к порталу. Подключение бота — привязка конкретного токена к открытой линии. Если выключить тумблер, боты в RadistWeb останутся, но сообщения в Битрикс24 не пойдут — молчат все сразу. Проверьте тумблер, если сразу все боты не работают.

Как узнать, что дело в чёрном списке, а не в самом боте?

Симптом: проблема только с одним конкретным клиентом (или несколькими), а с остальными всё в порядке. Если молчат все — дело в токене, тумблере или интеграции. Если молчит один — откройте карточку подключения Telegram Bot → раздел «Чёрный список» → разблокируйте нужный чат. Изменения — в течение 15 минут.

Пересохранил интеграцию — не помогло. Что дальше?

Переустановите. Не надо заходить в маркетплейс Битрикс24 — переустановка делается через RadistWeb: Переустановка интеграции. После переустановки — заново привязка бота к открытой линии. Если и это не помогло — в поддержку с ID компании.