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

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

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. Иначе сервер не получит весь состав внутренних ветвей. Сложные переводы и перехваты проверяйте отдельным контрольным сценарием на своей станции.
Повтор обработанного начала подавляется. Завершённый разговор не открывается поздним внутренним событием. Поздний подтверждённый факт ответа может уточнить результат в журнале.
Проверка подключения
- Дождитесь успешной проверки URL в кабинете Novofon. На
zd_echoсервер возвращает тот же текст. - Позвоните на учебную линию и проверьте её получателей.
- Ответьте с добавочного. У остальных уведомление должно исчезнуть, а журнал должен отметить ответ.
- Завершите разговор и проверьте окончание в журнале.
- Для группы отдельно проверьте отказ одной ветви при продолжающемся вызове другой.
Ответ с accepted:true подтверждает обработку события, но не доставку push и не прохождение звука. Номер из чёрного списка получает accepted:false и is_block:true; внутреннее событие для него тоже не создаёт журнал.
Если события не обрабатываются
- Ошибка проверки URL: сверьте ссылку целиком, доступность сервера и ключ входа.
- 403: проверьте ключ, а при заполненном Secret также подпись и соответствие Secret подключению Novofon.
- 404: проверьте полный номер и наличие сохранённой линии с провайдером Novofon.
- 400: проверьте формат v1, event, строковый ID и поля события.
- Нет строки добавочного: проверьте NOTIFY_INTERNAL, работающего сотрудника, его SIP-логин и получателей линии.
- Есть уведомление, нет разговора: проверьте отдельное SIP-подключение и сеть.