Інтеграція Бітрікс24 з Zadarma: налаштування, API, телефонія

Інтеграція Бітрікс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%.

Як налаштувати пряму інтеграцію через Zadarma Webhooks?

Пряма інтеграція будується на вебхуках — HTTP-сповіщеннях, які Zadarma надсилає на ваш сервер при кожній події дзвінка. Налаштування в особистому кабінеті: Налаштування АТС → Сповіщення → Webhooks URL. Вкажіть адресу вашого обробника. Детальніше — в документації Zadarma API.

Zadarma підтримує такі типи сповіщень:

Верифікація запитів від 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. За цей час виконали десятки інтеграцій для компаній різного масштабу. Замовте консультацію — допоможемо налаштувати телефонію, яка працює як годинник.

Налаштування телефонії під ключ: від SIP до CRM

SIP-транк не реєструється — перша проблема при підключенні телефонії до Бітрікс24. Клієнт надсилає дані від провайдера, вбиваєш у розділ «Телефонія → Налаштування телефонії → SIP-конектор», а статус висить «Очікування реєстрації». Порти 5060/5061 для SIP та діапазон 10000–20000 для RTP закриті на фаєрволі — класика. Або кодек G.729 не підтримується, а G.711 жере смугу по 87 кбіт/с на лінію. На 20 одночасних розмов — рахуйте самі. Ми підключаємо та налаштовуємо телефонію так, щоб дзвінки не губилися, маршрутизація працювала за логікою бізнесу, а CRM отримувала дані автоматично.

Протокол SIP (Session Initiation Protocol) — стандарт для голосового зв'язку через інтернет. Наші фахівці мають 5+ років досвіду інтеграції з Бітрікс24. Гарантія на налаштовані рішення — 1 рік. Зв'яжіться з нами для безкоштовного аудиту поточної інфраструктури — часто знаходимо сліпі зони: пропущені без завдань, менеджери зі статусом «На лінії» і нулем дзвінків, IVR-гілки, в які ніхто не потрапляє.

Як уникнути збоїв при SIP-реєстрації?

SIP-реєстрація та підключення: як уникнути зривів?

Неправильний NAT, закриті порти або несумісні кодеки — 90% збоїв. Перевіряємо підтримку кодеків на стороні оператора, налаштовуємо keepalive та резервні SIP-сервери. Після налаштування реєстрація тримається місяцями.

Контракт з оператором вже є, міняти номери — не варіант. Підключаємо до Бітрікс24 через SIP-конектор. Для стабільної роботи потрібен канал: мінімум 100 кбіт/с на лінію для G.729, 87 кбіт/с для G.711a.

Типові завдання:

• Міські номери від будь-якого оператора — зберігаються при переході на Б24
• Номери 8-800 для вхідних — маршрутизація через CRM
• Багатоканальні номери з розподілом по відділах через IVR
• Аналогові лінії через VoIP-шлюзи Grandstream або Linksys

Де зазвичай стопориться:

• Порти SIP/RTP закриті на рівні провайдера або роутера
• NAT не проброшується коректно — одностороння чутність
• Різні кодеки на стороні АТС та Бітрікса — немає звуку взагалі

Ми вирішуємо ці проблеми за 1–3 дні, а не тижнями.

Покрокова інструкція підключення через SIP-транк:

1. Перевіряємо відкритість портів SIP (5060/5061) та RTP (10000–20000) на фаєрволі.
2. Узгоджуємо кодеки: G.711 або G.729 — тестуємо обидва варіанти.
3. Налаштовуємо SIP-конектор в адмінці Бітрікс24: логін, пароль, домен/IP провайдера.
4. Вмикаємо keepalive (період 30–60 секунд) для стабільної реєстрації.
5. Перевіряємо двосторонню чутність тестовим дзвінком.
6. Налаштовуємо резервний SIP-сервер на випадок збою основного.

Хмарна АТС чи SIP-транк: що вибрати?

Хмарна ВАТС не потребує заліза — підключається за 1–2 дні. SIP-транк зберігає ваші номери та дозволяє гібридну схему з on-premise АТС. Хмарна АТС налаштовується в 2-3 рази швидше і економить до 40% бюджету порівняно з утриманням власної інфраструктури. Порівняйте провайдерів за реальними кейсами.

Як порівняти провайдерів?

Навіщо потрібен запис дзвінків і як його налаштувати?

Усі вхідні та вихідні записуються автоматично. Зберігання — хмара Бітрікс24 (обмеження за тарифом) або власний сервер через модуль voximplant. Кожен запис прив'язаний до картки в CRM: контакт, угода, лід. Прослуховування — з таймлайну угоди.

Інструменти контролю:

• Повідомлення про запис — обов'язково за 152-ФЗ, налаштовується в IVR
• AI-транскрибація — розпізнавання мови через вбудований модуль CoPilot або зовнішній сервіс. Переводить дзвінок у текст, можна шукати за ключовими словами
• Аналіз тональності — система позначає дзвінки з негативом. Не заміна прослуховуванню, але фільтрує 90% рутини
• Вибірковий запис — тільки вхідні, тільки конкретні відділи
• Автоматичний контроль тривалості — дзвінки коротші 15 секунд майже завжди означають проблему: скинули, не додзвонилися, менеджер не підняв

