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

Палитра слева в конструкторе группирует шаги: Запись, Понимание, Отчёты, Доставка, Сообщения, Хранилище и Поток. Нажмите на шаг на доске, чтобы настроить его в инспекторе; инспектор также перечисляет, что шаг производит для следующих шагов. Редко нужные настройки свёрнуты в раздел Дополнительные параметры.

Запись#

Скачать запись загружает запись звонка во временную папку, которая удаляется по окончании запуска; ничего не сохраняется. По умолчанию шаг берёт ссылку на запись из триггера. Максимальный размер (МБ) ограничивает скачивание (по умолчанию 200 МБ). Шаг производит file, filename, bytes и content_type.

Понимание#

Расшифровать превращает запись в текст.

• Язык речи: код, например el или en; если оставить пустым, язык определяется автоматически.
• Также на языках: дополнительные языки; переводы находятся в {{transcribe.translations}}.
• Разделить говорящих: делит текст на реплики, {{transcribe.segments}} (говорящий, начало и конец в секундах, текст).
• Назвать говорящих: numbers (1, 2) или agent_customer: каждая реплика помечается agent (ваша сторона звонка) или customer, что ИИ определяет по разговору и направлению звонка. Голос, который он не может отнести к стороне, сохраняет свой номер, а {{transcribe.speakers_note}} объясняет почему.

Шаг производит text, language, duration_sec, translations, segments, speakers и speakers_note.

Сводка пишет краткое содержание расшифровки или любого текста: кратко, подробно или списком, на выбранном вами языке, с необязательными дополнительными указаниями. Шаг производит text.

Отчёты#

Отчёт по вопросам отвечает на ваши заранее подготовленные вопросы по расшифровке (например, Сделал ли клиент заказ?) и строит онлайн-отчёт и книгу Excel, по желанию вместе с расшифровкой. Запуск показывает каждый ответ и место в звонке, где он был найден. Шаг производит title, answers и книгу для шага отправки письма.

Доставка#

Отправить письмо отправляет сообщение с подставленными значениями потока.

• Кому, Копия, Скрытая копия, Ответить на и Имя отправителя.
• Шаблон письма: один из фирменных макетов вашей учётной записи или никакого, чтобы отправить сообщение как есть (см. Шаблоны писем).
• Формат: обычный текст или HTML (к HTML также добавляется текстовая копия).
• Добавьте расшифровку в текст сообщения, приложите её файлом .txt, приложите отчёт Excel.

Вебхук вызывает ваш URL в этой точке потока: метод (POST, PUT, PATCH, GET, DELETE), параметры запроса, заголовки, аутентификация (bearer token, basic, API-ключ) и тело в формате JSON, формы или текста, причём в каждое значение подставляются данные потока. С Секретом подписи каждый вызов подписывается, чтобы ваш адрес мог проверить, что он пришёл от нас. Ваш адрес подтверждает получение ответом 2xx; любой другой ответ считается неудачной попыткой и повторяется. Шаг производит status, response и json (разобранный ответ) для следующих шагов.

Чтобы отправить в CRM расшифровку, разделённую по говорящим, укажите в теле "transcript": {"text": "{{transcribe.text}}", "segments": "{{transcribe.segments}}"}.

Оба шага доставки можно просмотреть и проверить по отдельности: см. Проектирование и тестирование.

Сообщения#

Отправить сообщение WhatsApp отвечает в WhatsApp внутри окна 24 часов, которое открыло последнее сообщение клиента: текст (до 4096 символов, с жирным шрифтом и курсивом WhatsApp), изображение или документ. Файл берётся по вашей публичной ссылке, из предыдущего шага или это отчёт Excel запуска. При закрытом окне шаг сразу завершается ошибкой, без повторов, поэтому соедините его ветку ошибки с Отправить шаблон WhatsApp.

Отправить шаблон WhatsApp отправляет один из ваших одобренных шаблонов, созданных в WhatsApp Manager от Meta, на любой номер, внутри окна или вне его. Выберите шаблон и его язык, заполните его переменные данными потока и добавьте файл заголовка, если он есть у шаблона. Отметьте Получатели согласились получать от нас сообщения WhatsApp: WhatsApp требует согласия получателя, и без него доска не сохранится. Запуск, начавшийся больше 24 часов назад, пропускает этот шаг. Meta выставляет счёт за сообщения по шаблонам вашему собственному бизнес-аккаунту WhatsApp.

Оба шага отправляют с номера, на который пришло сообщение триггера, или с номера, который вы выберете. Кому по умолчанию {{trigger.from}}, а клиент, скрывающий номер, доступен через {{trigger.user_id}}; после телефонного звонка отправляйте на {{trigger.contact_number}}. Когда Meta просит снизить темп, шаг пробует ещё 3 раза с интервалом 10 минут; когда Meta отклоняет сообщение из-за оплаты, шаг сразу завершается ошибкой. Сообщения, отправленные доской, видны в разговоре WhatsApp как отправленные автоматизацией и не ставят агента на паузу. Каждый шаг выдаёт wamid, to, number_id и conversation_id.

Хранилище#

S3 и AWS S3 работают с бакетами, файлами и папками в вашем собственном хранилище: загрузить запись или расшифровку, скопировать, получить список, скачать или удалить. См. Хранилище (S3).

Поток#

• Условие сравнивает значение (равно, не равно, содержит, больше, меньше, пусто, не пусто) и продолжает по ветке да или нет.
• Диспетчер отправляет данные сразу нескольким получателям: другим операционным агентам проекта, каждый из которых делает свою работу, и адресам вебхуков. Получатели, которые уже успешно приняли данные, при повторе не получают их снова.
• Вызвать другого агента запускает одного другого операционного агента проекта с данными из этого потока и по умолчанию ждёт его результата (status, output).

Ветки успеха и ошибки#

Стрелка может выходить из шага при успехе или при ошибке. Ветка ошибки позволяет сообщить кому-нибудь, когда шаг сдаётся, например отправить письмо команде, если ваша CRM отклонила расшифровку. В настройках повторов шага выберите, переходить ли на ветку ошибки после исчерпания повторов или при первой же ошибке.