Уведомления из Битрикс24 в Telegram: как получать новые сделки в мессенджер

Получать новые сделки Битрикс24 в Telegram можно тремя способами: поставить приложение из Маркетплейса с роботом «отправить в Telegram», написать свой обработчик события создания сделки или собрать сценарий в n8n или Make. Во всех трёх случаях нужен ваш собственный Telegram-бот, а встроенной кнопки «дублировать уведомления в Telegram» у портала нет.

Обычно просьба звучит так: руководитель отдела продаж весь день в разъездах, колокольчик Битрикс24 на телефоне тонет среди задач и комментариев, а новые заявки хочется видеть сразу и отдельно. Telegram у него и так открыт с утра до вечера. Задача решается за один рабочий день, если заранее понимать, какой путь выбрать и где обычно ломается.

Какие способы есть и чем они отличаются

Выбор зависит от того, есть ли у вас разработчик и насколько гибкое уведомление нужно. Ниже сравнение по тем параметрам, которые на практике решают дело.

Способ	Что понадобится	Кому подходит	Ограничения
Приложение из Маркетплейса с роботом	Бот, приложение, права администратора CRM	Компании без программиста, которым нужен результат за час	Обычно платная подписка, зависимость от разработчика приложения
Свой обработчик события onCrmDealAdd	Бот, сервер с HTTPS, программист	Тем, кто хочет полный контроль над текстом, получателями и логикой	Нужно поддерживать код и сервер самим
n8n или Make	Бот, аккаунт в сервисе, человек, который соберёт сценарий	Тем, у кого уже есть автоматизации в n8n или Make	Ещё один сервис в цепочке, у облачных тарифов свои лимиты

На проектах B2BPRO.KZ мы чаще всего видим, что компании начинают с приложения из Маркетплейса, а через несколько месяцев, когда хочется фильтров по воронкам и разных чатов для разных отделов, переходят на свой обработчик.

Почему нельзя просто включить это в настройках

В Битрикс24 нет штатной функции, которая пересылает уведомления сотрудникам в Telegram. Отсюда частая путаница: Telegram в портале действительно подключается, но как канал открытой линии, то есть для переписки с клиентами, а не для служебных оповещений.

Встроенные роботы CRM из группы «Информирование сотрудников» умеют добавить уведомление, отправить сообщение в личный или групповой чат Битрикс24, отправить письмо или СМС сотруднику. Полный список есть в справке Битрикс24 о роботах для информирования сотрудников. Ни один из этих роботов не пишет во внешний мессенджер. Поэтому для Telegram нужен посредник: приложение, свой скрипт или сервис автоматизации.

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

Шаг 1. Как создать бота уведомлений в Telegram

Бот уведомлений — это отдельный аккаунт Telegram, от имени которого программа отправляет сообщения в чат. Создаётся он через официального бота @BotFather за пару минут, и этот шаг одинаков для всех трёх способов.

1. Откройте в Telegram чат с @BotFather (проверьте, что у аккаунта стоит синяя галочка) и отправьте команду /newbot.
2. Введите отображаемое имя, например «Сделки B2B Отдел продаж».
3. Придумайте имя пользователя. Оно должно заканчиваться на bot, например company_deals_bot.
4. В ответ BotFather пришлёт токен: длинную строку из цифр, двоеточия и букв. Сохраните её в менеджере паролей. Кто знает токен, тот может писать от имени бота.

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

Как узнать chat_id для уведомлений

Chat_id — это числовой идентификатор чата, в который бот будет отправлять сообщения. Без него метод отправки не сработает, поэтому его нужно получить до настройки Битрикс24.

1. Найдите своего бота по имени пользователя и нажмите «Запустить» (или отправьте /start). Бот не может первым начать переписку с человеком, поэтому этот шаг обязателен для каждого получателя в личке.
2. Для группы: добавьте бота в группу и напишите в ней любое сообщение, упомянув бота через @.
3. Откройте в браузере адрес https://api.telegram.org/bot<ТОКЕН>/getUpdates, подставив свой токен.
4. В ответе найдите блок "chat" и в нём поле "id". У личного чата это положительное число, у группы отрицательное.

