Перейти к основному содержанию

Запись разговоров и уведомления в CRM

Цель модуля: включить запись со сроком хранения и отдать итоги звонка внешней системе.
Шестерёнка «Параметры записи»: каналы и срок хранения

Запись разговоров: стерео (агент и клиент по разным каналам) или моно, срок хранения — бессрочно или в днях. Стерео сильно упрощает разбор спорных звонков.

Шестерёнка «Параметры записи»: каналы и срок хранения
Запись включается переключателем «Запись разговора» в карточке «Звонок», а шестерёнка «Параметры записи» рядом открывает две настройки:
  • «Каналы» — «Стерео» (агент и клиент в разных каналах) или «Моно» (один сведённый канал).
  • «Хранение аудио» — «Хранить бессрочно» или «Удалять через N дней» со сроком от 1 дня. Это ваш ответ на вопрос «сколько мы храним голос клиента».
Пишутся голосовые звонки — по телефону и тестовые звонки из браузера. Готовая запись появляется в плеере в шапке карточки звонка, там же её можно скачать; после истечения срока хранения карточка показывает «Запись удалена по сроку хранения».
Совет: предупредите абонента о записи. Запись разговоров регулируется законом, и правила зависят от страны, а в США — ещё и от штата: в одних штатах достаточно согласия одного участника разговора, в других нужно согласие всех. Платформа сама абонента не предупреждает — это ответственность вашей организации. Надёжный способ — сказать о записи в первой реплике агента и сверить формулировку с вашим юристом.
Окно «Вебхуки»: адрес, события и кнопка «Тест»

Уведомления после звонка: адрес, набор событий и кнопка «Тест». В настройках адреса есть отдельный переключатель «Слать события тест-сессий» — по умолчанию выключен, чтобы тесты не мусорили в CRM.

Окно «Вебхуки»: адрес, события и кнопка «Тест»
Два события, на которые можно подписаться:
  • call_ended — звонок закончился: статус, причина, длительность, транскрипт, переменные.
  • call_analyzed — готова пост-аналитика: резюме, тональность, кастомные поля, признак успешности, а также полные данные звонка и готовая запись. Событие приходит и тогда, когда аналитика пропущена или не удалась, — причина указана в нём же.
Доставка идёт с повторами; если в поле «Секрет подписи — имя env-переменной» задан секрет, запрос подписывается, и принимающая сторона может проверить его подлинность. Доставки по звонку видны в блоке «Webhook-доставки» карточки звонка, а недоставленные можно отправить повторно кнопкой «Повторить». Вебхуки сохраняются сразу — они не часть черновика агента и не требуют публикации.
Адрес принадлежит одному агенту, и это важно знать заранееВебхук принадлежит тому агенту, в настройках которого вы его завели; общего вебхука на всю организацию нет. Если вам нужны события по нескольким агентам, добавьте адрес каждому — URL можно переиспользовать, различать их по agent_id в payload.
На недозвоне переменные тоже приходят. Звонок, который не состоялся, даёт вебхук с dynamic_variables — там значения, переданные для контакта. Пустой словарь признаком недозвона не является: различайте исход по call_status.
Звонок кампании несёт в metadata кампанию и контакт: campaign_id, contact_id, attempt_no, campaign_name, campaign_created_via и campaign_launched_via. Что приходит в событиях, с примерами, — на странице Вебхуки; подпись, повторы и порядок доставки — в Web API.
ПрактикаПройдите по всем секциям настроек своего агента и заполните их так же, как показано: промпт, две модели, голос с фолбэком, таймеры, AMD, запись, вебхук. Затем нажмите Сохранить — и переходите к качеству разговора.