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

История, ограничения и диагностика

Где смотреть события функций

Раздел История → карточка звонка → вкладка «Транскрипт», флажок «Отображать системные события». Флажок есть у администратора и разработчика; менеджер и участник видят только диалог, событий функций у них нет. Подробнее о карточке — Детали звонка. В ленте рядом с репликами стоят события «Функция до звонка» и «Функция после звонка». В строке события — имя функции, код ответа HTTP, время в миллисекундах, текст ошибки и статус. Щелчок по строке раскрывает детали в JSON:
  • variables — имена записанных переменных;
  • batch — номер строки блока, в которой выполнялась функция;
  • stage — когда она выполнялась: pre_dial — до набора номера, pre_start — до первой реплики, late — поздняя доставка;
  • request — отправленный запрос, секреты в нём замаскированы;
  • status_code — код ответа;
  • у функций после звонка — analysis_status, статус пост-аналитики на момент запуска.
События функций до звонка стоят выше первой реплики: они и правда выполнились раньше. Значения переменных видны всем ролям: вкладка «Данные» → «Переменные, переданные агенту». Кнопка «Скачать лог» в карточке звонка (администратор, разработчик) выгружает звонок в JSON — со всеми событиями функций и переменными.

Статусы в истории

Пометка «без результата аналитики» у функции после звонка значит, что готовой пост-аналитики на момент запуска не было: она выключена или пропущена, завершилась сбоем, была прервана или её не дождались. Точный статус — analysis_status в деталях события. Тексты ошибок:
  • http_<код> — ответ с кодом вне успешных;
  • network — не удалось соединиться с адресом;
  • blocked — адрес отклонён политикой исходящих запросов платформы;
  • invalid_json — ответ объявлен как JSON, но не разбирается;
  • timeout — не уложилась во время;
  • у функции-кода — текст исключения.

Проверить до публикации

Карточку функции можно прогнать в редакторе, не звоня никому: «Проверить» и «Проверить с заглушкой» у своей функции, «Выполнить код» у функции-кода. У функций до звонка рядом выбирается «Бюджет пробного вызова» — «До первой реплики (входящие, web)» или «До набора номера (исходящие)». Результат проверки подписан по-своему: «Успех», «Ошибка», «Таймаут», «Пропущена (бюджет исчерпан)», плюс время в миллисекундах. Кнопка «Проверить блок» прогоняет весь блок: «Блок целиком — N ms» и разбивка «Строка 1:», «Строка 2:» со статусом каждой функции. Поздняя доставка в проверке не моделируется: функция, не уложившаяся в выбранный бюджет, получает «Таймаут» или «Пропущена (бюджет исчерпан)», хотя во входящем звонке её результат пришёл бы в фоне. Подробнее — Функции до звонка.

Решение о звонке в истории

Решение действует только при наборе из кампании. Входящие, web-звонки и разовые исходящие из кабинета или через API его не исполняют, в событии — «решение действует только при наборе из кампании».
  • cancel — номер не набирается, в истории остаётся сессия со статусом «Отменён функцией до набора».
  • retry — сессии в истории нет; у контакта в кампании — «Отложен функцией до звонка».
  • «Значение решения не распознано — набор идёт» — в call_decision пришло значение вне proceed / cancel / retry.
  • «Время повтора не прочитано — сработает политика ретраев кампании» — call_retry_after не число секунд и не дата ISO 8601.
Если последние 20 решений подряд — cancel, кампания встаёт на паузу сама: так платформа защищает базу от сбоя вашей системы, которая отменяет всё подряд. Снимите кампанию с паузы вручную, когда проверите систему. Подробнее — Решение о звонке в кампании.

Ограничения

  • Функции не вызываются посреди разговора. Всё, что нужно спросить по ходу диалога, — это узлы сценария на схеме.
  • Уже сказанная реплика не переигрывается. Поздние данные агент использует в следующей реплике, а не переспрашивает задним числом. В realtime-режиме поздние данные попадают в переменные и инструменты, но не в системный промпт.
  • Время. Таймаут одной функции — не больше 30 секунд. Бюджет блока до звонка — 10 секунд до первой реплики у входящих и web-звонков и 60 секунд до набора номера у исходящих.
  • Блок выполняется один раз. Блок функций после звонка запускается один раз на звонок, повторная финализация его не перезапускает. Упавшая функция не срывает звонок, но второй раз сама не пойдёт.
  • Повторы HTTP-запроса — поле «Повторы» в форме функции, по умолчанию 0. Повторяются только таймаут, сетевая ошибка и ответ 5xx; ответ 4xx и blocked не повторяются. У функции-кода повторов нет. Повтор может доставить вам один и тот же запрос дважды — делайте обработку идемпотентной.
  • Число функций в блоке не ограничено, но одновременно внутри одной строки выполняется не более 16; сколько поместится в бюджет, решает самая длинная цепочка.
  • Функции после звонка ждут пост-аналитику до 60 секунд, затем выполняются без неё; события появляются в истории после выполнения. Они делят очередь с оценкой разговоров — держите таймаут минимально достаточным.
  • Куда попадают результаты. Переменные, записанные функциями до звонка, — это динамические переменные: они доступны пост-аналитике и уходят в dynamic_variables вебхуков call_ended / call_analyzed. Результаты функций после звонка остаются только в их событиях.
  • Пост-аналитика, базы знаний и вебхуки из конвейера не редактируются — эти блоки показывают настройки и ведут к их формам.

Диагностика

Граница простая: до отправки запроса и после получения ответа — наша сторона; что происходит внутри вашей системы и что она вернула — ваша.