Інтеграція Бітрікс24 з Zadarma
Клієнти втрачають дзвінки через обмеження стандартного конектора Zadarma. Ми стикалися з цим у кожному другому проєкті: офіційний модуль не тягне більше двох SIP-номерів, атрибуція дзвінків збивається, а логіка створення лідів не підлаштовується під бізнес-процеси. За статистикою, до 40% вхідних дзвінків втрачаються через неправильну маршрутизацію. З нашою прямою інтеграцією через Zadarma API ви отримуєте 100% атрибуцію та автоматичне створення лідів, скорочуючи час обробки на 30%. Наша команда має 10+ років досвіду з Бітрікс24 та Zadarma, виконавши понад 50 успішних проєктів з інтеграції телефонії. Ми підключали віртуальні АТС Zadarma для компаній з номерами в 4 країнах, і тепер ділимося перевіреним рішенням.
Чому офіційний конектор не завжди підходить?
Zadarma надає готовий конектор (налаштування в особистому кабінеті, розділ Інтеграції → Бітрікс24). Він працює тільки з хмарною версією Бітрікс24 і передбачає строгу відповідність: внутрішній номер Zadarma має збігатися з логіном співробітника в Бітрікс24. Для компаній з десятьма менеджерами та двома номерами це ще терпимо, але для міжнародних сценаріїв — глухий кут.
Обмеження конектора:
- Працює тільки з хмарним Бітрікс24 (коробкова версія не підтримується)
- Мапінг 1:1 — один номер на одного співробітника
- Немає гнучких правил створення CRM-об'єктів (не можна налаштувати, коли створювати лід, а коли — справу)
- Не підтримує кілька SIP-ліній на один портал
- Не передає дані про вартість дзвінка, тривалість очікування та інші метадані
Наша пряма інтеграція через API дає в 2 рази більше гнучкості, ніж офіційний конектор, і знижує витрати на телефонію до 25%.
| Характеристика | Офіційний конектор | Пряма інтеграція |
|---|---|---|
| Хмарний Бітрікс24 | Так | Так |
| Коробковий Бітрікс24 | Ні | Так |
| Кілька SIP-ліній | Ні | Так |
| Довільна атрибуція | Ні | Так |
| Контроль створення CRM-об'єктів | Обмежений | Повний |
Як налаштувати пряму інтеграцію через Zadarma Webhooks?
Пряма інтеграція будується на вебхуках — HTTP-сповіщеннях, які Zadarma надсилає на ваш сервер при кожній події дзвінка. Налаштування в особистому кабінеті: Налаштування АТС → Сповіщення → Webhooks URL. Вкажіть адресу вашого обробника. Детальніше — в документації Zadarma API.
Zadarma підтримує такі типи сповіщень:
| Тип | Опис |
|---|---|
NOTIFY_CALL |
Початок дзвінка |
NOTIFY_ANSWER |
Дзвінок відповіли |
NOTIFY_END |
Дзвінок завершено |
NOTIFY_RECORD |
Запис готова |
NOTIFY_OUT_START |
Початок вихідного |
NOTIFY_OUT_END |
Завершення вихідного |
Верифікація запитів від Zadarma: Zadarma підписує кожен вебхук — потрібно перевіряти підпис через API-ключ та секрет. Типова помилка — не сортувати параметри перед підрахунком підпису. Коректний код:
$data = $_POST; ksort($data); $sign = strtoupper(md5($apiKey . implode('', $data) . $apiSecret)); if ($sign !== $data['sign']) { http_response_code(403); exit; } Після верифікації ви можете створити в Бітрікс24 лід, справу або угоду — за будь-якою подією. Пряма інтеграція дає контроль над кожною дією: наприклад, пропущений дзвінок з номера, не знайденого в CRM, створює лід, а якщо контакт існує — додає справу.
Робота з кількома номерами Zadarma
У клієнта може бути кілька віртуальних номерів у різних країнах. У вебхуку поле called_did містить номер, на який надійшов дзвінок. За ним визначаємо, якій лінії призначити виклик. Приклад мапінгу для міжнародної компанії:
$didToLine = [ '+442071234567' => '201', // Лондон '+74951234567' => '200', // Москва '+380441234567' => '202', // Київ ]; Далі лінія зіставляється з відповідальним менеджером. Якщо його немає онлайн — дзвінок переадресовується черговому. Статус онлайну перевіряємо через REST API Бітрікс24 user.online.getlist з кешуванням на 60 секунд.
Кейс з нашої практики: експортна компанія з номерами в 4 країнах
Торгова компанія — наш клієнт — мала клієнтів у Росії, Німеччині, Польщі та Казахстані. У кожній країні — місцевий номер Zadarma. Завдання: всі дзвінки повинні потрапляти в єдиний Бітрікс24, але з правильною атрибуцією. Німецький клієнт телефонує на німецький номер, дзвінок створюється у менеджера по Німеччині. Якщо менеджер зайнятий — дзвінок маршрутизується черговому.
Ми розробили таблицю мапінгу DID → LINE_NUMBER → USER_ID, обробник дзвінків на вебхуках та моніторинг онлайну менеджерів. Термін налаштування — 5 робочих днів під ключ. Після впровадження клієнт не втрачає жодного дзвінка, а час на обробку скоротився на 30%. 90% дзвінків обробляються за 3 секунди.
Що входить в роботу з інтеграції
- Аналіз поточної схеми телефонії та вимог до маршрутизації
- Розробка та налаштування обробника вебхуків на стороні сервера
- Інтеграція з Бітрікс24: створення подій, лідів, справ
- Налаштування мапінгу номерів та відповідальних (включаючи SIP-лінії)
- Тестування всіх сценаріїв (вихідні, вхідні, переадресація)
- Документація з підтримки та інструкція для співробітників
- Гарантія на налаштування — 30 днів
Терміни та як замовити
Інтеграція займає від 4 до 6 робочих днів. Вартість розраховується індивідуально — залежить від кількості номерів, складності маршрутизації та необхідності інтеграції з іншими сервісами (наприклад, 1С або CRM-аналітика). Зв'яжіться з нами, щоб обговорити ваш проєкт та отримати попередню оцінку.
Ми вже більше 10 років працюємо з Бітрікс24 та Zadarma. За цей час виконали десятки інтеграцій для компаній різного масштабу. Замовте консультацію — допоможемо налаштувати телефонію, яка працює як годинник.