Розробка Telegram-бота з інтеграцією Бітрікс24

Коли клієнт пише в Telegram, а оператор зайнятий — час відповіді зростає

Розкажу на прикладі: клієнт хоче дізнатися статус замовлення, але оператор вже говорить з іншим. Поки перемикається, клієнт чекає хвилини. А якщо це повторюється десятки разів на день — губляться і час, і нерви. Ми автоматизуємо такі сценарії за допомогою Telegram-бота, інтегрованого з Бітрікс24 через REST API. Бот обробляє типові запити за секунди: перевіряє статус, записує на послугу, надсилає сповіщення Telegram. Оператор займається лише складними питаннями.

Такий підхід знижує навантаження на кол-центр і прискорює обслуговування без додаткових співробітників. Інтеграція через REST API дозволяє боту напряму працювати з CRM, завданнями та календарем — без посередників. Це справжній CRM-бот для автоматизації продажів та клієнтського сервісу.

Як Telegram-бот інтегрується з Бітрікс24?

Є два підходи. Перший — через відкриті лінії Бітрікс24: бот підключається в розділі «Контакт-центр → Відкриті лінії → Підключити канали → Telegram». Повідомлення потрапляють у чергу операторів. Просте налаштування, але бот — ретранслятор. Другий — самостійний бот на окремому сервері: він отримує повідомлення через Telegram Bot API (webhook), сам обробляє сценарії та викликає REST API Бітрікс24. Повний контроль над логікою.

Чому самостійний бот надійніший за відкриті лінії?

Відкриті лінії не дають гнучкості, коли потрібна автоматизація (створення лідів, перевірка статусів, запис на послуги). Самостійний бот відкриває доступ до CRM, завдань і календаря через REST API. Ми використовуємо Python + aiogram 3, Redis для станів, PostgreSQL для логів. Вебхуки захищені секретним токеном.

Згідно з документацією Telegram Bot API, вебхуки — кращий спосіб отримання оновлень у реальному часі.

Архітектура самостійного бота

Клієнт у Telegram
      ↓
Telegram Bot API (webhook)
      ↓
Сервер бота (Python aiogram / Node.js telegraf)
      ↓ ↓ ↓
  Логіка    Бітрікс24 REST API    Зовнішні сервіси
  бота      (crm.*, im.*, tasks.*)   (1С, склад, etc.)

Сервер отримує update від Telegram, визначає intent користувача (FSM або NLP), виконує потрібні дії в Бітрікс24, повертає відповідь у Telegram.

Ключові інтеграційні точки з Бітрікс24

Ідентифікація клієнта

При першому зверненні бот запитує телефон через KeyboardButton(request_contact=True). Отриманий номер використовується для пошуку контакту в CRM: crm.contact.list з фільтром PHONE. Якщо знайдено — прив'язує telegram_id до UF_CRM_TELEGRAM_ID. Якщо ні — створює новий контакт.

Приклад запиту до REST API:

POST /rest/crm.contact.list
{
  "filter": { "PHONE": "+380501234567" },
  "select": ["ID", "NAME", "UF_CRM_TELEGRAM_ID"]
}

Створення лідів і угод

Кожне нове звернення створює лід: crm.lead.add з SOURCE_ID = 'MESSENGER' та UTM_SOURCE = 'telegram'. Усі повідомлення пишуться в коментар ліда через crm.timeline.comment.add.

Статус замовлення

Бот приймає номер замовлення → робить запит crm.deal.list по UF_ORDER_NUMBER → повертає стадію та очікувану дату. Клієнт отримує відповідь за 2-3 секунди без оператора.

Запис на послугу

Бот показує доступні слоти з модуля Розклад Бітрікс24 через calendar.accessibility.get → клієнт обирає час → створюється зустріч calendar.event.add з прив'язкою до контакту.

Передача складних запитів оператору

Якщо бот не може обробити запит, переводить на оператора. Правильна реалізація:

1. Бот зберігає історію діалогу (останні N повідомлень) у Redis.
2. Створює звернення у відкритій лінії через imopenlines.crm.chat.getLink або прямим створенням чату через im.chat.add.
3. Надсилає історію першим повідомленням, щоб оператор бачив контекст.
4. Клієнт продовжує переписку в Telegram, оператор відповідає з Бітрікс24.

Кейс з практики: бот для мережі автосервісів (наш клієнт)

З нашої практики: наш клієнт — мережа з 12 автосервісів, клієнти хочуть записуватися на ТО через Telegram, перевіряти готовність автомобіля, отримувати чек.

Сценарії бота:

• Запис на ТО → вибір точки (інлайн-кнопки) → вибір послуги → вибір дати/часу з розкладу Бітрікс24 → підтвердження → SMS-нагадування за день.
• Статус ремонту → введення номера авто → запит до crm.deal.list по UF_CAR_NUMBER → поточний етап зі стадії угоди.
• Готовність авто → автоматичне сповіщення при зміні стадії на «Готовий до видачі» (тригер через crm.deal.onUpdate → вебхук на сервер бота → bot.send_message).