Метод getUpdates хранит входящие события не дольше 24 часов, это указано в документации Telegram Bot API. Если ответ пустой, просто напишите боту ещё раз и обновите страницу.

Проверить связку можно сразу, ещё без Битрикс24. Откройте в браузере адрес вида https://api.telegram.org/bot<ТОКЕН>/sendMessage?chat_id=<ID>&text=Проверка. Если в чат пришло слово «Проверка», бот и chat_id настроены верно.

Вариант А: приложение из Маркетплейса с роботом

Самый быстрый способ получать новые сделки в Телеграм — поставить готовое приложение, которое добавляет в CRM робота для отправки сообщений в Telegram. В Маркетплейсе Битрикс24 таких приложений несколько, есть и под задачи, и под сделки. Большинство платные по подписке, условия у каждого свои.

Как это выглядит по шагам (названия полей зависят от конкретного приложения):

1. Администратор портала открывает Маркетплейс, ищет по слову «Telegram» и выбирает приложение, в описании которого есть робот или действие бизнес-процесса.
2. Перед установкой читает последние отзывы. На отзывах видно, живо ли приложение: жалобы на то, что перестали подключаться новые пользователи или поддержка отвечает неделями, лучше заметить до оплаты.
3. После установки в настройках приложения указывает токен бота или подключает его по инструкции разработчика.
4. Открывает CRM, раздел сделок, нужную воронку и режим «Роботы».
5. На первой стадии воронки (обычно «Новая») добавляет робота приложения. В тексте сообщения подставляет поля сделки: название, сумму, ответственного, источник.
6. Создаёт тестовую сделку и проверяет, что сообщение пришло.

Важный нюанс про робота на первой стадии. Он сработает, когда сделка попала на эту стадию. Если менеджеры иногда создают сделку сразу на второй или третьей стадии, уведомления не будет. Решение простое: продублировать робота на тех стадиях, куда реально заводят сделки, или договориться о правиле в регламенте.

Вариант Б: свой обработчик события создания сделки

Если нужна полная свобода, уведомление собирают своим кодом: Битрикс24 сообщает вашему серверу о новой сделке, а сервер отправляет текст в Telegram. Это вариант для компаний с программистом или подрядчиком.

Событие в REST API Битрикс24 — это сигнал, который портал отправляет на ваш адрес, когда в CRM что-то произошло. За создание сделки отвечает событие onCrmDealAdd. Подписка на него оформляется методом event.bind из локального приложения, а локальное приложение создаётся в разделе для разработчиков: «Готовые сценарии» → «Другое» → «Локальное приложение». Порядок описан в справке Битрикс24 о вебхуках и локальных приложениях.

Здесь чаще всего и ошибаются. По документации события onCrmDealAdd, в запросе приходит только идентификатор новой сделки, никаких названий и сумм. Поэтому логика обработчика такая:

1. Принять POST-запрос от Битрикс24 и достать из него ID сделки.
2. Проверить, что запрос пришёл именно от вашего портала (сверить токен приложения из запроса с тем, что хранится у вас).
3. Запросить подробности методом crm.deal.get: название, сумму, воронку, стадию, ответственного, источник.
4. При необходимости отфильтровать: например, слать в чат только сделки из воронки «Продажи», а сделки сервисной воронки пропускать.
5. Собрать текст и отправить его методом Telegram sendMessage с параметрами chat_id и text.

Сервер обработчика должен быть доступен из интернета по HTTPS. Для облачного портала это всё, что нужно. Для коробочной версии дополнительно проверяют, что сам портал может обращаться к внешним адресам.

