Подключение Zadarma / Новофон
Готовое подключение виртуальной АТС Zadarma и Новофон (это одна платформа под двумя брендами) к функции «Звонки»: АТС сама сообщает, что запись разговора готова, dxCAR забирает её и дальше всё как обычно — распознавание, разбор, экран «Звонки». По тем же ключам работают дозвон клиенту из dxCAR: кнопка «Позвонить» у телефона клиента — и карточка клиента при входящем звонке: окно с клиентом, пока звонит телефон. Ничего ставить в АТС не нужно, только ключи API и адрес уведомлений.
Подключение работает через API v1 (у Новофона — api.novofon.com). Новофон 2.0 с его
Call API не поддерживается.
Что нужно
- Тариф с записью разговоров и включённая запись на внутренних номерах сотрудников.
- Ключи API — они бесплатны на любом аккаунте.
- Право «Настройки» в dxCAR (карточка «Zadarma / Новофон» на вкладке «Звонки»).
Подключение
- В dxCAR откройте Настройки → Звонки, нажмите «Подключить АТС» → Zadarma / Новофон — появится карточка с шагами и полями. Выберите сервер API — Zadarma или Новофон, по тому, где заведён аккаунт.
- В кабинете АТС откройте Настройки → Интеграция и API (
my.zadarma.com/marketplace/). На вкладке «Ключи и API» создайте ключи и перенесите Key и Secret в поля карточки. Нажмите «Проверить соединение» в карточке — сохранять заранее не нужно. Ответ — несколько строк: приняты ли ключи (и баланс аккаунта), какие внутренние номера АТС совпали с сотрудниками dxCAR, кому из сотрудников доступен дозвон, включены ли в АТС события для карточки клиента при звонке и когда пришло последнее уведомление от АТС. Ключи приняты — нажмите «Сохранить» внизу страницы. - Там же, на вкладке «Интеграция», включите Notifications (уведомления о событиях), в поле «О звонках в АТС» вставьте адрес из карточки (кнопка «Копировать» рядом с ним) и включите событие NOTIFY_RECORD («запись звонка готова»). При сохранении АТС сама проверит адрес — если dxCAR доступен из интернета, проверка проходит сразу. Для карточки клиента при звонке включите там же NOTIFY_START, NOTIFY_INTERNAL, NOTIFY_ANSWER и NOTIFY_END (см. ниже). Остальные события включать не обязательно: dxCAR их принимает и игнорирует.
- Убедитесь, что на внутренних номерах включена запись (Моя АТС → Внутренние номера).
- Внутренние номера сотрудников в dxCAR (карточка сотрудника → «Внутренний номер АТС») должны совпадать с номерами в АТС — так звонок привязывается к сотруднику.
Зачем ключи, если dxCAR ничего в АТС не меняет: ими подписано каждое уведомление АТС (без ключей АТС уведомления не подписывает, и dxCAR их не примет), и по ним dxCAR запрашивает у АТС данные звонка и ссылку на запись.
Что происходит дальше
- Запись появляется на экране «Звонки» через несколько минут после конца разговора (АТС готовит файл около минуты).
- Не отправляются: звонки без ответа (занято, сброс, не дозвонились), разговоры короче 5 секунд, звонки без номера клиента (внутренние). История до подключения не подтягивается.
- Кто звонил, кому, во сколько и сколько говорили — берётся из статистики АТС, поэтому направление и сотрудник определяются всегда, даже если звонок прошёл через меню или перевод.
Дозвон клиенту из dxCAR
Сотрудник нажимает «Позвонить» у телефона клиента — в карточке клиента, в заказ-наряде или в окне истории звонков. АТС сначала звонит на внутренний номер этого сотрудника, он снимает трубку — и АТС набирает клиента. Как пользоваться кнопкой — в разделе «Позвонить клиенту из dxCAR» справки «Звонки».
Что нужно:
- АТС подключена по шагам выше — ключи API те же;
- в карточке АТС (Настройки → Звонки, «Zadarma / Новофон») включён переключатель «Дозвон из dxCAR» и настройки сохранены. По умолчанию он выключен: звонки идут за счёт сервиса по тарифу АТС, и кнопка «Позвонить» не появляется у сотрудников, пока сервис сам этого не включит;
- в карточке сотрудника заполнен «Внутренний номер АТС», и такой внутренний номер есть в АТС. Перед каждым звонком dxCAR сверяет его со списком внутренних номеров АТС: номера нет — звонок не отправляется, сотрудник видит «Внутреннего номера NNN нет в АТС Zadarma». Кому дозвон доступен, а у кого номер не найден, показывает строка «Дозвон» в «Проверить соединение»;
- у сотрудника есть доступ к «Клиентам»: номера клиента — данные его карточки, без этого доступа кнопки нет.
Если подключена ещё и MikoPBX с дозвоном, звонки идут через неё — строка «Дозвон» в «Проверить соединение» так и скажет.
Клиент видит номер, который в АТС настроен для исходящих звонков этого внутреннего номера, — dxCAR его не выбирает. Запись разговора, если она включена на внутреннем номере, приходит на экран «Звонки» как у любого исходящего звонка. Звонки оплачиваются со счёта АТС.
Ответ АТС на команду значит «звонок принят в работу», а не «клиент ответил». Если АТС отказала, сотрудник видит причину: например, «АТС ограничивает частоту запросов — повторите через минуту» (API Zadarma принимает не больше 100 запросов в минуту на аккаунт) или текст отказа самой АТС.
Карточка клиента при звонке
Пока у сотрудника звонит телефон, в dxCAR всплывает окно с клиентом — его машины, открытые наряды, долг. Как выглядит окно и кому оно показывается — в разделе «Карточка клиента при входящем звонке» справки «Звонки».
Что включить:
- В кабинете АТС, Настройки → Интеграция и API, вкладка «Интеграция» — события NOTIFY_START (звонок пришёл в АТС), NOTIFY_INTERNAL (звонит внутренний номер), NOTIFY_ANSWER (ответили) и NOTIFY_END (звонок закончился). Адрес — тот же, что для записей.
- В dxCAR — переключатель «Карточка клиента при входящем звонке» (вкладка «Звонки», карточка «Карточка клиента при звонке»; включён по умолчанию) и «Внутренний номер АТС» в карточке сотрудника — тот же, что в АТС. Кто хочет видеть и звонки, которые ещё не дошли до телефона (меню, очередь), ставит в своей карточке сотрудника «Показывать все входящие».
Строка «Карточка клиента при звонке» в «Проверить соединение» показывает, какие из четырёх событий в АТС выключены, и когда пришло последнее событие входящего звонка.
Окно появляется только на входящие звонки от клиентов. Исходящие, звонки между сотрудниками и звонки, которые сотрудник сам начал кнопкой «Позвонить», окна не поднимают. Если тот же клиент перезвонит в течение 90 секунд после того, как ему звонили из dxCAR через АТС, окна тоже не будет: такой звонок не отличить от обратного звонка самой АТС.
Если звонков нет
- «Проверить соединение» в карточке: если ключи не приняты — перепроверьте Key/Secret и сервер (Zadarma или Новофон); если внутренние номера «без сотрудника» — впишите их в карточки сотрудников; если в строке «Дозвон» у сотрудника «внутреннего номера нет в АТС» — исправьте номер в его карточке или заведите внутренний номер в АТС; если уведомлений не было — адрес в кабинете АТС не сохранён или NOTIFY_RECORD выключено.
- Журнал приёма (кнопка «Журнал приёма →» в шапке экрана «Звонки»): каждое уведомление АТС оставляет строку — «неверная подпись» (перепроверьте Secret), «функция … не входит в тариф» (нет ни дополнения «Звонки», ни тарифа «Команда» и выше), «звонок не найден в статистике» (ключи от другого аккаунта), «пропущен: …» (короткий, без ответа).
- Пустой журнал — уведомления не доходят: проверьте адрес в кабинете АТС и что событие NOTIFY_RECORD включено.
- Без дополнения «Звонки» записи разговоров не принимаются: в журнал приёма попадают только записанные разговоры (строка «запись не принята: «Звонки» не подключены»), и если запись на линиях не включена, журнал пуст — это не поломка. «Проверить» тогда пишет об этом без замечания, а доходят ли события звонков, видно по строке «Карточка клиента при звонке».
- В кабинете Zadarma в истории звонков виден значок записи — если его нет, запись на внутреннем номере выключена.
Обновлено 1 октября 2026