Spec-Zone.ru › AWS CLI v2

[ aws . connect ]

start-web-rtc-contact

Описание

Устанавливает входящий внутриприложный, веб- или видеозвонок на контакт и затем инициирует поток. Выполняются действия в потоке, которые указаны (в ContactFlowId) и присутствуют в экземпляре Amazon Connect (указанном как InstanceId).

См. также: Документацию API AWS

Синтаксис

  start-web-rtc-contact
[--attributes <value>]
[--client-token <value>]
--contact-flow-id <value>
--instance-id <value>
[--allowed-capabilities <value>]
--participant-details <value>
[--related-contact-id <value>]
[--references <value>]
[--description <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--attributes (отображение)

Пользовательская пара «ключ-значение» с использованием отображения атрибутов. Атрибуты — стандартные атрибуты Amazon Connect, и к ним можно получить доступ в потоках так же, как и к любым другим атрибутам контакта.

Может быть до 32 768 байтов UTF-8 для всех пар «ключ-значение» на контакт. Ключи атрибутов могут включать только буквенно-цифровые символы, символы «-» и «_».

ключ -> (строка)

значение -> (строка)

Краткая форма:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--client-token (строка)

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы обеспечить идемпотентность запроса. Если не предоставлен, Amazon Web Services SDK заполняет это поле. Дополнительную информацию об идемпотентности см. в разделе Обеспечение безопасности повторных попыток с помощью идемпотентных API .

Токен действителен в течение 7 дней после создания. Если контакт уже запущен, возвращается идентификатор контакта.

--contact-flow-id (строка)

Идентификатор потока для вызова. Чтобы увидеть ContactFlowId на веб-сайте администрирования Amazon Connect, в меню навигации перейдите к Маршрутизация , Потоки . Выберите поток. На странице потока, под названием потока, выберите Показать дополнительную информацию о потоке . ContactFlowId — это последняя часть ARN, показанная здесь в жирном формате:

arn:aws:connect:us-west-2:xxxxxxxxxxxx:instance/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/contact-flow/846ec553-a005-41c0-8341-xxxxxxxxxxxx

--instance-id (строка)

Идентификатор экземпляра Amazon Connect. Вы можете найти идентификатор экземпляра в Amazon Resource Name (ARN) экземпляра.

--allowed-capabilities (структура)

Информация о возможностях совместного использования видео участниками (клиент, агент).

Клиент -> (структура)

Информация о возможностях совместного использования видео клиентом.

Видео -> (строка)

Конфигурация с возможностями видео- и совместного использования экрана для участников в ходе вызова.

Совместное использование экрана -> (строка)

Возможность совместного использования экрана, включенная для участника. SEND указывает, что участник может поделиться своим экраном.

Агент -> (структура)

Информация о возможностях совместного использования видео агентом.

Видео -> (строка)

Конфигурация с возможностями видео- и совместного использования экрана для участников в ходе вызова.

Совместное использование экрана -> (строка)

Возможность совместного использования экрана, включенная для участника. SEND указывает, что участник может поделиться своим экраном.

Краткая форма:

Customer={Video=string,ScreenShare=string},Agent={Video=string,ScreenShare=string}

Синтаксис JSON:

{
  "Customer": {
    "Video": "SEND",
    "ScreenShare": "SEND"
  },
  "Agent": {
    "Video": "SEND",
    "ScreenShare": "SEND"
  }
}

--participant-details (структура)

Подробности клиента.

Имя для отображения -> (строка)

Имя для отображения участника.

Краткая форма:

DisplayName=string

Синтаксис JSON:

{
  "DisplayName": "string"
}

--related-contact-id (строка)

Уникальный идентификатор контакта Amazon Connect. Этот идентификатор относится к запуску контакта.

--references (отображение)

Отформатированный URL-адрес, отображаемый агенту в панели управления контактами (CCP). Задачи могут иметь следующие типы ссылок при создании: URL | NUMBER | STRING | DATE | EMAIL . ATTACHMENT не является поддерживаемым типом ссылки во время создания задачи.

ключ -> (строка)

значение -> (структура)

Хорошо сформированные данные о контакте, используемые агентами для выполнения запроса на контакт. Можно иметь до 4096 байтов UTF-8 по всем ссылкам для контакта.

Значение -> (строка)

Действительное значение для ссылки. Например, для ссылки на URL-адрес — отформатированный URL-адрес, отображаемый агенту в панели управления контактами (CCP).

Тип -> (строка)

Тип ссылки. DATE должен быть типа метки времени эпохи.

Статус -> (строка)

Статус типа ссылки на вложение.

Arn -> (строка)

Amazon Resource Name (ARN) ссылки

Причина статуса -> (строка)

Соответствующие детали, почему ссылка не была успешно создана.

Краткая форма:

KeyName1=Value=string,Type=string,Status=string,Arn=string,StatusReason=string,KeyName2=Value=string,Type=string,Status=string,Arn=string,StatusReason=string

Синтаксис JSON:

{"string": {
      "Value": "string",
      "Type": "URL"|"ATTACHMENT"|"CONTACT_ANALYSIS"|"NUMBER"|"STRING"|"DATE"|"EMAIL"|"EMAIL_MESSAGE",
      "Status": "AVAILABLE"|"DELETED"|"APPROVED"|"REJECTED"|"PROCESSING"|"FAILED",
      "Arn": "string",
      "StatusReason": "string"
    }
  ...}

--description (строка)

Описание задачи, отображаемое агенту в панели управления контактами (CCP).

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному в --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с использованием значения, предоставленного в JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит JSON-пример входных данных, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входных данных YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверит входные данные команд и вернёт пример выходного JSON для данной команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить стандартный URL-адрес команды указанным URL-адресом.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI будет выполнять только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команд.

  • json
  • текст
  • таблица
  • yaml
  • yaml-потоковый

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла аутентификации.

--region (строка)

Регион для использования. Переопределяет параметры конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • включено
  • выключено
  • авто

--no-sign-request (булево)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Сводка сертификатов CA для использования при проверке сертификатов SSL. Переопределяет параметры конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, который будет использоваться для двоичных блоков. По умолчанию используется формат base64. Формат base64 предполагает, что двоичные блоки предоставляются как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, который соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить страницу cli для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запрос параметров ввода CLI.

Вывод

ConnectionData -> (структура)

Информация, необходимая для клиентского приложения (мобильное приложение или веб-сайт) для подключения к звонку.

Attendee -> (структура)

Информация о участнике, включая идентификатор участника и токен присоединения.

AttendeeId -> (строка)

Идентификатор участника Amazon Chime SDK.

JoinToken -> (строка)

Токен присоединения, используемый участником Amazon Chime SDK.

Meeting -> (структура)

Встреча, созданная с использованием Amazon Chime SDK.

MediaRegion -> (строка)

Регион Amazon Web Services, в котором вы создаете встречу.

MediaPlacement -> (структура)

Расположение медиа для встречи.

AudioHostUrl -> (строка)

URL аудио-хоста.

AudioFallbackUrl -> (строка)

URL резервного аудио.

SignalingUrl -> (строка)

URL сигнализации.

TurnControlUrl -> (строка)

URL управления поворотом.

EventIngestionUrl -> (строка)

URL обработки событий, в который вы отправляете события встречи клиента.

MeetingFeatures -> (структура)

Настройки конфигурации функций, доступных для встречи.

Audio -> (структура)

Настройки конфигурации аудиофункций, доступных для встречи.

EchoReduction -> (строка)

Обеспечивает возможность подавления эха для клиентов, подключенных к встрече.

MeetingId -> (строка)

Идентификатор встречи Amazon Chime SDK.

ContactId -> (строка)

Идентификатор контакта в этом экземпляре Amazon Connect.

ParticipantId -> (строка)

Идентификатор участника контакта. ParticipantId для участника контакта остается неизменным на протяжении всего жизненного цикла контакта.

ParticipantToken -> (строка)

Токен, используемый участником контакта для вызова API CreateParticipantConnection. Токен участника действителен в течение всего срока действия участника контакта.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API