История, ограничения и диагностика
Где смотреть события функций
Раздел История → карточка звонка → вкладка «Транскрипт», флажок «Отображать системные события». Флажок есть у администратора и разработчика; менеджер и участник видят только диалог, событий функций у них нет. Подробнее о карточке — Детали звонка. В ленте рядом с репликами стоят события «Функция до звонка» и «Функция после звонка». В строке события — имя функции, код ответа HTTP, время в миллисекундах, текст ошибки и статус. Щелчок по строке раскрывает детали в JSON:variables— имена записанных переменных;batch— номер строки блока, в которой выполнялась функция;stage— когда она выполнялась:pre_dial— до набора номера,pre_start— до первой реплики,late— поздняя доставка;request— отправленный запрос, секреты в нём замаскированы;status_code— код ответа;- у функций после звонка —
analysis_status, статус пост-аналитики на момент запуска.
Статусы в истории
Пометка «без результата аналитики» у функции после звонка значит, что готовой пост-аналитики на момент запуска не было: она выключена или пропущена, завершилась сбоем, была прервана или её не дождались. Точный статус —
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.
cancel, кампания встаёт на паузу сама: так платформа защищает базу от сбоя вашей системы, которая отменяет всё подряд. Снимите кампанию с паузы вручную, когда проверите систему. Подробнее — Решение о звонке в кампании.
Ограничения
- Функции не вызываются посреди разговора. Всё, что нужно спросить по ходу диалога, — это узлы сценария на схеме.
- Уже сказанная реплика не переигрывается. Поздние данные агент использует в следующей реплике, а не переспрашивает задним числом. В realtime-режиме поздние данные попадают в переменные и инструменты, но не в системный промпт.
- Время. Таймаут одной функции — не больше 30 секунд. Бюджет блока до звонка — 10 секунд до первой реплики у входящих и web-звонков и 60 секунд до набора номера у исходящих.
- Блок выполняется один раз. Блок функций после звонка запускается один раз на звонок, повторная финализация его не перезапускает. Упавшая функция не срывает звонок, но второй раз сама не пойдёт.
- Повторы HTTP-запроса — поле «Повторы» в форме функции, по умолчанию 0. Повторяются только таймаут, сетевая ошибка и ответ 5xx; ответ 4xx и
blockedне повторяются. У функции-кода повторов нет. Повтор может доставить вам один и тот же запрос дважды — делайте обработку идемпотентной. - Число функций в блоке не ограничено, но одновременно внутри одной строки выполняется не более 16; сколько поместится в бюджет, решает самая длинная цепочка.
- Функции после звонка ждут пост-аналитику до 60 секунд, затем выполняются без неё; события появляются в истории после выполнения. Они делят очередь с оценкой разговоров — держите таймаут минимально достаточным.
- Куда попадают результаты. Переменные, записанные функциями до звонка, — это динамические переменные: они доступны пост-аналитике и уходят в
dynamic_variablesвебхуковcall_ended/call_analyzed. Результаты функций после звонка остаются только в их событиях. - Пост-аналитика, базы знаний и вебхуки из конвейера не редактируются — эти блоки показывают настройки и ведут к их формам.
Диагностика
Граница простая: до отправки запроса и после получения ответа — наша сторона; что происходит внутри вашей системы и что она вернула — ваша.