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

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

Покупці дедалі частіше переважають отримувати сповіщення про замовлення в Telegram або WhatsApp замість email. Рівень конверсії вищий: повідомлення приходить миттєво, відкривається в 5–10 разів частіше за email. Модуль інтеграції з мессенджерами підключає ці канали до подій Bitrix.

Підтримувані мессенджери

• Telegram — через Bot API (простий, безплатний, надійний)
• WhatsApp — через Meta Cloud API або сторонніх провайдерів
• VK Notify — через VK Mini Apps API
• Viber — через Viber REST API

Архітектура модуля

Модульна структура з адаптерами провайдерів:

local/modules/vendor.messengers/
├── lib/Provider/
│   ├── TelegramProvider.php
│   ├── WhatsAppProvider.php
│   └── AbstractProvider.php
├── EventHandler.php
└── install/db/install.sql

Установка Telegram-бота

Створити бота через @BotFather → отримати API-токен → налаштувати webhook або polling. На подіях замовлення надсилати повідомлення:

class TelegramProvider
{
    public function sendMessage(string $chatId, string $text): bool
    {
        $url = "https://api.telegram.org/bot{$this->token}/sendMessage";
        // POST-запит із chat_id та text
    }
}

Обробники подій

Підключити до подій замовлення:

• OnSaleOrderPaid — "Замовлення оплачено"
• OnSaleShipmentShipOrder — "Ваше замовлення відправлено"
• OnSaleOrderCanceled — "Замовлення скасовано"

Шаблони повідомлень налаштовуються в налаштуваннях модуля з підстановкою змінних: {ORDER_ID}, {TOTAL}, {DELIVERY_DATE} тощо.

Уподобання користувача

Користувачі встановлюють переважний мессенджер в особистому кабінеті → номер телефону або ім'я користувача Telegram → вибір отримання сповіщень.

Терміни розроблення