Технічний стек: Python + aiogram 3 + Redis (FSM) + PostgreSQL (логування) + Bitrix24 REST.

Проблема: Telegram обмежує частоту відправки — не більше 30 повідомлень на секунду в різні чати. При масовій розсилці сповіщень потрібна черга із затримками. Вирішили через Redis-чергу з троттлінгом.

Результат: Час запису клієнта скоротився з 5 хвилин до 30 секунд — у 10 разів швидше, ніж при ручному опрацюванні. Отже, бот виконує запис у 10 разів швидше, ніж оператор, і обробляє запити в 10 разів швидше. Навантаження на кол-центр знизилося на 70%. Економія становить більше 600 000 грн на рік для мережі з 12 точок, що дорівнює економії понад $20 000 на рік. Вартість впровадження починається від $2000, тому інвестиція окупається за кілька місяців.

Наша команда

Ми маємо 5+ років досвіду в розробці ботів для бізнесу та інтеграції з CRM, реалізовано 30+ проектів. Використовуємо сучасні технології: асинхронний Python, Redis, PostgreSQL, контейнеризацію Docker. Гарантуємо безперебійну роботу бота та надаємо сертифікати від Bitrix24 для підтвердження кваліфікації.

Що входить у роботу

• Архітектура та проектування сценаріїв (FSM, інтеграційні точки).
• Розробка серверної частини (Python/Node.js) з використанням Telegram Bot API та REST API Бітрікс24.
• Налаштування вебхуків, деплой (Docker, Nginx, SSL).
• Тестування всіх сценаріїв: ідентифікація, запис, статус, передача оператору.
• Моніторинг та логування помилок (Sentinel, Prometheus).
• Документація з експлуатації та навчання команди.

Терміни орієнтовно

Вартість впровадження починається від $2000, але економія на операторах окупає інвестиції за кілька місяців. Зв'яжіться з нами для обговорення деталей. Замовте консультацію — оцінимо проєкт за один день. Ми виконуємо розробку Telegram-бота під ключ з гарантією якості.

Як відкриті лінії змінюють комунікацію?

Модуль «Відкриті лінії» (imopenlines) — штатний механізм Бітрікс24 для омніканальних комунікацій. Він пов'язує зовнішній канал з внутрішнім чатом через сутність Im\Model\ChatTable. Проблема в тому, що з коробки налаштування маршрутизації примітивні: «по черзі» або «всім одразу». Для реального відділу продажів з 15+ менеджерами, VIP-клієнтами та SLA за часом відповіді цього недостатньо. Ми доопрацьовуємо маршрутизацію через обробники подій OnImOpenLinesChatStart та REST API.

Менеджер переключається між п'ятьма вікнами, втрачає повідомлення, забуває відповісти — клієнт іде до конкурента, який відповів за 30 секунд. Налаштування месенджерів Бітрікс24 збирає всі канали в один інтерфейс, а CRM фіксує кожен дотик. Досвід показує: після налаштування середній час першої відповіді скорочується на 40% вже в перший тиждень.

Як ми реалізуємо інтеграцію месенджерів

Підключаємо Telegram, WhatsApp, Viber, VK, онлайн-чат, Email та інші канали через штатні конектори або REST API. Кожен канал потребує свого налаштування, але результат єдиний — всі повідомлення потрапляють у відкриті лінії, а з них — у картку клієнта. Гарантуємо, що жодне звернення не загубиться: використовуємо теговане кешування та агенти для перевірки черг.

Як підключити WhatsApp до Бітрікс24?

WhatsApp — головний бізнес-канал. Інтеграція через WhatsApp Business API з верифікованим акаунтом. Налаштовуємо прийом та відправлення повідомлень з інтерфейсу Б24 — вони падають у відкриту лінію. Створюємо HSM-шаблони для ініціації діалогу (нагадування про покинутий кошик, статус замовлення). Шаблони проходять модерацію Meta — закладайте 2-3 дні. Забезпечуємо передачу файлів, зображень, документів. Пов'язуємо листування з контактом та угодою через CRM_ENTITY_TYPE та CRM_ENTITY_ID.

Telegram: безкоштовний канал з високим охопленням

Telegram Bot API безкоштовний і добре документований — приємна рідкість серед месенджерів. Інтеграція в Бітрікс24 виконується через конектор imopenlines. Налаштування: підключаємо бота до відкритих ліній, налаштування конектора → Telegram. Прийом повідомлень, фото, відео, документів — все маппиться в чат Б24. Inline-кнопки та reply-клавіатури для навігації. Webhook для реєстрації конектора. Інтеграція з CRM: вхідне повідомлення створює лід через crm.lead.add або активність в угоді.

