Перенос Telegram-бота с нативной интеграции Битрикс24

Как перенести Telegram-бота со встроенного канала Битрикс24 на интеграцию Radist.Online: порядок переключения токена, выбор открытой линии и контроль дублей.

Коротко. Перенос Telegram-бота со встроенного канала Битрикс24 на Radist.Online — 5 шагов. (1) Подключить бота в RadistWeb: «Подключения» → «Telegram Bot» → название + токен → «Подключить». (2) Настроить интеграцию: «Настройки» → «Интеграции» → «TelegramBot+BITRIX» → «+добавить бота» → выбрать открытую линию → тумблер «Интеграция включена». (3) Отключить старый нативный канал Telegram в Контакт-центре Битрикс24. (4) Проверить настройки открытой линии (очередь, проверка клиента, приветствие). (5) Протестировать. Важно: у бота только один активный webhook — переключение мгновенное; токен /revoke в BotFather делать не нужно — используйте существующий, /token получит его повторно. По старым клиентам возможны дубли — включите проверку клиента по базе CRM. Прежняя переписка останется в старом канале.

У вас есть Telegram-бот компании (клиенты пишут прямо в бота), он подключён к Битрикс24 через встроенный (нативный) канал Telegram в Контакт-центре, и вы хотите перевести его на интеграцию Radist.Online. Эта инструкция — пошаговый план такого переноса.

🤖 Боты в Radist.Online подключаются бесплатно на любом тарифе. Платные тарифы за канал действуют только для личных номеров. При этом интеграция в Битрикс24 работает по платной подписке Битрикс24.Маркет — она оплачивается на стороне Битрикс24 (тестовый период — 15 дней).

Что важно знать заранее

Один бот — один сервис

У 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».

С этого момента webhook бота переназначается на Radist.Online, и встроенный канал Битрикс24 перестаёт получать новые сообщения. Чаты появятся в личном кабинете в течение 15 минут — поэтому сразу переходите к следующему шагу.

Настройте интеграцию TelegramBot+Б24

Перейдите в Настройки → Интеграции → TelegramBot+BITRIX, нажмите «+добавить бота», выберите вашего бота и укажите открытую линию, в которую будут попадать обращения. Включите тумблер «Интеграция включена» и сохраните. Подробно — в инструкции «Подключение интеграции Telegram Bot + Битрикс24».

Укажите ту открытую линию, в которой вы ведёте клиентов по этому боту. К одной открытой линии можно подключить только один Telegram Bot.

Отключите старый канал в Контакт-центре Битрикс24

Чтобы обращения не «двоились», отключите прежний встроенный канал Telegram этого бота в Контакт-центре Битрикс24. После этого входящие обслуживает только интеграция Radist.Online.

Проверьте настройки открытой линии

Обращения теперь попадают в выбранную открытую линию, и дальше всё зависит от её настроек: очередь ответственных, проверка клиента по базе CRM, приветственное сообщение и рабочее время.

Проверьте перенос

Напишите боту с тестового аккаунта — сообщение должно попасть в выбранную открытую линию.
Ответьте из карточки — ответ должен дойти клиенту в Telegram.
Убедитесь, что для нового клиента создаётся одна карточка, без дублей.

Совет: сначала протестируйте на запасном боте

Чтобы не рисковать боевым ботом, создайте в @BotFather отдельного тестового бота, подключите его к Radist.Online и пройдите весь путь выше на нём. У запасного бота другой токен и свой webhook, поэтому боевому боту он не помешает — клиенты продолжат писать в рабочего бота как обычно.

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

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

Почему нельзя перевыпустить токен через `/revoke`?

Команда /revoke в BotFather моментально аннулирует старый токен. Пока новый не окажется во всех подключённых сервисах, бот молчит везде. Если ваш бот сейчас работает во встроенном канале Битрикс24 и вы сделаете /revoke — старый канал отвалится сразу, а вы пока не подключили новый в Radist.Online. Правильный порядок: получить токен через /token, подключить в Radist.Online (webhook автоматически переключится на нас), потом отключить старый канал. Без /revoke.

Прежняя переписка «переедет» на новый канал?

Нет. Прежние диалоги останутся в старом (встроенном) канале Битрикс24, где они лежали. Новые сообщения после переключения пойдут через открытую линию Radist.Online. Это два разных источника, они не сливаются. Через некоторое время старый канал можно будет отключить полностью — история диалогов не пропадёт, она хранится в CRM.

Как избежать дублей при переносе?

Дубли возможны по старым клиентам, которые уже писали через встроенный канал. Когда такой клиент напишет боту первый раз через Radist.Online, у него может создаться новая карточка. Три способа снизить риск: (1) включить «Проверка клиента по базе CRM» в новой открытой линии — тогда Битрикс24 попробует связать по username; (2) в первые дни объединять дубли вручную; (3) сначала протестировать на запасном боте (см. совет ниже в тексте).

Что если бот подключён сразу к нескольким Битрикс24-порталам?

Так работать не будет — у бота один webhook, поэтому будет работать только последний, куда подключили. Если у вас несколько порталов на одном боте — выберите основной, из остальных удалите. Альтернатива — создать отдельного бота под каждый портал (у каждого свой токен и свой webhook).

Как проверить, что webhook переключился на Radist.Online?

Проще всего — написать боту с тестового аккаунта. Если сообщение появилось в открытой линии Битрикс24 через нашу интеграцию — переключение прошло. Технический способ: в BotAPI вызвать getWebhookInfo — в поле url должно быть значение с доменом radist.online.

На «Начальном» тарифе подключить бота можно?

Да, боты подключаются бесплатно на любом тарифе Radist.Online — тарифы за канал действуют только для личных номеров Telegram/WhatsApp. Единственное платное — подписка Битрикс24.Маркет (это сторона Битрикс24, не наша).