SIP-АТС и заголовки Diversion/To: как передать номер
Если у вас своя SIP-АТС (Asterisk, FreePBX, Mango, МТТ или другая), встроенный коллтрекинг Битрикс24 работает иначе, чем с арендованными номерами. Когда клиент звонит на один из ваших номеров, звонок приходит на SIP-аккаунт в АТС, а уже оттуда — в Битрикс24. По умолчанию Битрикс24 видит только SIP-аккаунт, но не номер, на который звонил клиент. Без этого коллтрекинг не работает: система не знает, какой номер был на сайте.
Решение — передача номера через SIP-заголовки Diversion или To. Это техническая настройка, которая делается на стороне АТС и в Битрикс24. Без неё коллтрекинг с собственной АТС не будет определять источник звонка.
В этой статье — как настроить передачу номера через заголовки, что проверить на стороне АТС и в Битрикс24, как убедиться, что данные доходят, и какие ошибки встречаются чаще всего. С практическими шагами для администраторов. Если нужна настройка коллтрекинга с вашей АТС — поможем.
Почему номер не передаётся
При подключении SIP-АТС через коннектор в Битрикс24 вы создаёте SIP-аккаунт. В настройках указываются сервер, логин и пароль — но не номер телефона. Один SIP-аккаунт может обслуживать несколько номеров: все звонки на них приходят на один аккаунт в АТС, а оттуда — в Битрикс24.
Из-за этого в деталях звонка Битрикс24 не видит, на какой именно номер звонил клиент. Система знает только, что звонок пришёл на SIP-аккаунт. Для коллтрекинга этого недостаточно: нужно связать звонок с номером, который был показан посетителю на сайте.
По данным документации Битрикс24, номер, на который звонил клиент, должен передаваться в заголовках Diversion или To. Другие заголовки, включая CALLED_DID и X-trunk, для коллтрекинга не поддерживаются.
💡 Важно
Не все SIP-АТС передают эти заголовки по умолчанию. Уточните у поддержки вашей АТС или администратора, включена ли передача номера в Diversion или To. Если нет — настройка на стороне Битрикс24 не поможет.
Заголовки Diversion и To
В протоколе SIP заголовки передают информацию о вызове. Для коллтрекинга используются два:
| Заголовок | Что содержит | Когда используется |
|---|---|---|
| To | Номер, на который звонит клиент | Стандартный заголовок для входящих вызовов |
| Diversion | Номер, на который был переадресован вызов | При переадресации или маршрутизации через АТС |
В Битрикс24 можно настроить приоритет заголовков: если выбрать порядок Diversion, To, система сначала проверит Diversion, затем To. Это полезно, если ваша АТС передаёт номер в одном из них, но не всегда понятно, в каком именно.
Как это работает
Схема передачи номера:
- Клиент звонит на номер, который был на сайте;
- Звонок попадает в SIP-АТС;
- АТС добавляет номер, на который звонил клиент, в заголовок
DiversionилиTo; - АТС направляет звонок в Битрикс24;
- Битрикс24 читает номер из заголовка и использует его для коллтрекинга.
Без шага 3 Битрикс24 видит только SIP-аккаунт, но не номер. Коллтрекинг не срабатывает.
Настройка на стороне АТС
Это самый важный шаг. Если АТС не передаёт номер в заголовках, никакие настройки в Битрикс24 не помогут.
Что нужно сделать
- Уточнить у поддержки АТС. Спросите, передаёт ли ваша АТС номер в заголовках
DiversionилиToпри направлении вызова в Битрикс24. Если нет — можно ли это включить; - Настроить маршрутизацию. В некоторых АТС (например, Asterisk, FreePBX) передача заголовков настраивается в конфигурации транка или в правилах маршрутизации;
- Проверить формат номера. Номер должен передаваться в том же формате, в котором он указан в Битрикс24 (с кодом страны или без). Если форматы различаются, коллтрекинг может не сопоставить номер.
Если АТС не поддерживает заголовки
Некоторые облачные АТС не передают Diversion и To. В этом случае есть варианты:
- Сменить АТС. Если коллтрекинг критичен, возможно, стоит рассмотреть другого провайдера;
- Использовать внешний сервис коллтрекинга. Некоторые сервисы умеют работать с АТС, которые не передают заголовки, через другие механизмы (например, через API или переадресацию на номера сервиса);
- Кастомная разработка. В редких случаях можно написать промежуточный сервис, который будет перехватывать звонок и передавать номер в Битрикс24. Но это сложно и дорого.
Настройка в Битрикс24
После того как АТС настроена, нужно включить обработку заголовков в Битрикс24.
Пошагово
- Перейдите в настройки телефонии. CRM → Настройки → Телефония (или CRM → Продажи → Каналы продаж → Телефония);
- Откройте настройки номеров. Нажмите «Настроить номера» и выберите ваше SIP-подключение;
- Откройте вкладку SIP PBX numbers. Там находятся настройки обработки заголовков;
- Включите опцию «Получать номер назначения из SIP-заголовков» (Get destination number from SIP headers);
- Настройте приоритет заголовков. Выберите порядок: например,
diversion, toилиto, diversion. Это зависит от того, какой заголовок использует ваша АТС.
Права доступа
По умолчанию настройки телефонии доступны только администраторам Битрикс24. Если настройку должен делать другой сотрудник, нужно предоставить ему соответствующие права в разделе телефонии.
💡 Важно
После первого входящего звонка номер, переданный в заголовке, автоматически появится в разделе CRM → Аналитика → Sales Intelligence → Коллтрекинг → Номера телефонов. Там его нужно привязать к источнику трафика (например, «Яндекс.Директ»).
Как проверить
После настройки нужно убедиться, что номер передаётся и коллтрекинг работает.
Проверка в логах
Откройте раздел Телефония → Детали звонков (Call Details). Найдите тестовый звонок и проверьте поля Diversion и To. Если номер там есть — передача работает. Если поля пустые — АТС не передаёт заголовок.
Проверка коллтрекинга
- Зайдите на сайт из рекламного источника (например, кликните по объявлению);
- Проверьте, что на странице отображается подменный номер, привязанный к источнику;
- Позвоните по этому номеру;
- Проверьте в CRM, что звонок создал сделку или контакт с правильным источником в поле «Источник» или «Sales Intelligence».
Если источник не определяется, проверьте:
- Передаётся ли номер в заголовке (по логам);
- Привязан ли номер к источнику в настройках коллтрекинга;
- Совпадает ли формат номера в заголовке и в настройках коллтрекинга.
Типичные ошибки
1. АТС не передаёт заголовок
Самая частая проблема. Настройки в Битрикс24 включены, но АТС не отправляет номер. Проверяйте логи и уточняйте у поддержки АТС.
2. Неверный приоритет заголовков
АТС передаёт номер в To, а в Битрикс24 приоритет стоит на Diversion. Система не находит номер. Поменяйте приоритет.
3. Формат номера не совпадает
АТС передаёт номер как 79991234567, а в Битрикс24 номер указан как +79991234567. Коллтрекинг не сопоставляет их.
4. Номер не привязан к источнику
Номер передаётся, но в настройках коллтрекинга не привязан к источнику трафика. Система не знает, что это за канал.
5. Нет прав на настройку
Сотрудник не может открыть настройки телефонии, потому что у него нет прав. Настройку должен делать администратор или пользователь с расширенными правами.
6. Несколько номеров на одном SIP-аккаунте
Если на одном SIP-аккаунте несколько номеров, без заголовков Битрикс24 не может определить, на какой именно звонили. Заголовки обязательны.
Наши рекомендации
Что вы получаете, заказывая настройку у нас
- Аудит АТС — передаёт ли заголовки;
- Настройку — на стороне АТС и Битрикс24;
- Проверку — логи, тестовые звонки;
- Привязку номеров — к источникам;
- Обучение — как поддерживать.
📌 Итоговый вывод
С SIP-АТС коллтрекинг работает только тогда, когда номер передаётся в заголовках Diversion или To.
Что нужно знать:
- Почему: один SIP-аккаунт может обслуживать несколько номеров, Битрикс24 не видит номер без заголовков;
- Заголовки:
Diversion(переадресация) иTo(номер получателя); - Настройка АТС: включить передачу номера в одном из заголовков;
- Настройка Битрикс24: включить обработку заголовков и настроить приоритет;
- Проверка: логи звонков, поля Diversion и To;
- Ошибки: АТС не передаёт, неверный приоритет, формат номера, нет привязки к источнику.
Также рекомендуем: Коллтрекинг, встроенный, связка с CRM, все статьи о коллтрекинге.