Решение о звонке в кампании
Функция до звонка может ответить «этому человеку не звони» или «перезвони позже» до набора номера. Тогда телефон у человека не зазвонит, минута связи не потратится и попытка контакта не сгорит. Решение принимает ваша система. HTTP-функция возвращает его в ответе, а вы в маппинге кладёте нужные поля в зарезервированные переменные. Функция с кодом записывает те же переменные сама — для этого перечислите их в её выходных переменных.
На карточке функции до звонка, которая записывает
call_decision, стоит значок ⤳ с подсказкой «Эта функция решает, что делать со звонком». В форме любой функции до звонка есть подсказка с переменными и их значениями.
Проверка функции в форме показывает принятое решение — например, «Решение: отменить набор» — и причину. Если значение не распознано или время повтора не прочитано, рядом появится предупреждение.
Что происходит с контактом:
Если функция явно вернула
proceed, в событиях звонка появится «Решение: набирать».
Ни отмена, ни отложенный контакт не учитываются в частотных лимитах: звонка не было.
Где смотреть результат на странице кампании:
- «Разбивка исходов», вкладка «Контакты» — строка «Отменены функцией». На вкладке «Звонки» этой строки нет: отменённый набор звонком не считается;
- «Состояние планировщика», строка «Удержания» — причина «Отложен функцией до звонка» с числом таких переносов;
- список контактов, колонка «Состояние» — у отложенного контакта «Ожидает», причина «Отложен функцией до звонка» и время «Повтор не раньше»; у отменённого — «Завершён».
call_retry_after, иначе интервал из политики повторов кампании. Если значение не прочитано, в событиях появится «Время повтора не прочитано — сработает политика ретраев кампании», и срок тоже берётся из политики. Значение меньше 60 секунд поднимается до 60 — иначе набор превратился бы в цикл запросов к вам. Сколько раз отложить контакт, не ограничено, но не позже конца кампании: повтор после её окончания закрывает контакт как исчерпанный.
Решение работает только в кампаниях. У входящих, web-звонков и звонков из кабинета или через публичный API оно игнорируется: в событиях появится «решение действует только при наборе из кампании», а звонок пойдёт как обычно. Отказ на входящем звонке выражается сценарием: условие и переход к завершающему узлу.
proceed с предупреждением «Значение решения не распознано — набор идёт» в событии; таймаут или ошибка вашего сервиса тоже не отменяют набор. Правило осознанное: пропущенный звонок дороже неполного контекста.
Если ваша система сломалась и начала отменять всё подряд, кампания сама встанет на паузу — чтобы не «обработать» весь список без единого звонка. По умолчанию защита срабатывает, когда все последние 20 решений (proceed, cancel или retry) были отменами; порог задаёт администратор платформы. Оставшиеся контакты не набираются, а в журнале действий появляется запись о паузе. Снять с паузы нужно вручную, разобравшись с причиной.