As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Lista de atributos de contato disponíveis no Amazon Connect e suas JSONPath referências
As tabelas a seguir descrevem os atributos de contato disponíveis no Amazon Connect.
A JSONPath referência para cada atributo é fornecida para que você possa criar cadeias de texto dinâmicas.
Atributos do sistema
Estes são atributos predefinidos no Amazon Connect. Você pode fazer referência a atributos do sistema, mas não pode criá-los.
Nem todos os blocos em um fluxo oferecem suporte ao uso de atributos do sistema. Por exemplo, você não pode usar um atributo do sistema para armazenar informações do cliente. Em vez disso, use um atributo definido pelo usuário para armazenar os dados de entrada de um cliente.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Região da AWS |
Quando usado, isso retorna o Região da AWS local onde o contato está sendo tratado. Por exemplo, us-west-2, us-east-1 e assim por diante. |
Sistema |
$. AwsRegion ou $ ['AwsRegion'] |
Endereço ou número do cliente |
O número de telefone ou endereço de e-mail do cliente, se estiver usando o canal EMAIL. Compatível com chamadas de voz, SMS, mensagens WhatsApp comerciais e e-mail. Quando usado em um fluxo de sussurro de saída, esse é o número que o agente disca para falar com o cliente. Quando usado em fluxos de entrada, esse é o número do qual o cliente fez a chamada. Esse atributo está incluído nos registros de contato. Quando usado em uma função Lambda, ele é incluído no objeto de entrada abaixo. CustomerEndpoint |
Sistema |
$. CustomerEndpoint.Endereço |
ID da do cliente |
O número de identificação do cliente. Por exemplo, CustomerId pode ser um número de cliente do seu CRM. Você pode criar uma função do Lambda para extrair do seu sistema de CRM o ID exclusivo de cliente do chamador. O Voice ID usa esse atributo como |
Sistema |
$.CustomerId |
Endereço ou número do sistema |
Compatível com chamadas de voz, SMS, e-mail e mensagens WhatsApp comerciais. O número que o cliente usou para ligar para sua central de atendimento ou o endereço de e-mail para o qual o contato enviou mensagem se estiver usando o canal EMAIL. Esse atributo está incluído nos registros de contato. Quando usado em uma função Lambda, ele é incluído no objeto de entrada abaixo. SystemEndpoint |
Sistema |
$. SystemEndpoint.Endereço |
Nome de exibição do cliente |
O nome do cliente no e-mail que ele enviou para sua central de atendimento. |
Sistema |
$.CustomerEndpoint.DisplayName |
Nome de exibição do sistema |
O nome de exibição do endereço de e-mail que o cliente enviou. |
Sistema |
$.SystemEndpoint.DisplayName |
Lista de endereços de e-mail CC |
A lista completa de endereços de e-mail copiados no e-mail de entrada enviado à sua central de atendimento. |
Sistema |
$.AdditionalEmailRecipients.CcList |
Lista de endereços de e-mail Para |
A lista completa de endereços de e-mail de destinatário no e-mail de entrada enviado à sua central de atendimento. |
Sistema |
$.AdditionalEmailRecipients.ToList |
Número de retorno de chamada do cliente |
O número que o Amazon Connect usa para ligar de volta para o cliente. Esse número pode ser usado para um retorno de chamada em fila ou quando um atendente está ligando do CCP. Transfira para a funcionalidade de fila de retorno de chamada ou para um atendente ligando do CCP. O valor padrão é o número que o cliente usou para ligar para o centro de contatos. No entanto, pode ser substituído pelo bloco Set callback number (Definir número de retorno de chamada). Este atributo não é incluído nos registros de contato e não é acessível na entrada do Lambda. No entanto, você pode copiar o atributo para um atributo definido pelo usuário com o bloco Set contact attributes (Definir atributos do contato), que está incluído nos registros de contato. Você também pode transmitir esse atributo como um parâmetro de entrada do Lambda em um bloco Função AWS Lambda , que não está incluído nos registros de contato. |
Sistema |
não aplicável |
Informações armazenadas do cliente |
Um atributo criado pela invocação mais recente de um bloco Armazenar entradas do cliente. Os valores de atributo criados pela invocação do bloco Armazenar entradas do cliente mais recente. Este atributo não é incluído nos registros de contato e não é acessível na entrada do Lambda. Você pode copiar o atributo para um atributo definido pelo usuário com o bloco Set contact attributes (Definir atributos do contato), que está incluído nos registros de contato. Você também pode transmitir esse atributo como um parâmetro de entrada do Lambda em um bloco Função AWS Lambda . |
Sistema |
$.StoredCustomerInput |
Nome da fila |
O nome da fila do . |
Sistema |
$.Queue.Name |
ARN da fila |
O ARN da fila. |
Sistema |
$.Queue.ARN |
Número de saída da fila |
O número do ID do chamador de saída para a fila selecionada. Esse atributo só está disponível em fluxos de sussurro de saída. |
Sistema |
|
Voz do texto para fala |
O nome da voz do Amazon Polly a ser usada text-to-speech em um fluxo de contato. |
Sistema |
$.TextToSpeechVoiceId |
ID do contato |
O identificador exclusivo do contato. |
Sistema |
$.ContactId |
ID do contato inicial |
O identificador exclusivo de contato associado à primeira interação entre o cliente e a central de atendimento. Use o ID de contato inicial para rastrear contatos entre fluxos. |
Sistema |
$.InitialContactId |
ID do contato da tarefa |
O identificador exclusivo do contato da tarefa. Use o ID de contato da tarefa para rastrear tarefas entre fluxos. |
Sistema |
$.Tarefa. ContactId |
ID do contato anterior |
O identificador exclusivo do contato antes de ser transferido. Use o ID de contato anterior para acompanhar os contatos entre fluxos. |
Sistema |
$.PreviousContactId |
Canal |
O método usado para entrar em contato com sua central de atendimento: VOICE, CHAT, TASK, EMAIL. |
Sistema |
$.Channel |
Instância ARN |
O ARN da sua instância do Amazon Connect. |
Sistema |
$.InstanceARN |
Método de iniciação |
Como o contato foi iniciado. Os valores válidos são: Valid values include: INBOUND, OUTBOUND, TRANSFER, CALLBACK, QUEUE_TRANSFER, EXTERNAL_OUTBOUND, MONITOR, DISCONNECT, WEBRTC_API e API. |
Sistema |
$.InitiationMethod |
Nome |
O nome da tarefa . |
Sistema |
$.Name |
Description |
Uma descrição da tarefa. |
Sistema |
$.Description |
Referências |
Links para outros documentos relacionados a um contato. |
Sistema |
$.Referências. |
Linguagem |
A linguagem do conteúdo. Use o java.util.Locale padrão. Por exemplo, en-US para inglês dos Estados Unidos, ja-JP para japonês etc. |
Sistema |
$.LanguageCode |
Tipo de endpoint do sistema |
O tipo do endpoint do sistema. O valor válido é TELEPHONE_NUMBER. |
Sistema |
$. SystemEndpoint.Tipo |
Tipo de endpoint do cliente |
O tipo de endpoint do cliente. O valor válido é TELEPHONE_NUMBER. |
Sistema |
$. CustomerEndpoint.Tipo |
Número do ID do chamador de saída da fila |
O número do ID do chamador de saída definido para a fila. Ele pode ser útil para reverter o ID do chamador após a definição de um ID de chamador personalizado. |
Sistema |
$.Fila. OutboundCallerId.Endereço |
Tipo de número do ID do chamador de saída da fila |
O tipo de número do ID do chamador de saída. O valor válido é TELEPHONE_NUMBER. |
Sistema |
$.Fila. OutboundCallerId.Tipo |
Tags |
As tags usadas para organizar, rastrear ou controlar o acesso deste recurso. Para obter mais informações sobre tags, consulte Adicionar tags a recursos no Amazon Connect e Configurar faturamento granular para uma exibição detalhada do uso do Amazon Connect. |
Sistema |
$.Tags |
Atributos do segmento
Atributos de segmento são um conjunto de pares de chave-valor definidos pelo sistema armazenados em segmentos de contato individuais usando um mapa de atributos. No entanto, é possível criar atributos de segmento definidos pelo usuário, conforme descrito na tabela a seguir.
| Atributo | Description | Valores permitidos | Tipo | JSONPath Referência |
|---|---|---|---|---|
connect:Subtype |
Representa o subtipo do canal usado para o contato. |
|
ValueString |
$. SegmentAttributes['Conectar: subtipo'] |
connect:Direction |
Representa a direção do contato. Por exemplo, entrada ou saída. |
|
ValueString |
$. SegmentAttributes['conectar: direção'] |
conectar: CreatedByUser |
Representa o ARN do usuário que criou a tarefa. |
ValueString |
$. SegmentAttributes['conectar: CreatedByUser '] |
|
conectar: AssignmentType |
Representa como uma tarefa é atribuída. |
"SELF" |
ValueString |
$. SegmentAttributes['conectar: AssignmentType '] |
conectar: EmailSubject |
Representa o assunto de um contato de e-mail. |
ValueString |
$. SegmentAttributes['conectar: EmailSubject '] |
|
conectar: ScreenSharingDetails |
A seção A chave |
|
ValueString |
$. SegmentAttributes['conectar: ScreenSharingDetails '] |
conectar: ContactExpiry |
Contém os detalhes da expiração do contato, como |
valueMap |
$. SegmentAttributes['conectar: ContactExpiry '] |
|
conectar: CustomerAuthentication |
Os detalhes de autenticação do contato do chat. |
|
ValueMap |
$. SegmentAttributes['conectar: CustomerAuthentication '] |
| conectar: ValidationTestType |
Representa o tipo de teste e simulação. Esse campo permanece vazio para contatos não simulados. Você pode usar esse atributo no painel de análise para filtrar os contatos reais do cliente ou para identificar se um contato é simulado em seu objeto de registro de contato. |
“VALIDAÇÃO DE EXPERIÊNCIA” | ValueString | $.Segment.Attributes ['conectar: '] ValidationTestType |
ID de cliente |
O identificador do cliente da aplicação Amazon Cognito. |
ValueString |
$. SegmentAttributes['conectar: CustomerAuthentication '] [' ClientId '] |
|
Identificar o provedor |
O provedor de identidade usado para autenticar o cliente. |
ValueString |
$. SegmentAttributes['conectar: CustomerAuthentication '] [' IdentityProvider '] |
|
Status |
O status do processo de autenticação. |
|
ValueString |
$. SegmentAttributes['conectar: CustomerAuthentication '] [' Status '] |
ID do cliente associado |
O número de identificação do cliente. Esse é um identificador personalizado ou um identificador de perfil do cliente. |
ValueString |
$. SegmentAttributes['conectar: CustomerAuthentication '] [' AssociatedCustomerId '] |
|
Método de autenticação |
Um fluxo de trabalho de autenticação gerenciado pelo Amazon Connect ou fluxo de trabalho de autenticação gerenciado pelo cliente. |
|
ValueString |
$. SegmentAttributes['conectar: CustomerAuthentication '] [' AuthenticationMethod '] |
Assunto do e-mail |
O assunto no e-mail que o cliente enviou para sua central de atendimento. Isso é útil caso você queira examinar o assunto do e-mail em relação a determinadas palavras-chave. |
Atributo do segmento |
$. SegmentAttributes['conectar: EmailSubject '] |
|
Veredicto de spam do Amazon SES |
Quando o e-mail chega à sua central de atendimento, o Amazon SES verifica se há spam. Você pode conferir a condição COM FALHA e, depois, descartar o e-mail ou colocá-lo em uma fila especial para que os supervisores o analisem. |
Atributo do segmento |
$. SegmentAttributes['Connect:x-ses-spam-veredicto'] |
|
Veredicto de vírus do Amazon SES |
Quando o e-mail chega à sua central de atendimento, o Amazon SES verifica se há vírus. Você pode conferir a condição COM FALHA e, depois, descartar o e-mail ou colocá-lo em uma fila especial para que os supervisores o analisem. |
Atributo do segmento |
$. SegmentAttributes['Connect:X-SES-Virus-Verdict'] |
|
Atributos definidos pelo usuário |
Você pode escolher qualquer atributo definido pelo usuário e armazená-lo no contato em atributos do segmento. O atributo deve ser predefinido para que possa ser usado para armazenar valores sobre o contato. Consulte Usar atributos de segmento de contato. |
Se nenhum valor for predefinido, o Amazon Connect permitirá todos os valores de string. Esse também é o caso quando a opção Impor valores válidos na página Adicionar atributos predefinidos não está selecionada. Quando a opção Impor valores válidos é selecionada e os valores são predefinidos, o contato armazena somente valores válidos e predefinidos para a chave de atributo predefinida. (Se estiver usando a API, consulte o EnableValueValidationOnAssociationparâmetro.) |
String |
$. SegmentAttributes['Nome_chave do atributo'] |
Atributos de visualizações
A tabela a seguir lista os atributos de visualizações disponíveis no Amazon Connect.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Ação |
A ação realizada pelo usuário que interage com a visualização. As ações aparecem como ramificações de fluxo do bloco Mostrar exibição |
Visualizações |
$.Views.Action |
Visualizar dados do resultado |
Os dados de saída da interação do usuário com a visualização com base no componente em que ele realizou uma ação. |
Visualizações |
$.Visualizações. ViewResultData |
Capacidades e atributos
A tabela a seguir lista os atributos de recursos disponíveis no Amazon Connect. Esses atributos comportam recursos de compartilhamento de tela e vídeo. Para obter mais informações, consulte Configurar recursos de chamadas na aplicação, pela web e por vídeo e recursos de compartilhamento de tela.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Recurso de compartilhamento de tela do atendente |
O recurso de compartilhamento de tela habilitado para o participante. |
Capacidades |
$.Capacidades.Agente. ScreenShare |
Capacidade de vídeo do atendente |
O recurso de compartilhamento de vídeo habilitado para o participante durante a chamada. |
Capacidades |
$.Capabilities.Agent.Video |
Recurso de compartilhamento de tela do cliente |
O recurso de compartilhamento de tela habilitado para o participante. |
Capacidades |
$.Capacidades.Cliente. ScreenShare |
Recurso de vídeo do cliente |
O recurso de compartilhamento de vídeo habilitado para o participante durante a chamada. |
Capacidades |
$.Capabilities.Customer.Video |
Atributos do agente
A tabela a seguir lista os atributos de atendentes disponíveis no Amazon Connect.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Nome de usuário do agente |
O nome de usuário que um atendente usa para fazer login no Amazon Connect. |
Sistema |
$.Agente. UserName |
Nome do agente |
O nome do atendente como foi inserido em sua conta de usuário do Amazon Connect. |
Sistema |
$.Agente. FirstName |
Sobrenome do agente |
O sobrenome do atendente como foi inserido em sua conta de usuário do Amazon Connect. |
Sistema |
$.Agente. LastName |
ARN do agente |
O ARN do agente. |
Sistema |
$.Agent.ARN |
nota
Quando você usa um atributo de contato do atendente em um fluxo Transferir para atendente, os atributos do atendente refletem o atendente de destino, não aquele que iniciou a transferência.
Os atributos do atendente estão disponíveis apenas nos seguintes tipos de fluxos:
-
Sussurros do agente
-
Sussurros do cliente
-
Espera do agente
-
Retenção de clientes
-
Sussurro de saída
-
Transferir para agente. Nesse caso, os atributos do atendente refletem o atendente de destino, não aquele que iniciou a transferência.
Os atributos do atendente não estão disponíveis nos seguintes tipos de fluxo:
-
Fila de clientes
-
Transferir para fila
-
Fluxo de entrada
Atributos da fila
Esses atributos do sistema são exibidos quando você usa um bloco Get queue metrics (Obter métricas de fila) no fluxo.
Se não há atividade no momento na central de contatos, são retornados valores nulos para esses atributos.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Nome da fila |
O nome da fila para a qual as métricas foram recuperadas. |
Sistema |
$.Metrics.Queue.Name |
ARN da fila |
O ARN da fila para a qual as métricas foram recuperadas. |
Sistema |
$.Metrics.Queue.ARN |
Contatos na fila |
O número de contatos atualmente na fila. |
Sistema |
$.Metrics.Queue.Size |
Contato mais antigo na fila |
Para o contato que está na fila há mais tempo, o período em que o contato ficou na fila, em segundos. |
Sistema |
$.Métricas.Fila. OldestContactAge |
Agentes online |
O número de agentes online no momento, ou seja, conectados e em qualquer estado diferente de offline. |
Sistema |
$.Metrics.Agents.Online.Count |
Agentes disponíveis |
O número de agentes cujo estado é definido como disponível. |
Sistema |
$.Metrics.Agents.Available.Count |
Agentes fornecidos |
O número de agentes fornecidos no momento, ou seja, agentes que estão conectados e em estado disponível, ACW ou ocupado. |
Sistema |
$.Metrics.Agents.Staffed.Count |
Agentes em trabalho pós-atendimento |
O número de agentes atualmente no estado ACW. |
Sistema |
$.Métricas.Agentes. AfterContactWork.Contagem |
Agentes ocupados |
O número de agentes ativos no momento em um contato. |
Sistema |
$.Metrics.Agents.Busy.Count |
Número de agentes com chamadas perdidas |
O número de agentes no estado de chamada perdida, que é o estado em que um agente entra após um contato não atendido. |
Sistema |
$.Metrics.Agents.Missed.Count |
Agentes em estado improdutivo |
O número de agentes em um estado improdutivo (NPT). |
Sistema |
$.Métricas.Agentes. NonProductive.Contagem |
Atributos de metadados de chamada telefônica (atributos de chamada)
Os metadados de telefonia fornecem informações adicionais relacionadas à origem de chamadas de operadoras de telefonia.
Atributo |
Description |
Tipo |
JSONPath Referência |
|---|---|---|---|
P-Charge-Info |
A parte responsável pelas cobranças associadas à chamada. |
Sistema |
$.Media.Sip.Headers.P-Charge-Info |
De |
A identidade do usuário final associado à solicitação. |
Sistema |
$.Media.Sip.Headers.From |
Para |
As informações sobre a parte chamada ou o destinatário da solicitação. |
Sistema |
$.Media.Sip.Headers.To |
ISUP-OLI |
Indicador de linha de origem (OLI). Mostra o tipo de chamada de linha (por exemplo, PSTN, chamada de serviço 800, wireless/cellular PCS, telefone público). |
Sistema |
$.Media.Sip.Headers.ISUP-OLI |
JIP |
Parâmetro de indicação de jurisdição (JIP). Indica a localização geográfica do chamador/switch. Valor de exemplo: 212555 |
Sistema |
$.Media.Sip.Headers.JIP |
Hop-Counter |
Contador de saltos Valor de exemplo: 0 |
Sistema |
$.Media.Sip.Headers.Hop-Counter |
Originating-Switch |
Switch de origem. Valor de exemplo: 710 |
Sistema |
$.Media.Sip.Headers.Originating-Switch |
Originating-Trunk |
Tronco de origem. Valor de exemplo: 0235 |
Sistema |
$.Media.Sip.Headers.Originating-Trunk |
Call-Forwarding-Indicator |
Indicadores de encaminhamento de chamadas (por exemplo, cabeçalho de desvio). Indica a origem nacional ou internacional da chamada. Exemplo de valor: sip:+15555555555@public-vip.us2.telphony-provider.com;reason=uncondicional |
Sistema |
$.Media.Sip.Headers.Call-Forwarding-Indicator |
Calling-Party-Address |
Endereço do chamador (número). NPAC dip mostra o tipo de linha real e a chave geográfica nativa. Valor de exemplo: 15555555555;noa=4 |
Sistema |
$.Media.Sip.Headers.Calling-Party-Address |
Called-Party-Address |
Endereço da parte chamada (número). Valor de exemplo: 15555555555;noa=4 |
Sistema |
$.Media.Sip.Headers.Called-Party-Address |
Metadados SIPREC |
XML de metadados SIPREC recebido pelo conector do Amazon Contact Lens |
Sistema |
$.Media.Sip. SiprecMetadata |
nota
A disponibilidade dos metadados de telefonia não é consistente em todos os provedores de telefonia e pode não estar disponível em todos os casos. Isso pode resultar em valores vazios.
Atributos de mensagem inicial do chat
Atributo |
Description |
Tipo |
JSONPath Referência |
|---|---|---|---|
InitialMessage |
A mensagem inicial fornecida pelo cliente em um chat na web ou por SMS. |
Sistema |
$.Mídia. InitialMessage |
Atributos de e-mail
A tabela a seguir lista os atributos de e-mail disponíveis no Amazon Connect.
Atributo |
Description |
Tipo |
JSONPath Referência |
|---|---|---|---|
Mensagem de e-mail (texto sem formatação) |
Ao usar o bloco Obter fluxo de conteúdo armazenado, ele armazenará a versão em texto simples da mensagem de e-mail dos contatos de e-mail. |
Sistema |
$.E-mail. EmailMessage. Texto sem formatação |
Atributos de streams de mídia
A tabela a seguir lista os atributos que podem ser usados para identificar o local no streaming de mídia ao vivo onde o áudio do cliente começa e termina.
Atributo |
Description |
Tipo |
JSONPath Referência |
|---|---|---|---|
ARN do stream de áudio do cliente |
O ARN do Kinesis Video Stream usado para streaming de mídia ao vivo que inclui os dados do cliente para referência. |
Fluxos de mídia |
$. MediaStreams.customer.audio.StreamArn |
A data e hora de início do áudio do cliente no Kinesis Video Stream usado para streaming de mídia ao vivo. |
Quando o streaming de áudio do cliente foi iniciado. |
Fluxos de mídia |
$. MediaStreams.Cliente.Áudio. StartTimestamp |
Data e hora do término do áudio do cliente |
Quando o streaming de áudio do cliente interrompeu o streaming de vídeo do Kinesis usado para o streaming de mídia ao vivo. |
Fluxos de mídia |
$. MediaStreams.Cliente.Áudio. StopTimestamp |
Número do fragmento do início do áudio do cliente |
O número que identifica o fragmento do Kinesis Video Streams no fluxo usado para streaming de mídia em tempo real, em que o fluxo de áudio do cliente começou. |
Fluxos de mídia |
$. MediaStreams.Cliente.Áudio. StartFragmentNumber |
Atributos de contato do Amazon Lex
A tabela a seguir lista os atributos que são retornados pelos bots do Amazon Lex. Eles também são conhecidos como atributos da sessão.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Intenções alternativas |
Lista de intenções alternativas disponíveis no Amazon Lex. Cada intenção tem uma pontuação de confiança correspondente e espaços a serem preenchidos. |
Lex |
$.Lex. AlternativeIntents. $.Lex. AlternativeIntents. $.Lex. AlternativeIntents. $.Lex. AlternativeIntents. $.Lex. AlternativeIntents. $.Lex. AlternativeIntents. $.Lex. AlternativeIntents. $.Lex. AlternativeIntents. $.Lex. AlternativeIntents. Onde |
Pontuação de confiança da intenção |
A pontuação de confiança da intenção retornada pelo Amazon Lex. |
Lex |
$.Lex. IntentConfidence.Pontuação |
Nome da intenção |
A intenção do usuário retornada pelo Amazon Lex. |
Lex |
$.Lex. IntentName |
Rótulo de sentimento |
O sentimento inferido no qual o Amazon Comprehend tem a maior confiança. |
Lex |
$.Lex. SentimentResponse.Rótulo |
Pontuações de sentimento |
A probabilidade de o sentimento ter sido inferido corretamente. |
Lex |
$.Lex. SentimentResponse.Pontuações. Positivo $.Lex. SentimentResponse.Pontuações. Negativas $.Lex. SentimentResponse.Pontuações. Misto $.Lex. SentimentResponse.Pontuações. Neutro |
Atributos da sessão |
Mapa de pares de chaves/valores que representam as informações de contexto específicas da sessão. |
Lex |
$.Lex. SessionAttributes.Chave de atributo |
Slots |
Mapa de slots de intenção (pares de chaves/valores) do Amazon Lex detectados nas informações de entrada do usuário durante a interação. |
Lex |
$.Lex.Slots.slotName |
Estado do diálogo |
O último estado de diálogo retornado de um bot do Amazon Lex. O valor será 'Fulfilled' (realizado) se uma intenção tiver sido retornada ao fluxo. |
N/A (nenhum tipo aparece na interface do usuário) |
$.Lex. DialogState |
Atributos de contato do chamado
A tabela a seguir lista os atributos usados com Chamados do Amazon Connect.
| Atributo | Description | Tipo | JSONPath Referência | Origem dos dados |
|---|---|---|---|---|
|
ID do caso |
Identificador exclusivo do caso no formato UUID (por exemplo, 689b0bea-aa29-4340-896d-4ca3ce9b6226) | texto |
$.Case.case_id |
Amazon Connect |
|
Motivo do caso |
O motivo da abertura do caso |
seleção única |
$.Case.case_reason | Agente |
|
Cliente |
A API é um ID do perfil do cliente. Na página Casos: Campos, o nome do cliente é exibido. |
texto |
$.Case.customer_id | Amazon Connect |
|
Data/hora de encerramento |
A data e a hora em que o chamado foi encerrado pela última vez. Isso não garante que um chamado seja encerrado. Se um caso for reaberto, esse campo conterá o date/time carimbo da última vez em que o status foi alterado para fechado. |
date-time |
$.Case.last_closed_datetime | Amazon Connect |
|
Data/hora de abertura |
A data e a hora em que o chamado foi aberto. |
date-time |
$.Case.created_datetime | Amazon Connect |
|
Data/hora de atualização |
A data e a hora em que o chamado foi atualizado pela última vez. |
date-time |
$.Case.last_updated_datetime | Amazon Connect |
|
Número de referência |
Um número amigável para o caso em formato numérico de oito dígitos. Não é garantido que os números de referência (ao contrário do ID do caso) sejam exclusivos. Recomendamos que você identifique o cliente e, em seguida, colete o número de referência para encontrar corretamente o chamado certo. |
texto |
$.Case.reference_number | Agente |
|
Status |
Status atual do chamado |
texto |
$.Case.status | Agente |
|
Resumo |
Resumo do chamado |
texto |
$.Case.summary | Agente |
|
Título |
Título do chamado |
texto |
$.Case.title | Agente |
Atributos de contato do Lambda
Os atributos do Lambda são exibidos como pares de chave-valor da invocação mais recente de um bloco Função AWS Lambda . Atributos de invocação do Lambda são substituídos a cada invocação da função do Lambda.
Para referenciar atributos em JSONPath, use:
-
$.LambdaInvocation.ResultData.attributeName
onde AttributeName é o nome do atributo ou a chave do par de valor-chave retornado da função.
Por exemplo, se a função retorna um ID de contato, faça referência ao atributo com $.LambdaInvocation.ResultData.ContactId. Ao fazer referência a uma ID de contato retornada pelo Amazon Connect, JSONPath é$.ContactId.
Para obter mais informações sobre como usar atributos em funções do Lambda, consulte Conceder ao Amazon Connect acesso às funções do AWS Lambda.
Esses atributos não são incluídos em registros de contato, não são passados para a próxima invocação do Lambda e nem para o CCP para fornecer informações de tela pop-up. No entanto, eles podem ser transmitidos como entradas de função do Lambda em um bloco Função AWS Lambda ou copiados para atributos definidos pelo usuário pelo bloco Set contact attributes (Definir atributos do contato). Quando usado em blocos Set contact attributes (Definir atributos do contato), os atributos que são copiados são incluídos em registros de contato e podem ser usados no CCP.
Atributos definidos pelo usuário
Para todos os outros atributos, o Amazon Connect define a chave e o valor. No entanto, para atributos definidos pelo usuário, você fornece um nome para a chave e o valor.
Use atributos definidos pelo usuário em situações em que você deseja armazenar valores em um fluxo de contato e consulte esses valores posteriormente. Por exemplo, se você integrar o Amazon Connect a um CRM ou outro sistema, talvez queira receber informações do cliente, como o número de membro. Em seguida, você pode usar esse número de membro para recuperar informações sobre o membro do CRM, and/or usar o número do membro em todo o fluxo, etc.
Atributo |
Description |
Tipo |
JSONPath Referência |
|---|---|---|---|
Qualquer nome que você escolher |
Um atributo definido pelo usuário tem duas partes:
|
Definido pelo usuário |
$.Attributes.nome_da_sua_chave_destino |
Para criar atributos definidos pelo usuário, use o bloco Set contact attributes (Definir atributos do contato).
Atributos de fluxo
Os atributos de fluxo são como um atributo de tipo definido pelo usuário, mas estão restritos ao fluxo em que estão definidos.
Eles são úteis em situações nas quais você não deseja manter os dados durante todo o contato, como quando precisa usar informações confidenciais, como o número do cartão de crédito do cliente, para fazer uma análise de dados do Lambda.
-
Os atributos de fluxo são variáveis temporárias armazenadas localmente e usadas somente no fluxo. Eles não são visíveis em nenhum lugar fora do fluxo, nem mesmo quando o contato é transferido para outro fluxo.
Eles podem ter até 32 KB (o tamanho máximo da seção de atributos do registro de contato).
-
Eles não são passados para um Lambda, a menos que estejam explicitamente configurados como parâmetros: no bloco Invocar função do AWS Lambda, escolha Adicionar um parâmetro.
-
Eles não são passados para os módulos. Você pode definir um atributo de fluxo dentro de um módulo, mas ele não será passado para fora do módulo.
-
Eles não aparecem no registro do contato.
-
Eles não aparecem para o atendente do CCP.
-
A API
GetContactAttributesnão pode expor esses atributos. -
Se você tiver o registro habilitado no fluxo, a chave e o valor aparecerão no log do Cloudwatch.
Atributo |
Description |
Tipo |
JSONPath Referência |
|---|---|---|---|
Qualquer nome que você escolher |
Um atributo de fluxo tem duas partes:
|
Fluxo |
$. FlowAttributes. nome_da_sua_chave_destino |
Atributos dos módulos de fluxo
Os atributos de entrada do módulo de fluxo são atributos passados para um módulo que definiu o esquema de entrada de um fluxo ou outro módulo usando o bloco Invoke Module. Os atributos de saída e resultado dos módulos de fluxo são retornados da invocação mais recente de um bloco do Invoke Module. Os atributos Saída e Resultado do Módulo são sobrescritos com cada invocação da função do Módulo.
Esses atributos não são incluídos nos registros de contato, não são passados para a próxima invocação do módulo e não são passados ao CCP para obter informações de screenpop. No entanto, eles podem ser copiados para atributos definidos pelo usuário usando o bloco Definir atributos de contato. Quando usados no bloco Definir atributos de contato, os atributos que são copiados são incluídos nos registros de contato e podem ser usados no CCP.
A tabela a seguir lista os atributos dos módulos de fluxo disponíveis no Amazon Connect.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Input |
Os dados de entrada fornecem acesso à entrada passada para o módulo. Isso é retornado como um objeto JSON e o formato específico é definido pelo esquema de entrada do módulo. |
Módulos |
$.Módulos.Entrada |
Resultado |
Os dados do resultado capturam o nome da ramificação retornado do módulo, excluindo a ramificação de erro. Isso é retornado como uma string. |
Módulos |
$.Módulos.Resultado |
Saída (referência de atributo da interface do usuário) |
Os dados de saída capturam os dados resultantes da execução do módulo. Isso é retornado como um objeto JSON e o formato específico é definido pelo esquema de saída do módulo. |
Módulos |
$.Módulos. ResultData |
Atributos da tabela de dados
Atributos retornados pelas operações do bloco Data Table. Use-os para acessar dados recuperados de tabelas de dados em seus fluxos de contato.
Avalie os atributos dos valores da tabela de dados
Atributos retornados ao usar a ação Avaliar em um bloco de tabela de dados para consultar valores de atributos específicos.
-
Se a consulta não retornar nenhum resultado ou o atributo não for encontrado, a referência ficará vazia ou nula.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
Resultado da consulta avaliada pela tabela de dados |
O valor de um atributo específico recuperado por uma consulta nomeada. |
Tabela de dados |
$.DataTables.<QueryName>.<AttributeName> |
Atributos de valores da tabela de dados da lista
Atributos retornados ao usar a ação Listar em um bloco de tabela de dados para recuperar registros completos.
-
A lista retorna registros completos (todos os atributos), não apenas os selecionados.
-
Se nenhum registro correspondente for encontrado, a primaryKeyGroups matriz ficará vazia.
-
Quando nenhum grupo de chave primária está configurado, a tabela inteira é carregada e os resultados podem ser acessados sob um nome de grupo “padrão”:
$.DataTableList.Result.primaryKeyGroups.default[index]. -
O namespace List tem um limite máximo de dados de 32 KB.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
ID da tabela de dados |
O identificador exclusivo da tabela de dados da qual os registros foram recuperados. |
Lista de tabelas de dados |
$. DataTableList.Resultado. dataTableId |
Versão de bloqueio |
As informações da versão do bloqueio para a tabela de dados. |
Lista de tabelas de dados |
$. DataTableList.result.lockversion.Tabela de dados |
Nome padrão do grupo |
Quando nenhum grupo de chave primária é configurado, a tabela inteira é carregada e os resultados são acessíveis com um nome de grupo “padrão”. |
Lista de tabelas de dados |
$. DataTableList.Resultado. primaryKeyGroups.default [índice] |
Grupos de chaves primárias |
A coleção de registros recuperados organizados pelo nome do grupo de valores primário. |
Lista de tabelas de dados |
$. DataTableList.Resultado. primaryKeyGroups. < GroupName > |
Linha específica |
Acesse uma linha específica dentro de um grupo de chaves primárias. |
Lista de tabelas de dados |
$. DataTableList.Resultado. primaryKeyGroups. < GroupName > [índice] |
Valor da chave primária |
Acesse o valor de um atributo de chave primária em uma linha específica. |
Lista de tabelas de dados |
$. DataTableList.Resultado. primaryKeyGroups. < GroupName > [índice] .primaryKeys [índice] .attributeValue |
Valor de atributo |
Acesse o valor de um atributo não primário em uma linha específica. |
Lista de tabelas de dados |
$. DataTableList.Resultado. primaryKeyGroups. < GroupName > [índice] .attributes [índice] .AttributeValue |
Atributos do Apple Messages for Business
Use os seguintes atributos de contato para rotear os clientes do Apple Messages for Business. Por exemplo, se você tiver linhas de negócios diferentes usando o Apple Messages for Business, poderá ramificar para fluxos diferentes com base no atributo de AppleBusinessChatGroup contato. Ou, se você quiser rotear as mensagens do Apple Messages for Business de forma diferente de outras mensagens de bate-papo, você pode ramificar com base em MessagingPlatform.
| Atributo | Description | Tipo | JSON |
|---|---|---|---|
|
MessagingPlatform |
A plataforma de mensagens de onde a solicitação do cliente se originou. Valor exato: AppleBusinessChat |
Definido pelo usuário | $.Atributos. MessagingPlatform |
|
AppleBusinessChatCustomerId |
O ID opaco do cliente fornecido pela Apple. Isso permanece constante para o ID da Apple e para uma empresa. Você pode usar isso para identificar se a mensagem é de um novo cliente ou de um cliente antigo. |
Definido pelo usuário | $.Atributos. AppleBusinessChatCustomerId |
|
AppleBusinessChatIntent |
Você pode definir a intenção ou finalidade do chat. Esse parâmetro é incluído em um URL que inicia uma sessão de chat no Messages quando um cliente escolhe o botão Business Chat. |
Definido pelo usuário | $.Atributos. AppleBusinessChatIntent |
|
AppleBusinessChatGroup |
Você define o grupo que designa o departamento ou as pessoas mais qualificadas para lidar com a pergunta ou problema específico do cliente. Esse parâmetro é incluído em um URL que inicia uma sessão de chat no Messages quando um cliente escolhe o botão Business Chat. |
Definido pelo usuário | $.Atributos. AppleBusinessChatGroup |
|
AppleBusinessChatLocale |
Define as preferências de idioma e AWS região que o usuário deseja ver na interface do usuário. Consiste em um identificador de idioma (ISO 639-1) e um identificador de região (ISO 3166). Por exemplo, en_US. |
Definido pelo usuário | $.Atributos. AppleBusinessChatLocale |
|
AppleFormCapability |
Se o dispositivo do cliente é compatível com formulários. Se for verdadeiro, o dispositivo do cliente é compatível. Se for falso, o dispositivo não é compatível. |
Definido pelo usuário | $.Atributos. AppleFormCapability |
|
AppleAuthenticationCapability |
Se o dispositivo do cliente é compatível com Autenticação (OAuth2). Se for verdadeiro, o dispositivo do cliente é compatível. Se for falso, o dispositivo do cliente não é compatível. |
Definido pelo usuário | $.Atributos. AppleAuthenticationCapability |
|
AppleTimePickerCapability |
Se o dispositivo do cliente é compatível com seletores de horário. Se for verdadeiro, o dispositivo do cliente é compatível. Se for falso, o dispositivo não é compatível. |
Definido pelo usuário | $.Atributos. AppleTimePickerCapability |
|
AppleListPickerCapability |
Se o dispositivo do cliente é compatível com seletores de lista. Se for verdadeiro, o dispositivo do cliente é compatível. Se for falso, o dispositivo não é compatível. |
Definido pelo usuário | $.Atributos. AppleListPickerCapability |
|
AppleQuickReplyCapability |
Se o dispositivo do cliente oferece suporte a respostas rápidas. Se for verdadeiro, o dispositivo do cliente é compatível. Se for falso, o dispositivo não é compatível. |
Definido pelo usuário | $.Atributos. AppleQuickReplyCapability |
Atributos do Customer Profiles
A tabela a seguir lista os atributos que são usados com o Amazon Connect Customer Profiles.
O tamanho total dos atributos de contato do Customer Profiles é limitado a 14.000 (56 atributos pressupondo o tamanho máximo de 255 cada) caracteres para todo o fluxo. Isso inclui todos os valores mantidos como campos Resposta em blocos do Customer Profiles durante o fluxo.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
|
profileSearchKey |
O nome do atributo que você deseja usar para pesquisar um perfil. |
Definido pelo usuário |
Não aplicável |
|
profileSearchValue |
O valor da chave que você deseja pesquisar, como nome do cliente ou número da conta. |
Definido pelo usuário |
Não aplicável |
|
ID do perfil |
O identificador exclusivo de um perfil do cliente. |
texto |
$.Cliente. ProfileId |
|
ARN do perfil |
O ARN de um perfil de cliente. |
texto |
$.Customer.ProfileARN |
|
Nome |
O nome do cliente. |
texto |
$.Cliente. FirstName |
|
Nome do meio |
O nome do meio do cliente. |
texto |
$.Cliente. MiddleName |
|
Sobrenome |
O sobrenome do cliente. |
texto |
$.Cliente. LastName |
|
Número da conta |
Um número de conta exclusivo que você forneceu ao cliente. |
texto |
$.Cliente. AccountNumber |
|
Endereço de e-mail |
O endereço de e-mail do cliente, que não foi especificado como endereço pessoal ou comercial. |
texto |
$.Cliente. EmailAddress |
|
Número de telefone |
O número de telefone do cliente, que não foi especificado como número de celular, residencial ou comercial. |
texto |
$.Cliente. PhoneNumber |
|
Informações adicionais |
Qualquer informação adicional relevante para o perfil do cliente. |
texto |
$.Cliente. AdditionalInformation |
|
Tipo de parte |
O tipo de parte do cliente. |
texto |
$.Cliente. PartyType |
|
Nome da empresa |
O nome da empresa do cliente. |
texto |
$.Cliente. BusinessName |
|
Data de nascimento |
A data de nascimento do cliente. |
texto |
$.Cliente. BirthDate |
|
Gender |
O gênero do cliente. |
texto |
$.Customer.Gender |
|
Número de telefone celular |
O número de telefone celular do cliente. |
texto |
$.Cliente. MobilePhoneNumber |
|
Número de telefone residencial |
O número de telefone residencial do cliente. |
texto |
$.Cliente. HomePhoneNumber |
|
Número de telefone comercial |
O número de telefone comercial do cliente. |
texto |
$.Cliente. BusinessPhoneNumber |
|
Endereço de e-mail comercial |
O endereço de e-mail comercial do cliente. |
texto |
$.Cliente. BusinessEmailAddress |
|
Endereço |
Um endereço genérico associado ao cliente que não é para correspondência, envio ou cobrança. |
texto |
$.Customer.Address1 $.Customer.Address2 $.Customer.Address3 $.Customer.Address4 $.Customer.City $.Customer.County $.Customer.Country $.Cliente. PostalCode $.Customer.Province $.Customer.State |
|
Endereço de envio |
O endereço de entrega do cliente. |
texto |
$.Cliente. ShippingAddress1 $.Cliente. ShippingAddress2 $.Cliente. ShippingAddress3 $.Cliente. ShippingAddress4 $.Cliente. ShippingCity $.Cliente. ShippingCounty $.Cliente. ShippingCountry $.Cliente. ShippingPostalCode $.Cliente. ShippingProvince $.Cliente. ShippingState |
|
Endereço de correspondência |
O endereço de correspondência do cliente. |
texto |
$.Cliente. MailingAddress1 $.Cliente. MailingAddress2 $.Cliente. MailingAddress3 $.Cliente. MailingAddress4 $.Cliente. MailingCity $.Cliente. MailingCounty $.Cliente. MailingCountry $.Cliente. MailingPostalCode $.Cliente. MailingProvince $.Cliente. MailingState |
|
Endereço de faturamento |
O endereço de faturamento do cliente. |
texto |
$.Cliente. BillingAddress1 $.Cliente. BillingAddress2 $.Cliente. BillingAddress3 $.Cliente. BillingAddress4 $.Cliente. BillingCity $.Cliente. BillingCounty $.Cliente. BillingCountry $.Cliente. BillingPostalCode $.Cliente. BillingProvince $.Cliente. BillingState |
|
Atributos |
Um par de atributos chave/valor de um perfil do cliente. |
texto |
$.Customer.Attributes.x |
|
Atributos do objeto |
Um par de atributos de objeto personalizado chave/valor de um perfil do cliente. |
texto |
$.Cliente. ObjectAttributes. y |
|
Atributos calculados |
Um par de atributos chave/valor calculados de um perfil do cliente. |
texto |
$.Cliente. CalculatedAttributesz. |
|
Ativo |
Um ativo padrão do cliente. |
texto |
$.Cliente.Ativo. AssetId $.Cliente.Ativo. ProfileId $.Cliente.Ativo. AssetName $.Cliente.Ativo. SerialNumber $.Cliente.Ativo. ModelNumber $.Cliente.Ativo. ModelName $.Customer.Asset.ProductSKU $.Cliente.Ativo. PurchaseDate $.Cliente.Ativo. UsageEndDate $.Customer.Asset.Status $.Customer.Asset.Price $.Customer.Asset.Quantity $.Customer.Asset.Description $.Cliente.Ativo. AdditionalInformation $.Cliente.Ativo. DataSource $.Customer.Asset.Attributes.x |
|
Ordem |
Um pedido padrão do cliente. |
texto |
$.Cliente.Pedido. OrderId $.Cliente.Pedido. ProfileId $.Cliente.Pedido. CustomerEmail $.Cliente.Pedido. CustomerPhone $.Cliente.Pedido. CreatedDate $.Cliente.Pedido. UpdatedDate $.Cliente.Pedido. ProcessedDate $.Cliente.Pedido. ClosedDate $.Cliente.Pedido. CancelledDate $.Cliente.Pedido. CancelReason $.Customer.Order.Name $.Cliente.Pedido. AdditionalInformation $.Customer.Order.Gateway $.Customer.Order.Status $.Cliente.Pedido. StatusCode $.Cliente.Pedido. StatusUrl $.Cliente.Pedido. CreditCardNumber $.Cliente.Pedido. CreditCardCompany $.Cliente.Pedido. FulfillmentStatus $.Cliente.Pedido. TotalPrice $.Cliente.Pedido. TotalTax $.Cliente.Pedido. TotalDiscounts $.Cliente.Pedido. TotalItemsPrice $.Cliente.Pedido. TotalShippingPrice $.Cliente.Pedido. TotalTipReceived $.Customer.Order.Currency $.Cliente.Pedido. TotalWeight $.Cliente.Pedido. BillingName $.Cliente.Pedido. BillingAddress1 $.Cliente.Pedido. BillingAddress2 $.Cliente.Pedido. BillingAddress3 $.Cliente.Pedido. BillingAddress4 $.Cliente.Pedido. BillingCity $.Cliente.Pedido. BillingCounty $.Cliente.Pedido. BillingCountry $.Cliente.Pedido. BillingPostalCode $.Cliente.Pedido. BillingProvince $.Cliente.Pedido. BillingState $.Cliente.Pedido. ShippingName $.Cliente.Pedido. ShippingAddress1 $.Cliente.Pedido. ShippingAddress2 $.Cliente.Pedido. ShippingAddress3 $.Cliente.Pedido. ShippingAddress4 $.Cliente.Pedido. ShippingCity $.Cliente.Pedido. ShippingCounty $.Cliente.Pedido. ShippingCountry $.Cliente.Pedido. ShippingPostalCode $.Cliente.Pedido. ShippingProvince $.Cliente.Pedido. ShippingState $.Customer.Order.Attributes.y |
|
Caso |
Um caso padrão do cliente. |
texto |
$.Cliente.Case. CaseId $.Cliente.Case. ProfileId $.Customer.Case.Title $.Customer.Case.Summary $.Customer.Case.Status $.Customer.Case.Reason $.Cliente.Case. CreatedBy $.Cliente.Case. CreatedDate $.Cliente.Case. UpdatedDate $.Cliente.Case. ClosedDate $.Cliente.Case. AdditionalInformation $.Cliente.Case. DataSource $.Customer.Case.Attributes.z |
Atributos da campanha de saída
Você pode usar dados na lista de Amazon Pinpoint
segmentos para personalizar experiências em Amazon Connect fluxos. Para referenciar dados em uma lista de segmentos, use $.Attributes. attribute coming in the
segment. Por exemplo, se você tiver um segmento com duas colunas “Atributos”. FirstName” e “Atributos”. ItemDescription, você se referiria a eles como:
-
$.Atributos. FirstName
-
$.Atributos. ItemDescription
Para acessar mais informações, consulte Adicionar conteúdo personalizado a modelos de mensagem no Guia do usuário do Amazon Pinpoint.
Atributo do Amazon Q no Connect
O atributo a seguir armazena o ARN da sessão do Amazon Q no Connect. Um caso de uso desse atributo é quando você deseja realizar qualquer ação de API, como UpdateSessionUpdateSessionData. Você pode transmitir o atributo como entrada para o bloco Função AWS Lambda . E o Lambda pode chamá-los com base no APIs ARN da sessão de entrada.
| Atributo | Description | Tipo | JSONPath Referência |
|---|---|---|---|
|
SessionArn |
O nome do recurso da Amazon (ARN) de uma sessão do Amazon Q no Connect. |
Fluxo |
$.Sabedoria. SessionArn |