create-persistent-contact-association

Описание

Включает восстановление чатов на весь срок действия контакта. Дополнительную информацию о восстановлении чатов см. в разделе «Включение постоянного чата» в руководстве администратора Amazon Connect.

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

Синтаксис

  create-persistent-contact-association
--instance-id <value>
--initial-contact-id <value>
--rehydration-type <value>
--source-contact-id <value>
[--client-token <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]

Параметры

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

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

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

Это contactId текущего контакта, из которого вызывается API CreatePersistentContactAssociation.

--rehydration-type (строка)

Идентификатор контакта (contactId), выбранный для восстановления, зависит от выбранного типа.

ENTIRE_PAST_SESSION : Восстанавливает чат из последнего завершенного контакта предыдущего чата указанной завершенной сессии чата. Чтобы использовать этот тип, укажите initialContactId завершенной сессии чата в поле sourceContactId. В этом типе Amazon Connect определяет, какой контакт чата наиболее недавний в завершенной сессии чата, и использует его для запуска постоянного чата.
FROM_SEGMENT : Восстанавливает чат из указанного предыдущего контакта чата, предоставленного в поле sourceContactId.

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

Чтобы проиллюстрировать, как использовать тип восстановления, рассмотрим следующий пример: клиент запускает сессию чата. Агент a1 принимает чат, и начинается разговор между клиентом и агентом a1. Этот первый контакт создает идентификатор контакта **C1**. Агент a1 затем передает чат агенту a2. Это создает другой идентификатор контакта **C2**. В этот момент агент a2 завершает чат. Клиент перенаправляется в поток разъединения для опроса по завершении чата, который создает другой идентификатор контакта **C3**. После опроса по завершении чата сессия чата завершается. Позже клиент возвращается и хочет возобновить свою прошлую сессию чата. В этот момент у клиента могут быть следующие варианты использования:

Вариант использования 1: клиент хочет продолжить прошлую сессию чата, но хочет скрыть опрос по завершении чата. Для этого он использует следующее конфигурирование:
- Настройка
  - SourceContactId = “C2”
  - RehydrationType = “FROM_SEGMENT”
- Ожидаемое поведение
  - Это запускает постоянную сессию чата от указанного завершенного контакта (C2). Транскрипты прошлых сессий чата C2 и C1 доступны в текущей постоянной сессии чата. Обратите внимание, что сегмент чата C3 удаляется из постоянной сессии чата.
Вариант использования 2: клиент хочет продолжить прошлую сессию чата и просмотреть транскрипт всего предыдущего взаимодействия, включая опрос по завершении чата. Для этого он использует следующее конфигурирование:
- Настройка
  - SourceContactId = “C1”
  - RehydrationType = “ENTIRE_PAST_SESSION”
- Ожидаемое поведение
  - Это запускает постоянную сессию чата с последнего завершенного контакта чата (C3). Транскрипты прошлых сессий чата C3, C2 и C1 доступны в текущей постоянной сессии чата.

Возможные значения:

ENTIRE_PAST_SESSION
FROM_SEGMENT

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

Идентификатор контакта (contactId), с которого должна быть запущена постоянная сессия чата.

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

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

--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.

Вывод

ContinuedFromContactId -> (строка)

Идентификатор контакта (contactId), с которого запущена постоянная сессия чата. Это поле заполняется только для постоянных чатов.