describe-contact
Описание
Этот API находится в предварительной версии для Amazon Connect и может быть изменён.
Описывает указанный контакт.
Предупреждение
-
SystemEndpointне заполняется для контактов с методом инициирования MONITOR, QUEUE_TRANSFER или CALLBACK - Информация о контакте хранится в Amazon Connect в течение 24 месяцев с момента
InitiationTimestamp, а затем удаляется. В этом API возвращается только информация о контакте, доступная в Amazon Connect.
См. также: Документация API AWS
Синтаксис
describe-contact
--instance-id <value>
--contact-id <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 (строка)
--contact-id (строка)
--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
- text
- таблица
- 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.
Вывод
Контакт -> (структура)
Информация о контакте.
Arn -> (строка)
Id -> (строка)
InitialContactId -> (строка)
PreviousContactId -> (строка)
ContactAssociationId -> (строка)
InitiationMethod -> (строка)
Name -> (строка)
Description -> (строка)
Channel -> (строка)
QueueInfo -> (структура)
Если этот контакт был помещен в очередь, здесь содержится информация об очереди.
Id -> (строка)
EnqueueTimestamp -> (отметка времени)
AgentInfo -> (структура)
Информация об агенте, принявшем контакт.
Id -> (строка)
ConnectedToAgentTimestamp -> (отметка времени)
AgentPauseDurationInSeconds -> (целое число)
HierarchyGroups -> (структура)
Группы иерархии агента.
Level1 -> (структура)
Группа первого уровня иерархии агента.
Arn -> (строка)
Level2 -> (структура)
Группа второго уровня иерархии агента.
Arn -> (строка)
Level3 -> (структура)
Группа третьего уровня иерархии агента.
Arn -> (строка)
Level4 -> (структура)
Группа четвертого уровня иерархии агента.
Arn -> (строка)
Level5 -> (структура)
Группа пятого уровня иерархии агента.
Arn -> (строка)
DeviceInfo -> (структура)
Информация об устройстве агента.
PlatformName -> (строка)
PlatformVersion -> (строка)
OperatingSystem -> (строка)
Capabilities -> (структура)
Настройка разрешенных функций видео- и совместного использования экрана для участников, присутствующих в звонке. Более подробную информацию см. в разделе Настройка функций вызовов в приложении, веб-вызовов, видеозвонков и совместного использования экрана в руководстве администратора Amazon Connect.
Video -> (строка)
ScreenShare -> (строка)
SEND указывает, что участник может делиться своим экраном.AfterContactWorkDuration -> (целое число)
AfterContactWorkStartTimestamp и AfterContactWorkEndTimestamp.AfterContactWorkStartTimestamp -> (отметка времени)
AfterContactWorkEndTimestamp -> (отметка времени)
AfterContactWork для чатовых контактов и меняет статус своей активности на автономный или эквивалентный, без очистки контакта в CCP, могут наблюдаться расхождения для AfterContactWorkEndTimestamp.AgentInitiatedHoldDuration -> (целое число)
StateTransitions -> (список)
Список StateTransition для руководителя.
(структура)
Информация о переходе состояния руководителя.
State -> (строка)
StateStartTimestamp -> (отметка времени)
StateEndTimestamp -> (отметка времени)
InitiationTimestamp -> (отметка времени)
INBOUND - это время прибытия контакта. Для OUTBOUND - время начала набора номера агентом. Для CALLBACK - время создания контакта для обратного звонка. Для TRANSFER и QUEUE_TRANSFER - время начала перевода. Для API - время получения запроса. Для EXTERNAL_OUTBOUND - время начала набора номера внешнего участника агентом. Для MONITOR - время начала прослушивания контакта руководителем.DisconnectTimestamp -> (отметка времени)
LastUpdateTimestamp -> (отметка времени)
LastPausedTimestamp -> (отметка времени)
LastResumedTimestamp -> (отметка времени)
TotalPauseCount -> (целое число)
TotalPauseDurationInSeconds -> (целое число)
ScheduledTimestamp -> (отметка времени)
RelatedContactId -> (строка)
WisdomInfo -> (структура)
Информация о Amazon Connect Wisdom.
SessionArn -> (строка)
CustomerId -> (строка)
CustomerId может быть номером клиента из вашей CRM. Вы можете создать функцию Lambda для извлечения уникального идентификатора клиента звонившего из вашей системы CRM. Если вы включите функцию Amazon Connect Voice ID, это атрибут будет заполнен CustomerSpeakerId звонившего.CustomerEndpoint -> (структура)
Конечная точка клиента или внешнего участника.
Type -> (строка)
Address -> (строка)
DisplayName -> (строка)
SystemEndpoint -> (структура)
Системная конечная точка. Для INBOUND это номер телефона или адрес электронной почты, набранный клиентом. Для OUTBOUND и EXTERNAL_OUTBOUND это номер исходящего идентификатора вызывающего абонента, назначенный исходящей очереди, который используется для набора номера клиента. Для обратного звонка это отображается как Softphone для звонков, обрабатываемых агентами с softphone.
Type -> (строка)
Address -> (строка)
DisplayName -> (строка)
QueueTimeAdjustmentSeconds -> (целое число)
QueuePriority -> (целое число большого размера)
Tags -> (карта)
Теги, связанные с контактом. Это теги, сгенерированные Amazon Web Services и пользовательские теги.
ключ -> (строка)
значение -> (строка)
ConnectedToSystemTimestamp -> (отметка времени)
RoutingCriteria -> (структура)
Последние критерии маршрутизации для контакта.
Шаги -> (список)
Список шагов маршрутизации. Когда Amazon Connect не находит доступного агента, соответствующего требованиям на данном шаге за указанный период времени, критерии маршрутизации переходят к следующему шагу последовательно, пока не будет установлено соединение с агентом. Если все шаги исчерпаны, контакт будет предложен любому агенту в очереди.
(структура)
Шаг определяет критерии, используемые для маршрутизации к агенту
Срок действия -> (структура)
Объект для указания срока действия шага маршрутизации.
DurationInSeconds -> (целое число)
ExpiryTimestamp -> (метка времени)
Expression -> (структура)
Размеченная объединение для указания выражения для шага маршрутизации.
AttributeCondition -> (структура)
Объект для указания предопределенного условия атрибута.
Name -> (строка)
Value -> (строка)
ProficiencyLevel -> (число с плавающей точкой)
Range -> (структура)
Объект для определения минимального и максимального уровней мастерства.
MinProficiencyLevel -> (число с плавающей точкой)
MaxProficiencyLevel -> (число с плавающей точкой)
MatchCriteria -> (структура)
Объект для определения AgentsCriteria.
AgentsCriteria -> (структура)
Объект для определения agentIds.
AgentIds -> (список)
Объект для указания списка агентов по идентификатору пользователя.
(строка)
ComparisonOperator -> (строка)
AndExpression -> (список)
Список выражений маршрутизации, которые будут объединены операцией И.
(структура)
Размеченная объединение для указания выражения для шага маршрутизации.
AttributeCondition -> (структура)
Объект для указания предопределенного условия атрибута.
Name -> (строка)
Value -> (строка)
ProficiencyLevel -> (число с плавающей точкой)
Range -> (структура)
Объект для определения минимального и максимального уровней мастерства.
MinProficiencyLevel -> (число с плавающей точкой)
MaxProficiencyLevel -> (число с плавающей точкой)
MatchCriteria -> (структура)
Объект для определения AgentsCriteria.
AgentsCriteria -> (структура)
Объект для определения agentIds.
AgentIds -> (список)
Объект для указания списка агентов по идентификатору пользователя.
(строка)
ComparisonOperator -> (строка)
AndExpression -> (список)
Список выражений маршрутизации, которые будут объединены операцией И.
(… рекурсивно …)
OrExpression -> (список)
Список выражений маршрутизации, которые будут объединены операцией ИЛИ.
(… рекурсивно …)
NotAttributeCondition -> (структура)
Объект для указания предопределенного условия атрибута.
Name -> (строка)
Value -> (строка)
ProficiencyLevel -> (число с плавающей точкой)
Range -> (структура)
Объект для определения минимального и максимального уровней мастерства.
MinProficiencyLevel -> (число с плавающей точкой)
MaxProficiencyLevel -> (число с плавающей точкой)
MatchCriteria -> (структура)
Объект для определения AgentsCriteria.
AgentsCriteria -> (структура)
Объект для определения agentIds.
AgentIds -> (список)
Объект для указания списка агентов по идентификатору пользователя.
(строка)
ComparisonOperator -> (строка)
OrExpression -> (список)
Список выражений маршрутизации, которые будут объединены операцией ИЛИ.
(структура)
Размеченная объединение для указания выражения для шага маршрутизации.
AttributeCondition -> (структура)
Объект для указания предопределенного условия атрибута.
Name -> (строка)
Value -> (строка)
ProficiencyLevel -> (число с плавающей точкой)
Range -> (структура)
Объект для определения минимального и максимального уровней мастерства.
MinProficiencyLevel -> (число с плавающей точкой)
MaxProficiencyLevel -> (число с плавающей точкой)
MatchCriteria -> (структура)
Объект для определения AgentsCriteria.
AgentsCriteria -> (структура)
Объект для определения agentIds.
AgentIds -> (список)
Объект для указания списка агентов по идентификатору пользователя.
(строка)
ComparisonOperator -> (строка)
AndExpression -> (список)
Список выражений маршрутизации, которые будут объединены операцией И.
(… рекурсивно …)
OrExpression -> (список)
Список выражений маршрутизации, которые будут объединены операцией ИЛИ.
(… рекурсивно …)
NotAttributeCondition -> (структура)
Объект для указания предопределенного условия атрибута.
Name -> (строка)
Value -> (строка)
ProficiencyLevel -> (число с плавающей точкой)
Range -> (структура)
Объект для определения минимального и максимального уровней мастерства.
MinProficiencyLevel -> (число с плавающей точкой)
MaxProficiencyLevel -> (число с плавающей точкой)
MatchCriteria -> (структура)
Объект для определения AgentsCriteria.
AgentsCriteria -> (структура)
Объект для определения agentIds.
AgentIds -> (список)
Объект для указания списка агентов по идентификатору пользователя.
(строка)
ComparisonOperator -> (строка)
NotAttributeCondition -> (структура)
Объект для указания предопределенного условия атрибута.
Name -> (строка)
Value -> (строка)
ProficiencyLevel -> (число с плавающей точкой)
Range -> (структура)
Объект для определения минимального и максимального уровней мастерства.
MinProficiencyLevel -> (число с плавающей точкой)
MaxProficiencyLevel -> (число с плавающей точкой)
MatchCriteria -> (структура)
Объект для определения AgentsCriteria.
AgentsCriteria -> (структура)
Объект для определения agentIds.
AgentIds -> (список)
Объект для указания списка агентов по идентификатору пользователя.
(строка)
ComparisonOperator -> (строка)
Status -> (строка)
ActivationTimestamp -> (метка времени)
Index -> (целое число)
Customer -> (структура)
Информация о клиенте по контакту.
DeviceInfo -> (структура)
Информация об устройстве клиента.
PlatformName -> (строка)
PlatformVersion -> (строка)
OperatingSystem -> (строка)
Capabilities -> (структура)
Настройка разрешенных возможностей видео и совместного использования экрана для участников, присутствующих во время звонка. Для получения дополнительной информации см. Раздел «Настройка возможностей в приложении, в веб-браузере, видеозвонков и совместного использования экрана» в руководстве по работе с Amazon Connect.
Video -> (строка)
ScreenShare -> (строка)
SEND указывает, что участник может поделиться своим экраном.Campaign -> (структура)
Информация, связанная с кампанией.
CampaignId -> (строка)
AnsweringMachineDetectionStatus -> (строка)
CustomerVoiceActivity -> (структура)
Информация о голосовой активности клиента.
GreetingStartTimestamp -> (метка времени)
GreetingEndTimestamp -> (метка времени)
QualityMetrics -> (структура)
Информация о качестве подключения медиаустройства участника.
Agent -> (структура)
Информация о качестве подключения медиаустройства агента.
Audio -> (структура)
Информация о качестве звука агента
QualityScore -> (вещественное число)
PotentialQualityIssues -> (список)
Список потенциальных проблем, вызывающих ухудшение качества подключения медиаустройства. Если служба не обнаружила потенциальных проблем с качеством, список пуст.
Допустимые значения: HighPacketLoss | HighRoundTripTime | HighJitterBuffer
(строка)
Customer -> (структура)
Информация о качестве подключения медиаустройства клиента.
Audio -> (структура)
Информация о качестве звука клиента
QualityScore -> (вещественное число)
PotentialQualityIssues -> (список)
Список потенциальных проблем, вызывающих ухудшение качества подключения медиаустройства. Если служба не обнаружила потенциальных проблем с качеством, список пуст.
Допустимые значения: HighPacketLoss | HighRoundTripTime | HighJitterBuffer
(строка)
DisconnectDetails -> (структура)
Информация об опыте разрыва вызова.
PotentialDisconnectIssue -> (строка)
AdditionalEmailRecipients -> (структура)
Список дополнительных адресов электронной почты для контакта по электронной почте.
ToList -> (список)
Список дополнительных получателей электронной почты «КОМУ» для контакта по электронной почте.
(структура)
Информация о получателе электронной почты
Address -> (строка)
Адрес получателя электронной почты.
Тип: Строка
Ограничения по длине: Минимальная длина 1. Максимальная длина 256.
DisplayName -> (строка)
Имя для отображения получателя электронной почты.
Тип: Строка
Ограничения по длине: Минимальная длина 1. Максимальная длина 256.
CcList -> (список)
Список дополнительных получателей электронной почты «КОПИЯ» для контакта по электронной почте.
(структура)
Информация о получателе электронной почты
Address -> (строка)
Адрес получателя электронной почты.
Тип: Строка
Ограничения по длине: Минимальная длина 1. Максимальная длина 256.
DisplayName -> (строка)
Имя для отображения получателя электронной почты.
Тип: Строка
Ограничения по длине: Минимальная длина 1. Максимальная длина 256.
SegmentAttributes -> (карта)
Набор определённых системой пар «ключ-значение», хранящихся в отдельных сегментах контактов с помощью карты атрибутов. Атрибуты являются стандартными атрибутами Amazon Connect и могут быть доступны в потоках. Ключи атрибутов могут содержать только символы латинского алфавита, цифры, -, и _. Это поле может использоваться для отображения подтипа канала. Например, connect:Guide или connect:SMS.
key -> (строка)
value -> (структура)
Значение атрибута сегмента. Это структурировано как карта, где ключ – valueString, а значение – строка.
ValueString -> (строка)
ValueMap -> (карта)
Значение атрибута сегмента.
key -> (строка)
value -> (структура)
Значение атрибута сегмента. Это структурировано как карта, где ключ – valueString, а значение – строка.
ValueString -> (строка)
ValueMap -> (карта)
Значение атрибута сегмента.
key -> (строка)
( … рекурсивно … )
ValueInteger -> (целое число)
ValueInteger -> (целое число)
Recordings -> (список)
Если запись была включена, это информация о записях.
(структура)
Информация о голосовом сообщении, тексте чата или записи экрана.
StorageType -> (строка)
Location -> (строка)
MediaStreamType -> (строка)
ParticipantType -> (строка)
Информация о участнике разговора, является ли он агентом или клиентом. Типы участников следующие:
- Все
- Менеджер
- Агент
- Клиент
- Третья сторона
- Наблюдатель
FragmentStartNumber -> (строка)
FragmentStopNumber -> (строка)
StartTimestamp -> (метка времени)
StopTimestamp -> (метка времени)
Status -> (строка)
DeletionReason -> (строка)
DisconnectReason -> (строка)
ContactEvaluations -> (карта)
Информация об оценках контакта, где ключ – FormId, уникальный идентификатор формы.
key -> (строка)
value -> (структура)
Информация об оценках контакта, где ключ – FormId, уникальный идентификатор формы.
FormId -> (строка)
EvaluationArn -> (строка)
Status -> (строка)
StartTimestamp -> (метка времени)
EndTimestamp -> (метка времени)
DeleteTimestamp -> (метка времени)
ExportLocation -> (строка)
ContactDetails -> (структура)
Карта пар «ключ-значение» строкового типа, содержащая пользовательские атрибуты, слабо типизированные в контакте. Этот объект используется только для задач.
Name -> (строка)
Description -> (строка)
Attributes -> (карта)
Атрибуты контакта.
key -> (строка)
value -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.