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á.
Bloco de fluxo no Amazon Connect: defina atributos de contato
Este tópico define o bloco de fluxo para armazenar pares de valores-chave como atributos de contato e, em seguida, definir um valor que será posteriormente referenciado em um fluxo.
Descrição
Armazena pares de chave/valor como atributos de contato. Você define um valor que é posteriormente referenciado em um fluxo.
Por exemplo, crie uma saudação personalizada para os clientes roteados para uma fila com base no tipo de conta do cliente. Você também pode definir um atributo para um nome de empresa ou linha de negócios para incluir nas strings de texto convertido em fala que são faladas para o cliente.
O bloco Definir atributos do contato é útil, por exemplo, para copiar atributos recuperados de fontes externas para atributos definidos pelo usuário.
Para obter mais informações sobre os atributos de contato, consulte Usar os atributos de contato do Amazon Connect.
Canais compatíveis
A tabela a seguir lista como esse bloco direciona um contato que está usando o canal especificado.
| Channel (Canal) | Compatível? |
|---|---|
Voz |
Sim |
Bate-papo |
Sim |
Tarefa |
Sim |
Tipos de fluxo
É possível usar esse bloco nos seguintes tipos de fluxo:
-
Todos os fluxos
Propriedades
A imagem a seguir mostra a página Propriedades do bloco Definir atributos do contato. Ele é configurado para definir um atributo definido pelo usuário no contato atual com a chave greetingPlayede o valor verdadeiro.
Você pode optar por definir atributos em:
-
Contato atual: os atributos são definidos no contato em que esse fluxo está sendo executado. Os atributos podem ser acessados por outras áreas do Amazon Connect, como outros fluxos, módulos, Lambdas, registros de contato e a GetMetricData API V2.
-
Contato relacionado: os atributos estão associados a um novo contato que contém uma cópia das propriedades do contato original.
No registro de contato, esse é RelatedContactIdo.
-
Fluxo: os atributos de fluxo são restritos ao fluxo no qual estão configurados.
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 agente noCCP.
-
Eles não
GetContactAttributesAPI podem expô-los. -
Se você tiver o registro habilitado no fluxo, a chave e o valor aparecerão no log do Cloudwatch.
-
Como referenciar atributos
-
Para obter a JSON sintaxe de cada atributo, consulteLista de atributos de contato disponíveis no Amazon Connect e suas JSONPath referências.
-
Para referenciar atributos que contêm caracteres especiais nos nomes, como espaços, colchetes e aspas simples ao redor do nome do atributo. Por exemplo:
$.Attributes.['user attribute name']. -
Para fazer referência a atributos no mesmo namespace, como um atributo de sistema, você usa o nome do atributo ou o nome que você especificou como Destination key (Chave de destino).
-
Para referenciar valores em um namespace diferente, como fazer referência a um atributo externo, você especifica a JSONPath sintaxe do atributo.
-
Para usar atributos de contato para acessar outros recursos, defina um atributo definido pelo usuário em seu fluxo e use o Amazon Resource Name (ARN) do recurso que você deseja acessar como o valor do atributo.
Exemplos do Lambda
-
Para referenciar o nome de um cliente a partir de uma pesquisa de função Lambda, use $.External. AttributeKey, AttributeKey substituindo pela chave (ou nome) do atributo retornado da função Lambda.
-
Para usar um prompt do Amazon Connect em uma função Lambda, defina um atributo definido pelo usuário ARN para o prompt e, em seguida, acesse esse atributo a partir da função Lambda.
Exemplos do Amazon Lex
-
Para referenciar um atributo de um bot do Amazon Lex, você usa o formato $.Lex. e depois inclui a parte do bot do Amazon Lex para referência, como $.Lex. IntentName.
-
Para referenciar a opinião do cliente sobre um slot de bot Amazon Lex, use $.Lex.Slots. slotName, slotNamesubstituindo pelo nome do slot no bot.
O que acontece quando os atributos excedem 32 KB
Os atributos podem ter até 32 KB, que é o tamanho máximo da seção de atributos do registro de contato. Quando os atributos de um contato excedem 32 KB, o contato é roteado pela ramificação Error. Como mitigação, considere as seguintes opções:
-
Remova atributos desnecessários definindo seus valores como vazios.
-
Se os atributos forem usados somente em um fluxo e não precisarem ser referenciados fora desse fluxo (por exemplo, por um Lambda ou outro fluxo), use atributos de fluxo. Dessa forma, você não está persistindo desnecessariamente os 32 KB de informações de um fluxo para outro.
Dicas de configuração
-
Ao usar uma chave de destino definida pelo usuário, você pode nomeá-la como quiser, mas não inclua os caracteres $ e . (ponto final). Eles não são permitidos porque ambos são usados na definição dos caminhos de atributos emJSONPath.
-
Você pode usar o bloco Definir atributo de contato para definir o atributo de idioma necessário para um bot do Amazon Lex V2. (O atributo de idioma no Amazon Connect deve corresponder ao modelo de idioma usado para criar o bot do Amazon Lex V2.) A imagem a seguir mostra um atributo de idioma definido como espanhol.
Ou, você pode usar o bloco Set voice (Definir voz) para definir o atributo de idioma necessário para um bot do Amazon Lex V2.
Para obter mais informações sobre como usar os atributos de contato, consulte Usar os atributos de contato do Amazon Connect.
Bloco configurado
A imagem a seguir mostra um exemplo da aparência deste bloco quando configurado. Tem dois ramos: Êxito e Erro.
Fluxos de exemplo
O Amazon Connect inclui um conjunto de fluxos de amostra. Para obter instruções que explicam como acessar os fluxos de amostra no editor do fluxo, consulte Fluxos de amostra no Amazon Connect. A seguir estão os tópicos que descrevem os fluxos de amostra que incluem esse bloco.
Cenários
Consulte estes tópicos para ver cenários que usam este bloco:
