Операционный агент: триггеры

Триггер это первый блок на доске: он определяет, когда выполняется поток и с какими данными он начинается. Каждый вид триггера может встречаться на доске один раз, а на одной доске может быть несколько видов (например, звонок на АТС и ручной запуск). Триггеры начинают запуски только пока агент включён; тестовый запуск из конструктора работает в любом случае.

Звонок завершён (АТС)#

Каждый звонок, записанный в журнал АТС проекта, запускает поток. АТС подключается один раз для всего проекта в разделе Интеграции (см. Контакты и интеграция с АТС). Триггер передаёт шагам:

• caller_number, caller_name, callee_number, callee_name, direction (входящий, исходящий, внутренний)
• duration_sec, status (отвечен, пропущен и так далее), subject, extension (имя пользователя добавочного номера)
• recording_url (ссылка на скачивание в АТС) и recording_ref (имя файла записи)
• call_id, contact_id, contact_number

У пропущенного звонка нет записи. Шаги, которым она нужна (скачивание, расшифровка, сводка, отчёт), помечают себя Пропущен: нечего делать, и запуск всё равно завершается, поэтому пропущенный звонок никогда не оставляет запуск в ожидании повторов.

Не выпускайте recording_url за пределы потока: он содержит секрет скачивания АТС. Чтобы идентифицировать запись в другой системе, отправляйте вместо него recording_ref.

Один звонок на АТС может запустить несколько агентов: на нём выполняется каждый включённый агент с этим триггером.

Получен вебхук#

Агента может запустить всё, что умеет отправлять JSON: доска показывает собственный URL агента в инспекторе (а также в Настройках). Тело запроса становится данными триггера, поэтому поле order_id в теле доступно в шагах как {{trigger.order_id}}.

Запуск по расписанию#

Запускает поток каждый час, каждый день в 09:00, по будням в 09:00, каждый понедельник в 09:00, первого числа месяца в 09:00 или по вашему собственному cron-выражению, в выбранном вами часовом поясе, не чаще одного раза в пять минут. Два варианта выбора:

• Если предыдущий запуск ещё идёт: пропустить этот или поставить его в очередь.
• Срабатывания, пропущенные во время простоя сервиса: пропустить их или выполнить один раз.

После сохранения конструктор показывает оценку числа запусков и стоимости в месяц, потому что каждый запуск оплачивается минимум как 30 секунд автоматизации. Обзор показывает следующий запуск по расписанию. Триггер передаёт scheduled_for, fired_at, cron, timezone и missed_by_s.

Вызван другим агентом#

Другой операционный агент проекта передаёт данные этому агенту через Вызвать другого агента или Диспетчер. Отправленные данные становятся данными триггера; caller_agent и caller_run_id указывают, кто вызвал. Используйте его для агентов, выполняющих одну задачу для нескольких других.

Ручной запуск#

Запускает поток из консоли или через API с введёнными вами данными. Полезно для досок, которые вы запускаете по требованию, например чтобы расшифровать одну запись по её URL.

Прослушивание реального события#

У триггеров Получен вебхук, Звонок завершён (АТС) и Вызван другим агентом в инспекторе есть кнопка Прослушать. Нажмите её, а затем вызовите событие: отправьте вебхук из другой системы, совершите звонок на АТС и положите трубку или запустите доску, которая вызывает эту. Следующее событие показывается в инспекторе в отформатированном виде точно так, как его получит триггер, и оно не выполняется, даже если агент выключен. Прослушивание длится десять минут. Нажмите Использовать как тестовые данные, чтобы запустить доску именно с этими данными.

Это самый быстрый способ узнать настоящие имена полей, которые отправляет система, вместо того чтобы угадывать их.