События Novofon: начало, ответ и завершение

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

События Novofon: начало, ответ и завершение

Novofon передаёт в TesLab события входящего звонка: поступление на линию, вызов добавочного, ответ и завершение. По ним приложение показывает уведомления и обновляет журнал. Передача звука настраивается отдельно.

Что подготовить

Понадобятся настроенная линия Novofon, доступ к её кабинету и право изменять телефонные линии в TesLab. Для этой интеграции используется формат уведомлений о событиях v1 с полем event и значениями NOTIFY_…. Другой формат с notification_name и call_session_id не является взаимозаменяемым.

Сначала настройте учебный номер и выполните контрольный звонок. Не отправляйте поддельные события на рабочий URL.

Телефон: событие и звук различаются. Согласуйте один идентификатор вызова и правильный добавочный.

Подключение линии

  1. Откройте Настройки → АТС.
  2. Добавьте линию или откройте её редактирование.
  3. Укажите внутреннее название и полный номер телефона, выберите провайдера Novofon.
  4. Заполните Key и Secret параметрами соответствующего подключения.
  5. Скопируйте URL из подсказки и укажите его в кабинете Novofon для уведомлений о событиях v1.

Учебная линия Novofon: выбор провайдера и URL уведомлений

1. Выбор Novofon. 2. Подсказка с URL и кнопкой копирования. Технический путь скопированной ссылки оставьте без изменений.

Ключ входящего URL и Secret выполняют разные задачи. Ключ разрешает обращение к этому входу TesLab. Если Secret задан в линии, сервер дополнительно проверяет подпись SIGNATURE по правилам Novofon v1. Secret должен соответствовать подключению провайдера. Пустой Secret не включает эту дополнительную проверку.

Рабочий URL, Key и Secret не публикуйте в статьях, переписке с посторонними и общедоступных журналах. Поля секретов при повторном открытии могут показывать маску: она не является новым ключом.

Получатели уведомлений

В этой же форме выберите пользователей и группы, которым нужны уведомления о входящих вызовах. Получатели линии определяются этими списками. Добавочный сопоставляется только с работающими сотрудниками среди получателей выбранной линии.

Получатели уведомлений линии и кнопка сохранения

1. Получатели линии. Можно выбрать отдельных пользователей и группы. 2. Сохранить настройки.

Параметры добавочного задаются отдельно в меню сотрудника «Виртуальная АТС». Одинаковый короткий номер на другой станции сам по себе не делает сотрудника получателем этой линии.

События и результаты

СобытиеЧто делает TesLab
NOTIFY_STARTПоказывает входящий звонок получателям линии. Повтор того же начала не вызывает вторую доставку.
NOTIFY_INTERNALРегистрирует вызов конкретного добавочного в журнале. Само по себе не создаёт повторное уведомление линии.
NOTIFY_ANSWERОтмечает ответ и снимает уведомление у остальных получателей. Разговор ещё продолжается.
NOTIFY_ENDЗавершает соответствующую внутреннюю ветвь. Живые зарегистрированные ветви других добавочных сохраняются.
NOTIFY_OUT_START, NOTIFY_OUT_ENDОбрабатывает как диагностические события исходящих звонков. В журнал входящих их не добавляет.
NOTIFY_RECORD, NOTIFY_IVRОбрабатывает диагностически. Файл записи разговора и управление голосовым меню эта настройка не добавляет.

Длительность и признак записи, которые передаёт провайдер, не означают, что в TesLab появились запись разговора и её проигрыватель.

Примеры входящих данных

У всех событий одного разговора должен сохраняться строковый pbx_call_id, не более 64 знаков. Ниже условные данные начала:

{
  "event": "NOTIFY_START",
  "caller_id": "70000000000",
  "called_did": "70000000001",
  "call_start": "2026-11-14 10:00:00",
  "pbx_call_id": "in_training_407"
}

В событии ответа номер линии передаётся полем destination:

{
  "event": "NOTIFY_ANSWER",
  "caller_id": "70000000000",
  "destination": "70000000001",
  "call_start": "2026-11-14 10:00:00",
  "pbx_call_id": "in_training_407",
  "internal": "105"
}

Это объяснение состава данных, а не готовый запрос: действующий провайдер добавляет нужные параметры и подпись. Массив вместо ID, неизвестное событие и неподходящий формат отклоняются.

Ответ, завершение и повторы

Ответ и завершение являются разными этапами. При групповом вызове один добавочный может прекратить звонить, пока другой ещё отвечает. Нельзя считать каждый NOTIFY_END завершением всех ветвей.

Настройте передачу полного набора событий, включая NOTIFY_INTERNAL. Иначе сервер не получит весь состав внутренних ветвей. Сложные переводы и перехваты проверяйте отдельным контрольным сценарием на своей станции.

Повтор обработанного начала подавляется. Завершённый разговор не открывается поздним внутренним событием. Поздний подтверждённый факт ответа может уточнить результат в журнале.

Проверка подключения

  1. Дождитесь успешной проверки URL в кабинете Novofon. На zd_echo сервер возвращает тот же текст.
  2. Позвоните на учебную линию и проверьте её получателей.
  3. Ответьте с добавочного. У остальных уведомление должно исчезнуть, а журнал должен отметить ответ.
  4. Завершите разговор и проверьте окончание в журнале.
  5. Для группы отдельно проверьте отказ одной ветви при продолжающемся вызове другой.

Ответ с accepted:true подтверждает обработку события, но не доставку push и не прохождение звука. Номер из чёрного списка получает accepted:false и is_block:true; внутреннее событие для него тоже не создаёт журнал.

Если события не обрабатываются

  • Ошибка проверки URL: сверьте ссылку целиком, доступность сервера и ключ входа.
  • 403: проверьте ключ, а при заполненном Secret также подпись и соответствие Secret подключению Novofon.
  • 404: проверьте полный номер и наличие сохранённой линии с провайдером Novofon.
  • 400: проверьте формат v1, event, строковый ID и поля события.
  • Нет строки добавочного: проверьте NOTIFY_INTERNAL, работающего сотрудника, его SIP-логин и получателей линии.
  • Есть уведомление, нет разговора: проверьте отдельное SIP-подключение и сеть.

Связанные материалы