Интеграция Bitrix24 с Telegram-ботом: как подключить и использовать

Bitrix24 — это не только CRM, но и платформа для совместной работы, где каждый бизнес‑процесс можно автоматизировать. Когда к системе подключается Telegram‑бот, сотрудники получают мгновенный доступ к клиентским данным прямо в мессенджере, а продажи ускоряются без переходов между приложениями. Ниже подробно описывается, как быстро собрать такой интеграционный пайплайн, какие шаги нельзя пропустить и какие типовые сценарии работают без доработок.

Краткий план статьи: подготовка аккаунта Bitrix24, создание бота в BotFather, настройка вебхуков, привязка к бизнес‑логике и ответы на часто задаваемые вопросы. Если понадобится помощь с внедрением — обратитесь к нашим услугам или закажите консультацию.

Подготовка Bitrix24 к интеграции

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

• Раздел CRM → Настройки — проверьте, что включена REST‑API. Если она отключена, включите её и сохраните изменения.
• Создайте отдельный Веб‑хук в Настройки → Приложения → Веб‑хуки. Выберите тип “Входящий веб‑хук” и отметьте права crm, user, task — они понадобятся для чтения и записи данных.
• Сохраните сгенерированный URL‑адрес. Он будет точкой входа для запросов от Telegram‑бота.

Создание Telegram‑бота в BotFather

Telegram‑бот — это обычный пользователь, управляемый через API. Его создание занимает несколько минут.

1. Откройте чат с BotFather и отправьте команду /newbot.
2. Укажите название бота (например, CRM‑Assistant) и уникальное юзернейм‑имя (обязательно заканчивается на bot).
3. BotFather выдаст токен доступа — строку вида 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Сохраните её в безопасное место.
4. Опционально: задайте описание и картинку через команды /setdescription и /setuserpic. Это повысит доверие пользователей.

Токен будет использоваться для отправки сообщений из Bitrix24 и для получения обновлений от Telegram.

Настройка вебхуков и обмена данными

Telegram может отправлять события (сообщения, команды) в ваш сервер, а Bitrix24 — в ответ выполнять действия в CRM. Для этого понадобится простой сервер‑скрипт (PHP, Node.js или Python) и два веб‑хука.

1. Веб‑хук Telegram

• С помощью метода setWebhook укажите URL вашего скрипта: https://example.com/bitrix-telegram.php. Пример запроса:

  https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://example.com/bitrix-telegram.php
  

• Telegram будет присылать POST‑запросы с JSON‑полем message каждый раз, когда пользователь пишет боту.

2. Веб‑хук Bitrix24

• В ранее созданном входящем веб‑хукe Bitrix24 укажите тот же URL (или отдельный, если хотите разделять логику). В запросах к Bitrix24 будет использоваться параметр auth с токеном веб‑хука.
• Для получения данных о сделке, клиенте или задачи используйте метод crm.deal.get и аналогичные.

Таблица сопоставления методов

Типовые сценарии использования

После того как каналы связи настроены, можно реализовать готовые бизнес‑процессы без глубокого программирования.

• Запрос информации о клиенте. Пользователь пишет /client 123, скрипт парсит ID, делает запрос crm.contact.get и возвращает в Telegram ФИО, телефон и статус.
• Создание сделки в один клик. При вводе /deal Тестовая сделка 50000 система формирует объект crm.deal.add с полями Название, Сумма, Ответственный (по умолчанию текущий пользователь).
• Уведомление о новых лидах. В Bitrix24 настраивается бизнес‑процесс, который при появлении нового лида отправляет POST‑запрос в Telegram‑бот, а тот рассылает сообщение в группу менеджеров.
• Автоматическое закрытие задач. Когда в Telegram приходит команда /close 456, скрипт меняет статус задачи task.item.update на “Завершено”.

Все сценарии используют одну точку входа скрипта, поэтому удобно поддерживать их в виде switch‑блоков по командам. При необходимости добавьте логирование в файл log.txt — это поможет быстро отлавливать ошибки в продакшене.

Типичные ошибки и чек‑лист перед запуском

Ниже перечислены проблемы, с которыми часто сталкиваются при первой попытке соединить Bitrix24 и Telegram, и рекомендации по их устранению.

1. Неправильный URL веб‑хука. Убедитесь, что ваш сервер доступен по HTTPS, сертификат действителен, а путь точно совпадает с тем, что указали в setWebhook.
2. Отсутствие прав у веб‑хука Bitrix24. Если запросы к CRM возвращают ошибку 403, проверьте список прав в настройках веб‑хука и добавьте недостающие.
3. Токен Telegram‑бота раскрыт публично. Храните токен в переменной окружения или в отдельном конфигурационном файле, недоступном из веб‑доступа.
4. Необработанные типы сообщений. По умолчанию скрипт реагирует только на текст. Если пользователь отправляет фото или кнопку, добавьте проверку if (isset($update[‘message’][‘photo’])) ….
5. Слишком длинные ответы. Telegram ограничивает сообщения 4096 символами. При выводе списка сделок разбейте ответ на несколько сообщений или используйте sendDocument с CSV‑файлом.

Перед запуском в продакшн выполните тестовый проход:

• Отправьте несколько команд в чат бота и проверьте корректность ответов.
• Смотрите логи сервера: отсутствие ошибок 500 Internal Server Error и 403 Forbidden гарантирует стабильную работу.
• Проверьте, что в Bitrix24 создаются/обновляются только те сущности, которые вы планировали (используйте тестовые контакты).

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

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

В Bitrix24 откройте CRM → Контакты, создайте запись с Telegram‑логином в пользовательском поле. В скрипте добавьте запрос user.get по этому полю и используйте sendMessage с полученным chat_id.

Можно ли ограничить доступ к боту только внутри компании?

Да. В настройках BotFather задайте параметр privacy_mode — выключите, чтобы бот получал сообщения только от тех, кто явно начал с ним диалог. Дополнительно проверяйте user_id в скрипте и сравнивайте его с внутренним справочником Bitrix24.

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

Создайте бизнес‑процесс в Bitrix24 с действием “Веб‑запрос”. В качестве URL укажите ваш скрипт‑обработчик, а в теле запроса передайте данные лида. Скрипт сразу формирует сообщение в Telegram.

Что делать, если бот перестал отвечать после обновления Bitrix24?

Проверьте, не изменились ли версии API. На момент публикации Bitrix24 поддерживает версии 2.0 и 2.1. Если обновление затронуло структуру полей, скорректируйте запросы в скрипте согласно новой схеме.

Интеграция Bitrix24 с Telegram‑ботом открывает новые возможности для быстрого доступа к клиентской информации и автоматизации рутинных задач. Если вы хотите избавиться от «ручных» переключений между CRM и мессенджером, D7 поможет спроектировать и внедрить решение под ваш бизнес. Узнайте подробнее о внедрении CRM или сразу закажите услуги по настройке интеграций.