Керівник бачить зведені звіти: кількість дзвінків по менеджерах, середня тривалість, пропущені без передзвону. Останній пункт — найболючіший: пропущений дзвінок без завдання на передзвін = втрачений клієнт.

Типові помилки в маршрутизації

Маршрутизація — найкрихкіша частина. Налаштували «по черзі», а менеджер залогінився і пішов обідати — дзвінок висить 40 секунд і скидається. Або IVR з п'ятьма рівнями вкладеності — клієнт кидає трубку на третьому. Ми використовуємо робочі сценарії розподілу:

• По відповідальному з CRM — номер знайдено в базі, дзвінок летить напряму менеджеру
• По черзі — рівномірне навантаження між операторами зі статусом «На лінії»
• По відділах через IVR — голосове меню, максимум два рівні. Більше — втрата дзвінків
• За часом — робочий/неробочий час, вихідні
• По регіону — визначення за кодом номера, розподіл на локальних менеджерів

При вхідному дзвінку система виконує: Номер знайдено в CRM:

• Маршрутизація на відповідального менеджера
• Спливаюча картка: ім'я, компанія, відкриті угоди, історія звернень
• Якщо менеджер не відповідає за 15 секунд — переадресація на колегу, потім на керівника

Номер не знайдено:

• Автоматично створюється лід в CRM (налаштування Телефонія → CRM-інтеграція → Створювати лід при невідомому номері)
• Дзвінок розподіляється по черзі
• Вся інформація фіксується для подальшої обробки

Інтеграція з CRM: як автоматизувати роботу?

Спливаюча картка при вхідному дзвінку показує:

• Ім'я, компанія, посада
• Поточні угоди зі статусами
• Останні 5 звернень — дзвінки, листи, чати
• Коментарі по клієнту
• Кнопки: «Створити угоду», «Поставити завдання», «Перевести дзвінок»

Автоматизація через бізнес-процеси налаштовується в розділі «CRM → Роботи та тригери»:

• Пропущений дзвінок → лід + завдання на передзвін відповідальному
• Завершення розмови → запис активності в таймлайн угоди
• Пропущений без передзвону протягом 30 хвилин → повідомлення керівнику
• Вхідний від клієнта з простроченою угодою → ескалація

Аналітика доступна в розділі «Телефонія → Баланс та статистика» та звітах CRM:

• Кількість дзвінків по менеджерах, відділах, напрямках
• Середня тривалість та час очікування на лінії
• Відсоток пропущених з трендом за тиждень
• Конверсія дзвінків в угоди — найважливіша метрика для комерційного відділу

Callback, автообдзвін та голосове меню: як збільшити конверсію?

Віджет «Передзвоніть мені» на сайті — одне поле (телефон), нічого зайвого. Система додзвонюється менеджеру, потім клієнту. Кожен запит — автоматичний лід в CRM. Антиспам: обмеження запитів з одного номера. A/B-тестування розташування — віджет справа внизу конвертує краще, ніж зліва, але залежить від дизайну. Callback знижує втрату дзвінків до 30% порівняно з ручним набором.

Автообдзвін:

• Обдзвін по сегменту з CRM — менеджер підключається після відповіді клієнта
• Роботизований обдзвін з голосовим повідомленням — підтвердження замовлень, нагадування про запис
• IVR-сценарії: «натисніть 1 для підтвердження»
• Розклад з урахуванням часових поясів — модуль перевіряє регіон за кодом номера

Побудова голосового меню:

• Привітальне повідомлення — назва компанії, повідомлення про запис
• Вибір відділу через DTMF — максимум 4–5 пунктів
• Черга очікування з музикою та позицією в черзі
• Неробочий час — голосова пошта або інформаційне повідомлення

Запис професійним диктором — має сенс для привітання та основного меню. Глибше — синтез мови, простіше оновлювати.

Що входить у налаштування телефонії?

Deliverables після завершення проекту:

• Налаштована SIP-реєстрація (хмарна АТС або SIP-транк під ключ)
• Працююча маршрутизація дзвінків (по CRM, черги, IVR)
• Запис дзвінків зі зберіганням у хмарі або на сервері
• Інтеграція з CRM: спливаючі картки, автостворення лідів, бізнес-процеси
• Віджет зворотного дзвінка на сайті
• Голосове меню (IVR) із записом диктора або синтезом
• Документація по налаштуваннях та навчання співробітників (2 сесії)
• Технічна підтримка протягом місяця після запуску

Все включено в комплексне налаштування — без прихованих доплат. Замовте налаштування телефонії та отримайте готову інфраструктуру для роботи з клієнтами.

Терміни налаштування

Вартість розраховується індивідуально залежно від обсягу робіт. Ми оцінимо ваш проект за 1 день. Починаємо з безкоштовного аудиту поточної інфраструктури — часто знаходимо сліпі зони: пропущені без завдань, менеджери зі статусом «На лінії» і нулем дзвінків, IVR-гілки, в які ніхто не потрапляє. Зв'яжіться з нами для консультації — ми запропонуємо оптимальне рішення під ваш бюджет та бізнес-процеси.