Разработка модуля интеграции с мессенджерами 1С-Битрикс

local/modules/vendor.messenger/
├── lib/
│   ├── Channel/
│   │   ├── TelegramChannel.php
│   │   ├── WhatsappChannel.php
│   │   └── ChannelInterface.php
│   ├── NotificationRouter.php # Выбор канала для отправки
│   ├── TemplateEngine.php # Шаблонизатор сообщений
│   └── SubscriptionManager.php # Управление подписками
└── install/db/install.sql

Таблица b_messenger_subscription — привязка пользователей к каналам:

Как работает привязка Telegram-аккаунта

1. Пользователь в личном кабинете нажимает «Привязать Telegram».
2. Система генерирует одноразовый код и ссылку https://t.me/yourbot?start=CODE123.
3. Пользователь переходит в бота, отправляет /start CODE123.
4. Бот через Webhook получает сообщение, находит запись по коду в таблице b_messenger_link_token и сохраняет chat_id в b_messenger_subscription.

Весь процесс занимает 2–3 секунды.

CREATE TABLE b_messenger_link_token (
    TOKEN varchar(32) NOT NULL,
    USER_ID int NOT NULL,
    CHANNEL varchar(50) NOT NULL,
    EXPIRES_AT datetime NOT NULL,
    PRIMARY KEY (TOKEN)
);

Webhook для входящих сообщений

Telegram отправляет обновления на URL вида /api/telegram/webhook/. В Битрикс это обрабатывается через кастомный обработчик:

// local/api/telegram/webhook/index.php
$update = json_decode(file_get_contents('php://input'), true);
if (isset($update['message'])) {
    \Vendor\Messenger\TelegramWebhookHandler::handle($update);
}

Обработчик разбирает входящее сообщение: если это /start TOKEN — привязывает аккаунт. Если это текстовый запрос — передаёт в чат-логику (если реализован чат-бот для поддержки).

Отправка уведомлений

Уведомления привязываются к событиям Битрикс через почтовые события или напрямую через обработчики:

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'sale',
    'OnSaleStatusOrder',
    [NotificationRouter::class, 'onOrderStatusChange']
);

Метод onOrderStatusChange определяет нужный канал для пользователя, формирует сообщение из шаблона и отправляет. Для отправки в Telegram:

$response = \Bitrix\Main\Web\HttpClient::post(
    "https://api.telegram.org/bot{$token}/sendMessage",
    json_encode([
        'chat_id' => $chatId,
        'text' => $message,
        'parse_mode' => 'HTML',
    ]),
    ['Content-Type' => 'application/json']
);

Документация Telegram Bot API: https://core.telegram.org/bots/api

Шаблоны сообщений: структура и настройка

Шаблоны сообщений для каждого события и каждого канала хранятся в таблице b_messenger_template. Поддерживаются переменные в стиле {{order_id}}, {{status}}, {{tracking_number}}. Редактирование шаблонов доступно в административной части.

Для Telegram поддерживается HTML-форматирование (<b>, <i>, <a>). Для WhatsApp — только звёздочки для жирного (*text*).

Очередь отправки

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

Cron-задача каждую минуту обрабатывает очередь, повторяет неудачные попытки с экспоненциальной задержкой.

Включено в разработку модуля

• Анализ ваших бизнес-процессов и выбор каналов.
• Проектирование архитектуры: таблицы, обработчики, шаблоны.
• Разработка интеграции с Telegram и WhatsApp (базовый).
• Настройка очереди отправки с повторными попытками.
• Создание 5–7 шаблонов уведомлений под ваши события (заказ, оплата, отгрузка).
• Документация по эксплуатации и обучение вашего администратора.
• Поддержка в течение 30 дней после запуска.

Сроки разработки

Получите консультацию по вашему проекту — оценим объём работ и предложим оптимальное решение. Мы гарантируем стабильную работу модуля под нагрузкой и оперативную поддержку. Наш опыт работы с Битрикс превышает 10 лет. Разработка под Битрикс и битрикс разработка модулей — наша специализация. Экономия на поддержке при внедрении такого модуля может составить более $270–390 в месяц при потоке 1000 заказов.