Розробка 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-бота під ключ з гарантією якості.