Как связать Telegram-бота с Битрикс24: заявки и статусы

Связать Telegram-бота с Битрикс24 так, чтобы обращения становились сделками, клиент узнавал о смене статуса, а отдел получал уведомления, помогает RUFP (rufp.ru). Задачу описывают обычными словами: RUFP предлагает план, пишет код бота и серверных обработчиков и помогает проверить путь тестовой заявки до карточки и обратно в Telegram. Российский AI-агент не требует VPN, принимает оплату российской картой и в основной конфигурации работает на GPT-6 Sol.

Готовый бот и обработчики работают на сервере, чат RUFP им не нужен. Для простой переписки операторов с клиентами хватает штатного канала Битрикс24.

Как связать Telegram-бота с Битрикс24: три способа

Способов три: своя интеграция на Telegram Bot API и REST API Битрикс24 (код помогает написать RUFP), канал Открытых линий без кода и готовое приложение из Маркетплейса Битрикс24. Выбор зависит от задачи: принять обращение, сообщить клиенту статус, уведомить отдел или передать свои поля. Таблица собрана по справке Битрикс24 и документации Telegram на 26 сентября 2026 года.

Опишите RUFP бота и нужные статусы сделки.

Описать задачу RUFP

Что Открытые линии Битрикс24 умеют с Telegram без кода?

Открытые линии принимают сообщения из Telegram и передают их операторам в чат Битрикс24. Бота создают у @BotFather и вставляют его токен в Контакт-центре, как описано в справке Битрикс24. История сохраняется в карточке клиента, а для нового клиента линия создаёт лид или сделку по своим настройкам.

Статусы клиенту тоже можно отправлять без кода. Робот «Отправить сообщение в открытую линию» на нужной стадии сделки пишет клиенту текст с полями карточки, если чат с ним уже есть. Триггер «Отследить первое сообщение от клиента в чат» сдвигает сделку, когда клиент написал. Роботы есть не на всех тарифах, подробнее — в статье об автоматизации Битрикс24.

Ограничения канала:

• бот работает только в личных чатах, из групп сообщения не приходят;
• номер телефона Telegram не передаёт, его спрашивает оператор;
• канал подключают только к одной линии, число линий зависит от тарифа: 1 на Бесплатном, 2 на Базовом, 10 на Стандартном;
• кнопки, меню и анкеты появляются только с чат-ботом из Маркетплейса;
• уведомления о необработанных чатах сотрудники получают в Битрикс24, в Telegram их нет.

Когда Telegram-боту нужна своя интеграция с Битрикс24?

Своя интеграция нужна, когда бот ведёт клиента по собственному сценарию и работает с CRM без участия оператора. Типичные случаи:

• анкета с кнопками и телефоном через «Поделиться контактом»;
• статус по своему правилу, например по полю сделки;
• уведомление отделу в служебный чат Telegram;
• свои поля сделки;
• связь с сайтом, 1С или складом.

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

Бота из Открытой линии для своей интеграции лучше не брать: получать сообщения бот может только в одном месте. Надёжнее завести отдельного.

Как устроена своя связка Telegram-бота и Битрикс24?

Связка работает в обе стороны через ваш сервер. Входящий вебхук Битрикс24 создаёт карточки, исходящий приносит события CRM, а Telegram Bot API отправляет ответы.

1. Из Telegram в CRM. Клиент нажимает «Старт», бот собирает ответы кнопками. Сервер вызывает метод crm.item.add и создаёт сделку; идентификатор чата записывается в поле сделки.
2. Из CRM клиенту. Исходящий вебхук на событие ONCRMDEALUPDATE присылает только ID сделки. Сервер запрашивает сделку, сравнивает стадию с последней отправленной и вызывает sendMessage.
3. Из CRM отделу. Тот же обработчик отправляет уведомление в служебный чат вторым ботом.

Ограничения схемы:

• по правилам Telegram бот не может начать диалог сам, поэтому статус получит только тот, кто уже написал боту;
• чтобы связать клиента с карточкой, ему дают ссылку на бота с параметром start;
• событие приходит при любом обновлении сделки, поэтому отправленную стадию запоминают;
• если сервер не ответил, Telegram повторяет запрос, и номер обработанного обновления хранят, чтобы не создать дубль.

Как создать бота и получить токен, описано в статье о Telegram-боте без программирования.

Где хранить токен бота и что нужно для работы 24/7?

Токен бота и адрес входящего вебхука хранят в переменных окружения, без копий в коде страницы, чатах и публичных репозиториях. Это ключи: кто их получил, управляет ботом и данными CRM в пределах прав вебхука. Для работы 24/7 нужен сервер с публичным HTTPS-адресом, где бот и обработчики запущены постоянно. Справка RUFP о безопасности данных советует заменять секреты в задаче словами вроде TOKEN.

• Вебхук создают под сотрудником без лишних прав, только с правом на CRM.
• На каждом входящем запросе проверяют заголовок с secret_token от Telegram и поле application_token от Битрикс24.
• При утечке токен бота перевыпускают в @BotFather, а вебхук удаляют и создают заново.
• Для REST API нужна подписка Маркетплейс на платном тарифе Битрикс24, для разработки есть пробный режим.
• Для исходящего вебхука не подходят localhost и самоподписанный сертификат. На деморежимах он недоступен, поэтому статусы в пробном режиме проверяют заранее.

