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

Решение о звонке в кампании

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