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