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