Перенос Telegram-бота с нативной интеграции Битрикс24
Как перенести Telegram-бота со встроенного канала Битрикс24 на интеграцию Radist.Online: порядок переключения токена, выбор открытой линии и контроль дублей.
У вас есть Telegram-бот компании (клиенты пишут прямо в бота), он подключён к Битрикс24 через встроенный (нативный) канал Telegram в Контакт-центре, и вы хотите перевести его на интеграцию Radist.Online. Эта инструкция — пошаговый план такого переноса.
Что важно знать заранее
Один бот — один сервис
У Telegram-бота может быть только один активный webhook. Как только вы подключите токен бота в Radist.Online, входящие сообщения пойдут к нам, а встроенный канал Битрикс24 перестанет их получать. Работать в двух сервисах одновременно бот не может.
То же правило действует и на стороне Битрикс24: по справке Битрикс24, если один и тот же токен указан на нескольких порталах, работать будет только последний успешно подключённый.
Само переключение быстрое, но учтите:
- вся прежняя переписка остаётся в старом канале Битрикс24 — она никуда не денется, но и не «переедет» в новый источник;
- новые сообщения пойдут новым источником — открытой линией, к которой вы привяжете бота в нашей интеграции.
Данные клиента в карточке
У бота нет номера телефона, поэтому в чатах он не отображается. В карточку контакта Битрикс24 подтягиваются Telegram username и user_id клиента.
Что понадобится
- ✅ Токен вашего бота — тот самый, что уже используется во встроенном канале. Если он не сохранён, получить его снова можно в @BotFather командой
/token. Перевыпускать токен через/revokeне нужно — это сразу оборвёт работу бота. - ✅ Роль «Владелец» или «Администратор» в RadistWeb — либо включённые доступы к разделам «Подключения» и «Интеграции». Подробнее о правах ролей.
- ✅ Подписка Битрикс24.Маркет или запущенный тестовый период на 15 дней.
- ✅ Не заблокированы оплаты и лимиты в RadistWeb. Если оплаты подписок заблокированы и лимиты закрыты — бота подключить не получится, обратитесь в поддержку.
Дубли контактов — прочитайте до переключения
Ваши прежние контакты по этому боту создавал встроенный канал Битрикс24 — то есть сторонний для нас источник. После переключения по уже существующим клиентам возможны дубли: когда старый клиент впервые напишет боту уже через Radist.Online, система может не связать его со старой карточкой. По новым клиентам дублей не будет.
Что сделать, чтобы свести риск к минимуму:
- включите в открытой линии настройку «Проверка клиента по базе CRM» — тогда Битрикс24 будет искать клиента среди существующих карточек;
- сначала протестируйте перенос на запасном боте (см. ниже);
- будьте готовы в первые дни вручную объединить единичные дубли по старым клиентам.
Переключение по шагам
Подключите бота в RadistWeb
Откройте раздел Подключения → Telegram Bot, введите название и токен бота, нажмите «Подключить». Подробно — в инструкции «Как подключить Telegram Bot в RadistWeb».
Настройте интеграцию TelegramBot+Б24
Перейдите в Настройки → Интеграции → TelegramBot+BITRIX, нажмите «+добавить бота», выберите вашего бота и укажите открытую линию, в которую будут попадать обращения. Включите тумблер «Интеграция включена» и сохраните. Подробно — в инструкции «Подключение интеграции TelegramBot к Б24 в ЛК».
Отключите старый канал в Контакт-центре Битрикс24
Чтобы обращения не «двоились», отключите прежний встроенный канал Telegram этого бота в Контакт-центре Битрикс24. После этого входящие обслуживает только интеграция Radist.Online.
Проверьте настройки открытой линии
Обращения теперь попадают в выбранную открытую линию, и дальше всё зависит от её настроек: очередь ответственных, проверка клиента по базе CRM, приветственное сообщение и рабочее время.
Проверьте перенос
- Напишите боту с тестового аккаунта — сообщение должно попасть в выбранную открытую линию.
- Ответьте из карточки — ответ должен дойти клиенту в Telegram.
- Убедитесь, что для нового клиента создаётся одна карточка, без дублей.
Совет: сначала протестируйте на запасном боте
Чтобы не рисковать боевым ботом, создайте в @BotFather отдельного тестового бота, подключите его к Radist.Online и пройдите весь путь выше на нём. У запасного бота другой токен и свой webhook, поэтому боевому боту он не помешает — клиенты продолжат писать в рабочего бота как обычно.
Когда убедитесь, что обращения падают в нужную открытую линию, а ответы уходят, — переносите боевого бота.