Что важно знать про сторону Telegram. По документации Bot API, текст одного сообщения ограничен 4096 символами, а разметку можно включить параметром parse_mode со значением HTML или MarkdownV2. В FAQ Telegram для разработчиков ботов указаны лимиты: в одном чате не чаще примерно одного сообщения в секунду, в группе не больше 20 сообщений в минуту. Для обычного потока заявок этого с запасом хватает, но при массовой загрузке сделок обработчик должен ставить сообщения в очередь, иначе Telegram начнёт возвращать ошибку 429 и часть уведомлений потеряется.

Про ограничения самого REST API Битрикс24 у нас есть отдельная статья: что важно знать о лимитах REST API до разработки.

Вариант В: сценарий в n8n или Make

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

Этот путь удобен, если в компании уже кто-то работает с n8n или Make и в них живут другие интеграции. Минус в том, что появляется ещё одно звено: если у сервиса закончился лимит операций на тарифе или сценарий выключился после ошибки, уведомления молча перестают приходить. Подробно о том, что ещё можно связать таким образом, мы писали в статье об интеграции Битрикс24 с n8n и Make.

Что писать в уведомлении о новой сделке

По хорошему уведомлению сразу понятно, что за клиент, на какую сумму сделка и кто за неё отвечает. Всё остальное можно посмотреть по ссылке на карточку.

Пример шаблона, который хорошо читается на экране телефона:

Новая сделка: Поставка оборудования, ТОО «Пример»
Сумма: 1 250 000 тг
Источник: заявка с сайта
Ответственный: Айгерим Н.
Открыть: ссылка на карточку сделки

Несколько практических советов по тексту:

• Сумму показывайте в тенге с пробелами между разрядами, иначе 1250000 на бегу читается с трудом.
• Ссылку на карточку ставьте обязательно. Адрес сделки в облачном портале обычно выглядит как адрес портала плюс /crm/deal/details/ и ID; проверьте формат на своём портале, открыв любую сделку.
• Не выводите в общий чат телефоны и почты клиентов. Группу в Telegram проще случайно расширить, чем права в CRM, а персональные данные клиентов в Казахстане защищены законом.
• Если сделок много, разделите чаты: один для крупных сделок от определённой суммы, другой для всех остальных.

Частые ошибки при настройке уведомлений в Telegram

Большинство проблем после запуска связаны не с Битрикс24, а с ботом и чатом. Вот что мы проверяем первым делом, когда клиент пишет «уведомления не приходят»:

• Получатель не нажал «Запустить». Бот не может написать человеку первым. Новому сотруднику нужно открыть бота и нажать кнопку, иначе сообщения в личку до него не дойдут.
• Группу преобразовали в супергруппу. При этом у чата меняется идентификатор, и старый chat_id перестаёт работать. Решение: заново получить id через getUpdates и обновить его в настройках.
• Бота удалили из группы. Кто-то из участников навёл порядок в списке и убрал «непонятного бота». Сообщения перестали приходить без всякой ошибки на стороне портала.
• Токен засветился. Токен вставили прямо в код страницы сайта или переслали в общий чат. Если это случилось, в @BotFather токен перевыпускают, а старый перестаёт действовать. В справке Битрикс24 то же правило действует для секретного кода вебхука: никому его не передавать и не указывать в коде страницы или скрипта.
• Уведомление на каждое изменение. Вместо события создания сделки подписались на изменение, и чат за день превращается в ленту из сотен сообщений, которые никто не читает. Для новых сделок нужно именно событие создания или робот на первой стадии.
• Массовая загрузка. При импорте сделок из файла или переносе из другой CRM уведомления могут прийти пачкой. На время загрузки робота или обработчик лучше выключить.

Как проверить, что уведомления не теряются

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

