Интеграция Битрикс24 с Telegram-ботом для автоматизации обработки входящих лидов

Общие кейсы автоматизации

В практике внедрений встречаются задачи автоматизации первичного клиентского контакта, особенно в каналах мессенджеров. Telegram — один из популярных инструментов для сбора обращений. Интеграция Telegram-бота с Битрикс24 позволяет:

• автоматически создавать лиды в CRM на основе сообщений пользователя,
• выстраивать квалификацию лидов через диалоговые сценарии,
• настраивать автоматическую маршрутизацию обращений по ответственным,
• осуществлять быстрые отклики через встроенные уведомления в CRM.

Техническая схема интеграции

В данной статье рассматривается реализация на облачной версии Битрикс24 с использованием REST API. Telegram выступает в роли внешнего инициатора событий, отправляя пользовательские сообщения на webhook сервера, который в свою очередь обращается к Bitrix24 по REST API и инициирует создание лида либо выполнение других операций.

Основные компоненты схемы

• Telegram Bot API: прием входящих сообщений через webhook.
• HTTP-сервер (например, на базе PHP или Node.js) для обработки webhook и взаимодействия с API Bitrix24.
• REST API Битрикс24: создание сущностей CRM и запуск бизнес-процессов.

Пример реализации: создание лида из Telegram-сообщения

Подготовка Telegram-бота

1. Создан бот через BotFather, получен токен.
2. Установлена точка входа webhook, например: https://example.com/telegram-webhook

Структура запроса от Telegram

Webhook Telegram присылает POST-запрос вида:

{
  "message": {
    "message_id": 123,
    "from": {
      "id": 987654321,
      "first_name": "Имя",
      "username": "user123"
    },
    "chat": {
      "id": 987654321,
      "type": "private"
    },
    "text": "Хочу консультацию"
  }
}

Обработка webhook и создание лида

PHP-пример, обрабатывающий вход, формирующий лид и отправляющий его в Битрикс24:

 [
            'TITLE' => 'Заявка из Telegram',
            'NAME' => $name,
            'OPENED' => 'Y',
            'STATUS_ID' => 'NEW',
            'SOURCE_ID' => 'WEB',
            'COMMENTS' => "Сообщение: $message\nТелеграм: @$username",
        ]
    ];

    // Отправка в Bitrix24
    $options = [
        'http' => [
            'header' => "Content-type: application/json\r\n",
            'method' => 'POST',
            'content' => json_encode($lead),
        ]
    ];
    $context = stream_context_create($options);
    $result = file_get_contents(WEBHOOK_URL, false, $context);
}
?>

Бизнес-логика в CRM

После создания лида возможна реализация дальнейшей логики с помощью стандартных средств облачного Битрикс24:

• настройка роботов в воронке лидов (автоматические уведомления, постановка задач, создание сделок),
• запуск бизнес-процессов на основе создаваемой записи (квалификация, распределение),
• использование вебхуков для обратной связи с ботом (отправка подтверждений).

Пример робота: уведомление ответственного

В CRM-лидах на стадии «Новый» добавляется робот с действием «Отправить уведомление» с текстом: «Новый лид из Telegram: #[Лид.Имя]#».

Типовые ошибки

• Некорректно указан webhook: требуется использовать URL строго в формате webhook-интерфейса Битрикс24.
• Ошибки сетевой доступности: Telegram требует публично доступный HTTPS webhook, сертификат должен быть валиден.
• Отсутствие обработки ошибок API: при отказе Bitrix24 API желательно логировать ошибки запроса.
• Жесткая логика обработки: рекомендуется использовать полноценные сценарии и шаблоны (например, на базе DialogFlow или кастомных FSM).

FAQ

Можно ли подключить нескольких Telegram-ботов?

Да, возможно использовать разные webhook-и и обрабатывать их на одном сервере с разделением логики по токену или URL.

Можно ли отправлять сообщения обратно из Битрикс24?

Да, через Telegram Bot API возможно отправлять ответы, используя endpoint sendMessage с идентификатором чата.

Поддерживается ли распознавание команд?

Да, логика бота может включать парсинг команд (/start, /help и т.д.) и адаптацию поведения.

Хранится ли история переписки в CRM?

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

Какие права требуются для вебхуков?

Для создания лидов достаточно базового webhook-а с доступом к crm.lead.add.

Итоги

Интеграция Битрикс24 с Telegram-ботом на базе REST API — практичное решение для автоматизации первичного контакта. Такой подход позволяет создавать лиды в CRM без участия менеджера, масштабировать поток обращений и запускать сценарии обработки без сторонних форм. Для стабильной работы рекомендуется организованная архитектура обработки входов, централизованная логика webhook и тщательная отладка сценариев бизнес-логики. В качестве расширений возможна реализация авторизации пользователя на стороне бота, интеграция с внешними NLP-сервисами или сбор аналитики переписки.

Обсудим вашу задачу?

Если потребуется оценка объёма работ по подобной интеграции, можно обсудить технические детали и подходы к реализации. Перед стартом обычно уточняются:

• ожидаемая логика работы бота и сценарии маршрутизации сообщений,
• наличие доступа к CRM и требованиям к REST API-интеграции,
• техническая инфраструктура для размещения webhook-сервиса.