Битрикс24 + Telegram: Полный гайд по интеграции через вебхуки

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

Как это работает: общая схема

Интеграция строится на взаимодействии трех элементов:

Битрикс24: выступает инициатором. Когда происходит событие (например, создание лида), Битрикс отправляет HTTP-запрос (вебхук) на ваш сервер.
Ваш сервер (Middleware): принимает запрос, обрабатывает данные и формирует команду для Telegram.
Telegram Bot API: получает команду от вашего сервера и доставляет сообщение конечному пользователю.

Шаг 1: Регистрация бота в Telegram

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

Найдите в Telegram пользователя @BotFather.
Отправьте команду /newbot.
Следуйте инструкциям: придумайте имя (Display Name) и уникальный юзернейм (Username), заканчивающийся на [i][i][i]`_bot`[/i][/i][/i].
Важно: Сохраните полученный API Token. Это ваш ключ к управлению ботом.

Шаг 2: Подготовка сервера-прослойки

Чтобы Битрикс24 мог «достучаться» до вашего кода, сервер должен быть доступен из интернета по HTTPS. Для локальной разработки используйте Ngrok.

Ниже приведен минимальный пример на PHP, который принимает вебхук от Битрикс24 и пересылает его в Telegram.

Simple Telegram Notifier (PHP)

<?php
/**
- Простейший обработчик вебхука Битрикс24 для отправки уведомлений в Telegram
*/

// 1. Конфигурация
$telegramToken = 'ВАШ_ТОКЕН_ОТ_BOTFATHER';
$chatId = 'ID_ЧАТА_ИЛИ_ПОЛЬЗОВАТЕЛЯ'; // Кому отправляем

// 2. Получаем данные от Битрикс24
// В зависимости от типа вебхука, данные могут быть в $_REQUEST или php://input
$event = $_REQUEST['event'] ?? 'unknown';
$data = $_REQUEST['data'] ?? [];

// 3. Формируем текст сообщения
$message = " Новое событие в Битрикс24!

";
$message .= "Тип события: $event
";

if (!empty($data)) {
    $message .= "Данные: " . json_encode($data, JSON_UNESCAPED_UNICODE);
}

// 4. Отправка в Telegram через cURL
$url = "[url=https://api.telegram.org/bot%7B$telegramToken%7D/sendMessage]https://api.telegram.org/bot%7B$telegramToken%7D/sendMessage[/url]";
$payload = [
    'chat_id' => $chatId,
    'text' => $message,
    'parse_mode' => 'HTML'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$response = curl_exec($ch);
curl_close($ch);

// 5. Всегда отвечаем Битрикс24 200 OK
http_response_code(200);
echo "Notification sent";
?>

Шаг 3: Настройка исходящего вебхука в Битрикс24

Теперь нужно сказать Битрикс24, куда именно отправлять данные.

Перейдите в раздел Разработчикам → Другое → Исходящий вебхук.
Выберите Робот (или событие, которое вас интересует, например, "Создание лида").
В поле URL обработчика вставьте адрес вашего сервера (например, [i][i][i]`https://your-domain.com/telegram_handler.php`[/i][/i][/i] или адрес от Ngrok).
Нажмите Сохранить.