Інтеграція Бітрікс24 з телефонією Білайн Бізнес
Ми постійно бачимо, як компанії втрачають дані дзвінків через відсутність інтеграції. Корпоративна телефонія Білайн Бізнес працює або через віртуальну АТС (Віртуальний офіс), або через прості SIM-карти. Обидва варіанти можна під'єднати до Бітрікс24, але підходи суттєво різняться. За 4 роки ми виконали понад 50 інтеграцій і накопичили готові рішення для кожного сценарію. У цій статті розберемо, як правильно налаштувати з'єднання, щоб не втратити жодного дзвінка та отримати повну аналітику.
Згідно з документацією Бітрікс24, інтеграція із зовнішніми АТС здійснюється через REST-метод telephony.externalCall.register.
Як інтегрувати віртуальний офіс Білайн з Бітрікс24?
Віртуальний офіс (хмарна ВАТС) надає API та webhooks для подій дзвінків. Налаштування починається із запиту доступу у техпідтримки Білайн або через партнерську програму. В особистому кабінеті ВАТС у розділі Налаштування → Інтеграції → API вказуємо URL вашого обробника та секрет для підпису. Білайн надсилає події у форматі JSON з HMAC-SHA256 у заголовку X-Beeline-Signature. Обробник повинен реєструвати дзвінки в Бітрікс24 через REST-метод telephony.externalCall.register.
Таблиця підтримуваних подій:
| Подія |
Тригер |
call.start |
Вхідний виклик зареєстровано |
call.answer |
Співробітник відповів |
call.end |
Розмову завершено |
call.record_ready |
Запис готовий до завантаження |
Після реєстрації викликаємо telephony.externalCall.attachRecord для прикріплення аудіо. Термін зберігання запису в хмарі Білайн — від 7 днів до року, залежить від тарифу.
Як налаштувати обробник подій?
- Створіть скрипт на PHP, який приймає POST-запити від Білайн.
- Перевірте HMAC-підпис у заголовку
X-Beeline-Signature.
- Розберіть JSON та зареєструйте дзвінок через
telephony.externalCall.register.
- За подією
call.record_ready завантажте запис і прикріпіть його через telephony.externalCall.attachRecord.
- Налаштуйте логування помилок та моніторинг.
Що робити, якщо використовуються корпоративні SIM без ВАТС?
Без віртуальної АТС події дзвінків недоступні безпосередньо. Є три рішення:
-
Перехід на Віртуальний офіс — мобільні номери стають внутрішніми, інтеграція через API.
-
GSM-шлюз — апаратний конвертер SIM у SIP, підключається до будь-якої АТС, у тому числі до Бітрікс24 напряму.
-
Хмарні SIM-конектори — сервіси (SimCom та ін.) віртуалізують SIM та надають SIP-інтерфейс.
Другий варіант зазвичай дешевший: вартість шлюзу — від 5 000 до 15 000 грн одноразово, тоді як перехід на ВАТС може коштувати 20 000+ грн на місяць. Однак ВАТС забезпечує в 2-3 рази швидшу обробку даних дзвінків завдяки прямому API.
Налаштування через офіційний додаток Білайн у Бітрікс24
Білайн та Бітрікс24 — партнери. У розділі «Телефонія» Бітрікс24 обираємо «Підключити телефонію» → додаток «Білайн Бізнес». Авторизуємося корпоративним акаунтом, зіставляємо внутрішні номери з користувачами. Цей спосіб підходить для компаній, які вже використовують Віртуальний офіс.
Порівняння API-інтеграції та додатку
| Параметр |
API через webhooks |
Додаток Білайн |
| Гнучкість |
Повний контроль над обробником |
Обмежено налаштуваннями додатку |
| Швидкість впровадження |
2–5 днів на розробку |
1 день |
| Підтримка нестандартних сценаріїв |
Так |
Ні |
| Залежність від партнерського доступу |
Так |
Ні |
| Продуктивність |
Обробка до 1000 дзвінків/хв |
До 100 дзвінків/хв |
Ми рекомендуємо API-інтеграцію, якщо потрібна складна маршрутизація або аналітика на стороні Бітрікс24. API-рішення у 2-3 рази швидше обробляє великі обсяги порівняно з додатком.
Типові помилки при інтеграції
- Неправильний HMAC-підпис: перевірте секрет та алгоритм (SHA256).
- Діапазон IP-адрес Білайн: додайте їх до білого списку сервера.
- Таймаути: обробник повинен відповідати протягом 5 секунд, інакше Білайн повторює запит.
- Втрата подій: налаштуйте чергу на Redis або RabbitMQ.
Що входить в роботу
В рамках інтеграції ми виконуємо повний цикл робіт: від аудиту поточної схеми до передачі в експлуатацію. Ось що конкретно входить:
- Документування схеми дзвінків та розподілу номерів.
- Налаштування обробника подій на вашому сервері (PHP, можна на базі нашого модуля).
- Мапінг номерів на користувачів Бітрікс24.
- Тестування всіх сценаріїв: вхідний, вихідний, переклад, запис.
- Навчання адміністраторів та відповіді на питання протягом тижня після здачі.
- Пост-релізна підтримка та доробки за зауваженнями.
Після завершення ви отримуєте інструкцію з обслуговування та схему обробки помилок.
З нашої практики: торговий холдинг у 6 містах
Федеральна торгова мережа — наш клієнт — мала офіси в 6 містах, кожен зі своїм акаунтом Білайн ВАТС. Кожен офіс обробляв понад 200 дзвінків на день. Вимагалося бачити дзвінки в одному Бітрікс24, але менеджери кожного міста — лише свої. Ми побудували архітектуру: шість вебхуків на одному сервері, обробник визначає місто за URL та підставляє правильний LINE_NUMBER. Права доступу налаштували через CRM. Нестандартне завдання: при перекладі клієнта з Москви до Санкт-Петербурга дзвінок мав потрапити пітерському менеджеру. Вирішили через подію перекладу у ВАТС — обробник створював новий дзвінок з вірним офісом. Результат: пропущені дзвінки знизилися на 30%, економія на обробці вхідних склала до 40% на місяць. Термін виконання — 8 робочих днів, включаючи узгодження з Білайн по кожному акаунту.
Зв'яжіться з нами для безкоштовної оцінки вашого сценарію. Отримайте консультацію інженера з інтеграції.
Терміни та як замовити
Термін інтеграції одного офісу — від 3 до 7 днів. Для складних схем (як у кейсі) — до 10 робочих днів. Вартість — від 15 000 до 30 000 грн залежно від складності. Оцінимо ваш сценарій безкоштовно — зв'яжіться з нами. Працюємо офіційно, з гарантією. Отримайте точний розрахунок термінів та вартості для вашого сценарію.
Наш досвід — понад 4 роки (з 2019 року) та 50+ впроваджень телефонії Бітрікс24 штатом сертифікованих інженерів. Використовуємо перевірені підходи.
Неправильний вибір редакції 1С-Бітрікс: як це ламає проект
Купили «Малий бізнес», запустили магазин, трафік виріс — і сайт впав. Композитний кеш тільки в «Бізнес», веб-кластер теж. Апгрейд — доплата різниці плюс робота по налаштуванню нових модулів. Правильний підбір та налаштування редакції 1С-Бітрікс одразу економлять значну частину бюджету на ліцензію та виключають витрати на позаплановий апгрейд. За роки роботи з Бітріксом ми провели багато апгрейдів і бачили всі типові помилки: від покупки «Старту» під великий каталог до використання «Бізнесу» для лендінгу з низькою відвідуваністю. Наш принцип — підібрати редакцію під реальні завдання та налаштувати її так, щоб не переплачувати за непотрібні модулі, але й не впиратися в стелю при першому стрибку трафіку.
Редакції 1С-Бітрікс: Управління сайтом
Чотири редакції, і різниця між ними — не в кількості функцій, а в доступних модулях ядра. Офіційна документація 1С-Бітрікс уточнює: композитний кеш доступний лише в редакції «Бізнес» і вище.
| Модуль / можливість |
Старт |
Стандарт |
Малий бізнес |
Бізнес |
| Інформаційні блоки |
+ |
+ |
+ |
+ |
| Веб-форми |
+ |
+ |
+ |
+ |
| Базове SEO |
+ |
+ |
+ |
+ |
| Блог, форум, соцмережа |
– |
+ |
+ |
+ |
Модуль sale (магазин) |
– |
– |
+ |
+ |
Обмін з 1С (catalog) |
– |
– |
+ |
+ |
Композитний кеш (main.composite) |
– |
– |
– |
+ |
Веб-кластер (cluster) |
– |
– |
– |
+ |
| Багатосайтовість |
– |
– |
– |
+ |
| REST API |
– |
– |
– |
+ |
Старт — мінімум, тільки контентні модулі: iblock, form, базове SEO. Для візиток і лендінгів. Модуля sale немає — магазин не побудувати.
Стандарт — контент плюс комунікації: блог, соціальна мережа, форум, розширена техпідтримка. Для корпоративних сайтів і порталів з UGC.
Малий бізнес — перша редакція з e-commerce: з'являється модуль sale. Комфортний стеля — до ~10 000 товарів без серйозної оптимізації. Для невеликих магазинів і каталогів з замовленням.
Бізнес — повний набір: композитний кеш (TTFB падає з 800 мс до 50–80 мс — в 10–15 разів швидше), веб-кластер, багатосайтовість, мультисклад, REST API. Для великих магазинів, маркетплейсів, проектів з 10 000+ відвідувачів на день.
Як не помилитися з вибором редакції 1С-Бітрікс?
Типові помилки
- Покупка «Старту» під інтернет-магазин — модуль sale відсутній, доведеться або апгрейдити одразу, або костилити через кастомні замовлення.
- Вибір «Малого бізнесу» для проекту, який через півроку виросте до 10 000 товарів — композитний кеш не включити, апгрейд до «Бізнесу» обійдеться в різницю ліцензій плюс робота по налаштуванню.
- Використання «Бізнесу» для лендінгу — переплата за функції, які ніколи не знадобляться.
Чому композитний кеш є must have для високонавантаженого проекту?
Композитний кеш (main.composite) прискорює завантаження сторінок в 10–15 разів порівняно з динамічною генерацією. Для магазину з великим трафіком без композиту сервер починає «потіти»: середній час відповіді зростає, база даних перевантажується, сторінки чекауту падають по таймауту. Композит вирішує проблему кардинально — HTML віддається nginx'ом без запуску PHP. Докладніше про технологію — в офіційній документації. Важливо правильно налаштувати exclude-маски для кошика, особистого кабінету та сторінок, де потрібна актуальність даних. Ми налаштовуємо це на кожному апгрейді до «Бізнес».
Вибір редакції для інтернет-магазину
| Тип магазину |
Рекомендована редакція |
Ключове обмеження |
| До 1000 товарів, трафік до 500 уніків/день |
Малий бізнес |
Нема композитного кешу (TTFB > 500 мс при піках) |
| 1000–10 000 товарів, 500–5000 уніків/день |
Малий бізнес з тюнінгом або Бізнес (одразу) |
Навантаження упирається в PHP-FPM |
| 10 000+ товарів, 5000+ уніків/день |
Бізнес |
Потрібен композит + кластер |
| Маркетплейс, 100 000+ товарів |
Бізнес + веб-кластер |
Горизонтальне масштабування обов'язкове |
Як вибрати редакцію: жорсткі критерії
По модулях:
- Обмін з 1С (
catalog) → мінімум «Малий бізнес»
- Композитний кеш (
main.composite) → тільки «Бізнес»
- Веб-кластер (
cluster) → тільки «Бізнес»
- Багатосайтовість → тільки «Бізнес»
- REST API → тільки «Бізнес»
По навантаженню:
- До 1000 уніків/день — будь-яка редакція впорається
- 1000–10 000 уніків/день — «Малий бізнес» з тюнінгом nginx/php-fpm упирається в стелю. «Бізнес» з композитним кешем — правильний вибір
- 10 000+ уніків/день — тільки «Бізнес» з композитом і кластером
По бюджету:
- Різниця між редакціями — варіюється (наприклад, Старт vs Бізнес — значно)
- Апгрейд у будь-який момент — доплата різниці у вартості ліцензій
- Наш принцип: беріть мінімально достатню. Але якщо знаєте, що через півроку знадобиться композит — беріть «Бізнес» одразу, тому що апгрейд — це ще й робота по налаштуванню
Чому апгрейд редакції вигідний при правильному виборі?
1С-Бітрікс дозволяє підвищувати редакцію без перевстановлення — дані зберігаються. Процес:
- Доплата різниці у вартості ліцензії
- Активація нового ключа: «Налаштування» → «Оновлення» → «Реєстрація»
- Встановлення доступних модулів через адмінку
- Налаштування нового функціоналу
- Тестування сумісності
Що ми робимо при апгрейді:
- Перевіряємо кастомний код на конфлікти з новими модулями — особливо якщо є власні обробники подій
OnBeforeOrderAdd, OnSaleBasketSaved
- Вмикаємо та налаштовуємо композитний кеш — коректні exclude-маски для динамічних сторінок (кошик, чекаут, особистий кабінет)
- Налаштовуємо мультисклад, якщо потрібно —
b_catalog_store, правила вибору складу
- Проганяємо весь функціонал на staging
- Документуємо зміни
Що ви отримуєте в результаті:
- Працюючий сайт на новій редакції без втрати даних
- Налаштований композитний кеш (якщо перейшли на «Бізнес»)
- Протокол тестування та рекомендації щодо подальшої оптимізації
- Доступи до staging та документація щодо змін
Ліцензія: продовження та ризики
Активна ліцензія дає оновлення — нові версії, патчі безпеки, багфікси, доступ до маркетплейсу та техпідтримку вендора. При закінченні сайт продовжує працювати, але залишається без оновлень. Для магазинів це небезпечно — патчі безпеки закривають вразливості в модулях sale, catalog, main. Витік даних з b_sale_order або b_user — питання часу. Продовження коштує значно менше покупки нової ліцензії. Регулярне продовження — страховка від незакритих CVE.
Связка «Управління сайтом» + Бітрікс24
Частий сценарій: сайт на 1С-Бітрікс + CRM в Бітрікс24. Замовлення з b_sale_order автоматично перетворюються на ліди або угоди, працює єдина авторизація, синхронізація клієнтської бази. Форми сайту (form або кастомні) ведуть у воронку CRM. Це дві окремі ліцензії та два окремі продукти — інтеграція між ними штатна і стабільно працює.
Рекомендації з практики
- Не економте на редакції, якщо точно знаєте, що функціонал знадобиться через півроку. Апгрейд редакції — та ж доплата плюс робота по налаштуванню та тестуванню.
- Бізнес для проектів з амбіціями зростання — композитний кеш окупає різницю в ціні при першому стрибку трафіку. Без композиту 3000+ уніків/день — сервер починає потіти.
- Бітрікс24 і «Управління сайтом» — різні продукти, різні ліцензії. Плутанина тут коштує грошей.
- Продовжуйте ліцензію щорічно — вартість продовження значно нижча за покупку нової, а без оновлень ви залишаєтеся з незакритими CVE.
Що ми пропонуємо: підбір та налаштування під ключ
Ми не просто консультуємо — беремо на себе повний цикл: аналіз поточного проекту, підбір редакції, закупівлю ліцензії (якщо потрібно), міграцію, налаштування всіх модулів та навчання команди. В рамках послуги ви отримуєте:
- Акт вибору редакції з обґрунтуванням
- План міграції (якщо апгрейд)
- Розгорнутий staging з новою редакцією
- Налаштування композитного кешу та кластеру (при необхідності)
- Документацію по новій конфігурації
- Гарантію працездатності після переходу
Зателефонуйте нам або залиште заявку — розповімо, яка редакція підійде конкретно під ваш проект, навантаження та плани зростання. Замовте консультацію — оцінимо ваш проект за один день і запропонуємо оптимальну конфігурацію. Отримайте персональний розрахунок вартості підбору та налаштування редакції 1С-Бітрікс прямо зараз.