Telegram + Битрикс24 не работает: что проверить
Telegram + Битрикс24 не работает: сообщения не приходят в Открытые линии или не уходят клиенту. Причины по частоте — слетевшая сессия, тумблер интеграции, подписка Битрикс24.Маркет, неактивная линия.
Коротко. Сообщения не идут — сначала откройте раздел «Чаты» в RadistWeb: если там сообщений тоже нет, дело в сессии Telegram (пункт 1), если есть — в связке с Битрикс24 (пункты 2–7). Топ-причин по частоте: (1) слетела сессия Telegram — проверить в приложении «Устройства», должна быть radistonline, Amsterdam, Netherlands; (2) выключен тумблер «Интеграция активна» — все номера сразу молчат; (3) номер отвязан от интеграции; (4) закончилась подписка Битрикс24.Маркет или Radist.Online; (5) открытая линия неактивна (красный крестик); (6) в линии два одинаковых канала. Только что подключили — подождите 15 минут.
Сообщения из Telegram перестали приходить в Битрикс24 или ответы не уходят клиенту — пройдите по списку ниже. Причины перечислены от самых частых к редким.
Сначала поймите, где проблема
Откройте раздел «Чаты» в личном кабинете RadistWeb и посмотрите, приходят ли туда сообщения.
- Сообщений нет и в кабинете — дело в самом номере Telegram. Смотрите пункт 1.
- В кабинете сообщения есть, а в Битрикс24 их нет — проблема в связке с CRM. Смотрите пункты 2–7.
1. Слетела активная сессия Telegram
Самая частая причина. Связь с номером держится через сессию Radist.Online в приложении Telegram — если её закрыли, сообщения перестают ходить в обе стороны.
Что сделать: проверьте в приложении Telegram Настройки → Устройства — там должна быть активная сессия radistonline, Amsterdam, Netherlands. Если её нет, авторизуйте номер заново: «Telegram не работает: что проверить».
Чтобы не узнавать о таком от клиентов, включите автоматические уведомления о сбоях.
2. Выключен тумблер «Интеграция активна»
Что сделать: откройте Настройки → Интеграции → Telegram+BITRIX, включите тумблер «Интеграция активна» и нажмите «Сохранить изменения».
3. Номер отключили от интеграции
Если в настройках интеграции нажали кнопку «корзинка» и сохранили изменения, номер отвязывается от Битрикс24: в личном кабинете он остаётся и выглядит рабочим, но обращения в Открытую линию больше не идут.
Что сделать: подключите номер обратно — «+ добавить номер» и выберите Открытую линию. Подробнее — «Отключение подключения от интеграции».
4. Закончилась подписка Битрикс24.Маркет
Интеграция работает только при активной подписке Битрикс24.Маркет — когда заканчивается тестовый период (15 дней) или сама подписка, интеграция останавливается.
Что сделать: оформить подписку — bitrix24.ru/apps/subscribe.php. Подписка Битрикс24.Маркет не заменяет оплату Radist.Online — нужны обе: «Оплата интеграции с Битрикс24».
5. Закончилась подписка Radist.Online на номер
Подписка создаётся на каждое подключение отдельно. Если она не продлилась, номер отключается независимо от того, что происходит на стороне Битрикс24.
Что сделать: проверьте раздел «Подписки» в личном кабинете — как работают подписки.
6. Открытая линия неактивна
В выпадающем списке Открытых линий у неактивной линии стоит красный крестик. Пока линия выключена, обращения в неё не попадают.
Что сделать: кликните по такой линии — Битрикс24 предложит её активировать. Если окно не появляется, включите вручную: «Настроить» справа от списка линий → вкладка «Прочее» → галочка «Линия активна» → «Сохранить» в самом низу окна.
7. К одной линии подключены два сервиса Telegram
К одной Открытой линии нельзя подключать два одинаковых канала — например, наш Telegram и встроенный канал Битрикс24 или сторонний сервис. Битрикс24 это не запрещает, но работать будет только один из них.
Что сделать: в Контакт-центре откройте виджет лишнего сервиса и нажмите «Отключить». На плитке в Контакт-центре не должно остаться галочки.
8. Чат клиента в чёрном списке
Если проблема только с одним клиентом, а с остальными всё в порядке — скорее всего, его чат заблокирован.
Что сделать: откройте карточку подключения Telegram в разделе «Подключения» и проверьте список заблокированных чатов — «Чёрный список для Telegram».
9. Сообщения уходят с ошибкой
Сессия жива, сообщения в Битрикс24 приходят, но ответы клиенту помечаются ошибкой — причины и обозначения разобраны отдельно: «Сообщение отправляется с ошибкой».
Если номер ограничил сам Telegram — это отдельная история: «Ограничения Telegram и баны номеров».
10. Ничего из перечисленного не помогло
Переустановите интеграцию — повторно устанавливать приложение в маркетплейсе Битрикс24 для этого не нужно: «Переустановка интеграции».
Стоит также заглянуть на status.bitrix24.ru — при крупном сбое на стороне Битрикс24 менять настройки у себя бесполезно.
Частые вопросы
Что означает сессия «radistonline, Amsterdam, Netherlands»?
Наш сервис подключается к Telegram через собственные серверы в Амстердаме — это делается по протоколу «активная сессия» (аналог WhatsApp Web). Пока эта сессия жива в приложении Telegram у вас на телефоне (Настройки → Устройства), связь с нашим сервером работает. Если её удалить или пометить как «завершить все другие сессии» — интеграция отвалится, нужна повторная авторизация.
Тумблер «Интеграция активна» — это то же, что подключение номера?
Нет. Тумблер отключает интеграцию с Битрикс24 сразу для всех номеров, привязанных к порталу — как «выключатель всего». Подключение номера — привязка конкретной SIM к открытой линии. Если выключить тумблер, номера в RadistWeb останутся, но сообщения в Битрикс24 не пойдут. Проверьте тумблер, если «молчат» сразу все номера.
Логи Telegram-сообщений хранятся сколько дней?
5–6 дней. Если сбой был раньше — восстановить сообщения не получится. Поэтому в поддержку пишите сразу, как заметили. Что приложить к обращению — здесь.
Как понять, что дело в Битрикс24, а не в нашей интеграции?
Три признака: (1) status.bitrix24.ru сообщает о сбое; (2) в RadistWeb сообщения от клиентов приходят, а в Битрикс24 их нет; (3) при попытке сохранить настройки открытой линии Битрикс24 отдаёт ошибку. Если признаков нет, а всё равно не работает — проблема на стороне номера или настроек нашей интеграции, идите по чек-листу выше.
Пересохранил интеграцию — не помогло. Что дальше?
Переустановите. Заходить в маркетплейс Битрикс24 не нужно — переустановка делается через RadistWeb: Переустановка интеграции. После этого — заново привязка номера к открытой линии. Если и это не помогло — в поддержку с указанием, что уже пробовали.
Как узнавать о слетевшей сессии до того, как клиент напишет «вы куда пропали»?
Включите автоматические уведомления о сбоях интеграции Telegram в RadistWeb. Приходят на почту и в Telegram выбранным сотрудникам, когда сессия обрывается. Настраивается за 2 минуты, реагировать успеваете раньше клиентов.