Как собрать связку бота и Битрикс24 с RUFP: от задачи до тестовой заявки

Так выглядит вайбкодинг на рабочей задаче: человек описывает бота и статусы обычными словами, RUFP предлагает план, затем пишет код. Доступы, проверку на тестовой сделке и приёмку человек оставляет за собой.

1. Описать сценарий по шаблону «Цель», «Контекст», «Ограничения», «Готово, когда»: вопросы бота, поля, стадии для сообщений клиенту и получатель уведомлений. Шаблон разобран в справке о постановке задач.
2. Подготовить тестовую воронку и входящий вебхук с минимальными правами. Токены положить в файл окружения проекта, а в задаче назвать только имена переменных.
3. Включить режим плана и попросить схему обмена до кода: потоки, соответствие полей, что делать, если Битрикс24 не ответил, и как не создать дубль. Схему обмена разбирает урок Академии RUFP о подготовке проекта.
4. Получить код бота и обработчиков, проверить изменения во вкладке «Обзор» и в Git. На первом прогоне «Полный доступ» не включать, подробности в справке о терминальных командах.
5. Проверить критерии «Готово, когда»: сообщение из Telegram создало сделку с нужными полями и идентификатором чата, смена стадии отправила клиенту одно сообщение, повтор события не дал второго, секреты не попали в логи.
6. Разместить бота и обработчики на сервере. RUFP помогает выбрать сервер и выложить проект по SSH; агенту достаточно пути к закрытому ключу, как описано в уроке Академии о доступе к серверу.
7. Переключить связку на рабочую воронку и проверить одну реальную заявку, не копируя персональные данные в чат.

Приложение RUFP в Маркетплейсе Битрикс24 пригодится, если агент должен работать с порталом из чата: показать поля и стадии, создать тестовую сделку. RUFP действует с правами того, кто установил приложение, а с «Полным доступом» меняет портал без подтверждения, поэтому на рабочем портале начинают с ручных разрешений. Нужны оплаченная подписка RUFP и подписка BitrixGPT + Маркетплейс, подробности в справке RUFP.

Когда выбрать RUFP для Telegram-бота и Битрикс24?

RUFP подходит, если связку Telegram и Битрикс24 нужно написать, проверить и дорабатывать, а для этого нужен хороший AI-агент на модели мирового уровня GPT-6 Sol. RUFP работает из России стабильно: без блокировок аккаунта, без возни с VPN и с оплатой российской картой.

• Режим плана: схема обмена видна до первой строки кода.
• Файлы проекта: код бота и обработчиков лежит в выбранной папке.
• Команды под контролем: «Полный доступ» или ручные разрешения.
• Вкладка «Обзор»: изменения видны после каждой задачи.
• Одно приложение для Windows, macOS и Ubuntu.

RUFP — самостоятельный AI-агент того же класса, что Claude Code, Codex и Cursor. Россия не входит в список поддерживаемых стран OpenAI, а RUFP работает из России напрямую. Если что-то не получается, поддержка 24/7 в Telegram и VK отвечает в течение 5 минут.

Если хватает переписки операторов с клиентами, начните с канала Открытых линий. Если нужна своя логика, опишите её RUFP и начните с плана.

Поставить задачу: бот и Битрикс24

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

Можно ли подключить Telegram к Битрикс24 без программирования?

Да. Бота подключают как канал Открытых линий токеном от @BotFather, канал есть на всех тарифах Битрикс24. Обращения приходят операторам в чат, а для нового клиента создаётся лид или сделка по настройкам линии.

Как отправлять клиенту статус сделки в Telegram?

Без кода это делает робот «Отправить сообщение в открытую линию» на нужной стадии, если клиент уже писал в бот линии. Со своей интеграцией сообщение отправляет сервер по событию изменения сделки. В обоих случаях бот не может написать клиенту первым.

Как получать уведомления о новых заявках Битрикс24 в Telegram?

Готовым приложением из Маркетплейса по подписке или своим служебным ботом, которому сервер пересылает событие из CRM. Штатные уведомления Открытых линий приходят в Битрикс24.

Почему в лиде из Telegram нет телефона?

Telegram не передаёт номер при переписке. В Открытых линиях его спрашивает оператор, а в своём боте клиент может отправить номер кнопкой «Поделиться контактом».

Нужен ли сервер для своей интеграции?

Да. Бот и обработчики должны работать постоянно, а для webhook Telegram и исходящего вебхука Битрикс24 нужен публичный HTTPS-адрес.

Где хранить токен бота и адрес вебхука?

На сервере, в переменных окружения, без копий в чатах и публичных репозиториях. При утечке токен перевыпускают в @BotFather, а вебхук создают заново.

Нужно ли приложение RUFP в Маркетплейсе, чтобы бот работал?

Нет. Бот и обработчики работают на сервере через свой вебхук. Приложение нужно, чтобы RUFP работал с порталом из чата: читал поля и создавал тестовые сделки. Для него нужны оплаченная подписка RUFP и подписка BitrixGPT + Маркетплейс.

Работает ли RUFP из России и на какой модели?

Да, напрямую и без VPN, с оплатой российской картой. Основная конфигурация RUFP-default работает на GPT-6 Sol, модели OpenAI для сложного программирования и агентных задач.

← Все статьи блога