1. Составьте список источников сделок: ручное создание, форма на сайте, открытая линия, звонок, конвертация лида, импорт.
2. Для каждого источника создайте тестовую сделку и отметьте, пришло ли сообщение и сколько секунд оно шло.
3. Проверьте, что уведомление пришло в нужный чат и с нужным текстом: правильная сумма, ответственный, рабочая ссылка на карточку.
4. Попросите одного сотрудника выйти из группы и вернуться, чтобы убедиться, что новые участники видят сообщения.
5. Удалите тестовые сделки, чтобы они не исказили отчёты по воронке.

Дальше полезно раз в месяц сверять количество новых сделок в CRM за неделю с количеством сообщений в чате. Если цифры расходятся, где-то есть дыра: робот не стоит на одной из стадий, сценарий в Make выключился или бота убрали из группы. Свой обработчик стоит научить писать в лог каждую отправку и каждую ошибку Telegram, тогда разбор займёт минуты, а не вечер.

И последнее про ответственность. Назначьте человека, который отвечает за бота: хранит токен, добавляет новых сотрудников в группу и убирает уволившихся. Если такого человека нет, связка обычно ломается после первой же кадровой перестановки, и замечают это не сразу.

Пример: как это работает в небольшом отделе продаж

Пример условный, но собран из типичных ситуаций. Компания в Алматы продаёт оборудование, в отделе продаж пять менеджеров и руководитель. Заявки приходят с сайта, из WhatsApp через открытые линии и по телефону. Руководитель жаловался, что узнаёт о крупных заявках через день, когда клиент уже успел получить предложение от конкурента.

Что сделали. Создали бота и две группы в Telegram: «Все новые сделки» для отдела и «Сделки от 1 млн» для руководителя и коммерческого директора. Подключили обработчик события создания сделки: он получает данные через crm.deal.get, отправляет короткое уведомление в общую группу, а если сумма больше миллиона тенге, дублирует его во вторую группу. В тексте название, сумма, источник, ответственный и ссылка на карточку, без контактов клиента.

Первые две недели всплыли две мелочи. Менеджеры создавали сделку с нулевой суммой и заполняли её позже, поэтому крупные сделки не попадали во вторую группу. Добавили второе условие: уведомление о крупной сделке отправляется и при изменении суммы, если она перешла порог. Вторая мелочь: один менеджер вышел из общей группы, потому что «много сообщений». Это решили не техникой, а договорённостью в отделе.

Работа со сделкой при этом по-прежнему идёт в Битрикс24. Мессенджер просто быстрее доносит сигнал до того, кто должен среагировать.

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

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

Да, можно. Бесплатный путь: создать своего бота через @BotFather и написать обработчик события создания сделки, который отправляет текст через Telegram Bot API, либо собрать сценарий в n8n на своём сервере. Сам Telegram Bot API бесплатный, но понадобится программист или сотрудник, который разберётся с настройкой, и сервер с HTTPS для обработчика.

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

Проще всего создать группу в Telegram, добавить в неё бота и всех нужных сотрудников, а уведомления слать в эту группу по её chat_id. Отправлять каждому в личку тоже можно, но тогда каждый получатель должен сам открыть бота и нажать «Запустить», а в настройках придётся хранить список идентификаторов и обновлять его при смене сотрудников.

Почему бот уведомлений перестал присылать сделки в группу?

Чаще всего бота удалили из группы или группа стала супергруппой и получила новый chat_id. Ещё бывает, что токен перевыпустили в @BotFather, а в настройках остался старый. Проверьте эти три пункта, затем отправьте тестовое сообщение через метод sendMessage прямо из браузера: если оно не доходит, проблема на стороне Telegram, а не Битрикс24.

Будут ли уведомления о сделках, созданных роботом или из открытой линии?

Обработчик события создания сделки получает сигнал о любой новой сделке, независимо от того, кто её создал: менеджер, робот, форма или открытая линия. Робот на первой стадии воронки сработает, только если сделка попала именно на эту стадию. Поэтому после настройки проверьте каждый канал, откуда у вас появляются сделки, тестовой заявкой.

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