Интеграция Битрикс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 рабочих дней.