Telegram незамінний для:

• Підтримки через бота — типові питання закриваються без оператора (до 70% звернень).
• Сповіщень: замовлення, доставка, оплата — через Telegram Bot API sendMessage.
• Збору лідів: бот задає кваліфікуючі питання → створює лід.

Viber та VK: аудиторія 35+ та соцмережа

Viber тримає позиції в регіонах. Підключаємо бізнес-акаунт через конектор відкритих ліній. Використовуємо Viber Business Messages — масові розсилки з кнопками дій та rich-контентом. Прийом та відправлення з CRM працюють одразу.

VK (ВКонтакті) — найбільша соцмережа. Інтеграція через конектор imopenlines повідомлень спільноти. Обробка повідомлень та коментарів з єдиного інтерфейсу. Автостворення ліда — обробник OnImOpenLinesCrmCreate. Інтеграція з VK Рекламою для трекінгу джерел через UTM. Бот для авто-відповідей — VK Bot API + Callback API.

Чому важлива правильна маршрутизація звернень?

Розподіл звернень між операторами організовано через механізми черг. За замовчуванням — «хто вільний». У реальності потрібно складніше:

• Визначення відповідального за номером або email з CRM — im.chat.get + пошук по crm.contact.list.
• Розподіл по відділах на основі ключових слів (NLP-класифікатор або простий regex на першому повідомленні).
• Пріоритетна черга для VIP — по сегменту в CRM.
• Ескалація при таймауті 5 хвилин — автопереключення на наступного.
• Перехід на дзвінок прямо з чату — telephony.externalcall.register.

Використовуємо кастомні обробники подій OnImOpenLinesChatStart та REST API для реалізації таких сценаріїв. Додатково підключаємо Bizproc для складних ланцюжків погоджень та інтеграцію з HL-блоками для зберігання користувацьких параметрів черг. Результат: клієнт не чекає, оператор не перевантажений.

Що входить у роботу з інтеграції месенджерів

Чат-боти: сценарні та з NLP

Типи

Сценарні (rule-based): кнопкове меню, дерево рішень. «Як оплатити» → «Де моє замовлення» → «Години роботи». Передача на оператора при intent == 'unknown' → transfer_to_queue. Надійно, передбачувано, покриває 60-70% типових звернень.

З NLP: вільний текст на українській або російській. Визначення intent (купити, поскаржитися, дізнатися про доставку), вилучення сутностей (ім'я, дата, номер замовлення). Контекстний діалог — пам'ятає, про що говорили. Реалізуємо на Rasa або Dialogflow, інтеграція з Б24 через REST.

use Bitrix\Main\Loader;
use Bitrix\Imopenlines\Model\SessionTable;

Loader::includeModule('imopenlines');

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler('imopenlines', 'OnImOpenLinesMessageReceive', function($event) {
    $message = $event->getParameter('message');
    $chatId = $event->getParameter('chatId');
    
    if (preg_match('/статус заказа (\d+)/i', $message, $matches)) {
        $orderId = $matches[1];
        // Отримуємо статус замовлення через API
        $order = \Bitrix\Sale\Order::load($orderId);
        if ($order) {
            $status = $order->getField('STATUS_ID');
            \Bitrix\ImOpenLines\Chat::sendMessage($chatId, 'Ваш заказ №' . $orderId . ' в статусе: ' . $status);
        }
    }
});

Сценарії та реальний ефект

Порівняння: сценарний бот обробляє запити в 5 разів швидше оператора, а NLP-бот знижує fallback rate до 15% після навчання на реальних діалогах. Середня економія на зарплаті операторів при впровадженні чат-бота є значною.

Процес розробки

1. Аналіз звернень — вивантажуємо історію з відкритих ліній, кластеризуємо за темами. Визначаємо 80% типових запитів.
2. Проектування діалогів — карта на miro/figma. Кожна гілка закінчується або відповіддю, або передачею оператору.
3. Розробка — логіка, інтеграція з CRM та зовнішніми API. Для сценарних — кінцевий автомат на станах. Для NLP — pipeline: tokenizer → featurizer → classifier → response selector.
4. Навчання NLP — на реальних діалогах (не менше 500 прикладів). Налаштування threshold confidence.
5. Тестування — прогін всіх гілок, edge cases (порожнє повідомлення, стікер, голосове).
6. Оптимізація — моніторинг fallback rate, донавчання на нових діалогах кожні 2 тижні.

Терміни

Результат — всі звернення в єдиному вікні, рутина автоматизована, жодне повідомлення не губиться. Менеджери продають, а не шукають потрібний чат. Оцініть, які канали потрібні саме вам, — напишіть, підберемо під вашу нішу. Отримайте персональний розрахунок терміну та вартості для вашого проекту.