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á.
# Usar o Amazon Connect Customer Profiles
Para ajudar os agentes a oferecer um atendimento ao cliente mais eficiente e personalizado, o Amazon Connect permite combinar informações de aplicativos externos, como Salesforce, Zendesk ou outros produtos de gerenciamento de relacionamento com o cliente (CRM), com o histórico de contatos do. ServiceNow Amazon Connect Isso cria um perfil de cliente com todas as informações de que os atendentes precisam durante as interações com o cliente em um único lugar.
Com uma visão única das informações do cliente, inclusive produto, caso e histórico de contatos, os atendentes podem confirmar rapidamente a identidade do cliente e determinar o motivo da chamada ou do chat.
No momento, o Amazon Connect Customer Profiles pode ser usado em conformidade com o [RGPD](https://aws.amazon.com/compliance/gdpr-center) e depende de certificações adicionais mantidas pelo Amazon Connect.
A imagem a seguir mostra o espaço de trabalho do atendente; para a finalidade desta documentação, uma imagem do Amazon Connect Customer Profiles é exibida. O espaço de trabalho do atendente foi projetado para oferecer eficiência na execução de várias tarefas ao mesmo tempo, permitindo o tratamento simultâneo de chamadas, chats e tarefas, além de fornecer acesso rápido às informações do perfil do cliente, tudo na mesma janela do navegador.
![\[A guia do perfil do cliente na aplicação do atendente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-concepts-intro3.png)
1. **Casos**: status, ID de referência, título, fonte, data de atualização e mais informações relacionadas aos casos ingeridos do aplicativo 3P, como o Zendesk ServiceNow, e, além dos casos criados e gerenciados usando Casos. Amazon Connect
1. **Mais informações**: informações adicionais contidas no campo *Atributos* do [perfil](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html) definido pelo cliente, bem como outras informações do perfil, como número de celular e endereço de entrega. Essas informações serão classificadas em ordem alfabética para ajudar o atendente a localizar rapidamente as informações necessárias.
1. **Histórico de contatos**: data, horários e duração referentes a contatos de clientes com a central de atendimento no passado.
1. **Histórico de compras de produtos**: todos os ativos adquiridos por um cliente podem ser preenchidos aqui. Os dados são ingeridos de uma aplicação externa, como Salesforce ou Zendesk, que você [integrou](integrate-external-apps-customer-profiles.md) ao Customer Profiles.
# O que é um perfil de cliente no Amazon Connect?
Um *perfil de cliente* é um registro que armazena o histórico de contatos combinado com informações sobre os clientes, como número da conta, informações adicionais, data de nascimento, e-mail, vários endereços, nome e tipo de parte. Espera-se que um *perfil baseado em conta* tenha subperfis subjacentes.
Depois que você ativar o Amazon Connect Customer Profiles, um perfil de cliente exclusivo será criado para cada contato. Isso permite criar um perfil de cliente que tem todas as informações de que os atendentes precisam durante as interações com o cliente em um único lugar sem custo.
Para acessar perfis de clientes nos fluxos, use o bloco [Customer Profiles](customer-profiles-block.md). [Os atendentes acessam os perfis de clientes](customer-profile-access.md) no espaço de trabalho do atendente.
Você pode usar os recursos pagos do Customer Profiles para enriquecer os perfis de clientes ao [ingerir dados de aplicações externas](integrate-external-apps-customer-profiles.md). Consulte [Preços](https://aws.amazon.com/connect/pricing/) para obter detalhes.
Você também pode adicionar campos e objetos personalizados aos perfis dos clientes usando os perfis de [clientes do Amazon Connect APIs](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## Como os dados do perfil do cliente são armazenados?
O Amazon Connect armazena o histórico de contatos em perfis de clientes exclusivos. Ele analisa os dados ingeridos de aplicações externas e os armazena como atributos do perfil do cliente.
O Amazon Connect não substitui nem atualiza os dados na aplicação externa. Se uma fonte de dados for removida, os dados da aplicação externa não estarão mais disponíveis no perfil do cliente para cada contato de voz.
Para obter informações sobre como os dados do perfil do cliente são protegidos, consulte [Proteção de dados no Amazon Connect](data-protection.md).
Para obter mais informações sobre como acessar os dados armazenados em um perfil do cliente, consulte [Acessar Customer Profiles no espaço de trabalho do atendente](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profile-access.html) ou [Usar a API do Customer Profiles](https://docs.aws.amazon.com/connect/latest/adminguide/use-customerprofiles-api.html).
# Habilitar o Customer Profiles para a instância do Amazon Connect
O Amazon Connect fornece integrações predefinidas para que você possa combinar rapidamente as informações do cliente de várias aplicações externas com o histórico de contatos do Amazon Connect. Isso permite criar um perfil de cliente que tem todas as informações de que os atendentes precisam durante as interações com o cliente em um único lugar.
## Antes de começar
Confira a seguir uma visão geral dos principais conceitos e das informações que serão solicitadas durante o processo de configuração.
### Sobre o domínio de perfis de clientes
Ao habilitar o Amazon Connect Customer Profiles, você cria um domínio de perfis de clientes: um contêiner para todos os dados, como perfis de clientes, tipos de objetos, chaves de perfil e chaves de criptografia. Veja abaixo as diretrizes para criar domínios do Customer Profiles:
+ Cada instância do Amazon Connect só pode ser associada a um domínio.
+ Você pode criar vários domínios, mas eles não compartilham integrações de aplicações externas ou dados de clientes entre si.
+ Todas as integrações de aplicações externas que você cria estão no nível do domínio. Todas as instâncias do Amazon Connect associadas a um domínio herdam as integrações do domínio.
+ Você pode alterar a associação da instância do Amazon Connect do domínio atual para um novo domínio a qualquer momento, escolhendo um domínio diferente. No entanto, isso não é recomendado porque os perfis de clientes do domínio anterior não serão movidos para o novo domínio.
### Datastore
O armazenamento de dados é um armazenamento de dados de longo prazo de dados de perfis de clientes. Ele armazena dados de perfis de clientes que foram atualizados nos últimos 10 anos. São os dados usados para segmentação com tecnologia Spark SQL e insights preditivos e devem estar habilitados para usar esses recursos. Ele não é usado no cálculo de atributos calculados ou no preenchimento do Espaço de Trabalho do Agente.
### Como você deseja nomear seu domínio de perfis de clientes?
Ao habilitar perfis de clientes, você é solicitado a fornecer um nome de domínio amigável que seja significativo para você, como o nome da sua organização, por exemplo, *CustomerProfiles- ExampleCorp*. É possível alterar o nome amigável usando a API a qualquer momento.
### Datastore
O armazenamento de dados é um armazenamento de dados gerenciado por serviços, necessário para segmentação com tecnologia Spark SQL e insights preditivos, e deve estar habilitado para usar esses recursos. Ele não é usado no cálculo de atributos calculados ou no preenchimento do Espaço de Trabalho do Agente.
Depois de ativar o armazenamento de dados, ele armazena automaticamente sua ingestão nos Perfis de Cliente. Depois de ativar o armazenamento de dados, você não poderá desativar esse recurso. Para excluir dados do Data Store, você pode usar a DeleteProfile API ou excluir os tipos de objetos ou o domínio do Perfil do Cliente.
### Você quer usar uma fila de mensagens não entregues?
Uma fila de mensagens não entregues é usada para relatar erros associados ao processamento de dados de aplicações externas.
A Amazon AppFlow gerencia a conexão com o aplicativo externo e a transferência de dados dele para os perfis de clientes do Amazon Connect. Em seguida, o Amazon Connect processa o arquivo.
+ Se ocorrer um erro durante a conexão ou durante o transporte dos dados para o Amazon Connect, a Amazon AppFlow detecta o erro, mas não grava o erro na fila de mensagens mortas.
Por exemplo, um erro de processamento pode ser que os dados externos não correspondem ao esquema especificado ou que o formato dos dados externos não está correto (atualmente, somente o JSON é suportado).
+ Se o Amazon Connect encontrar um erro ao processar o arquivo, ele gravará o erro na sua fila de mensagens não entregues. Você poderá examinar a fila mais tarde e tentar reprocessar o erro.
+ Pode haver mensagens SQS na fila de mensagens não entregues definida com seu domínio que incluem a mensagem de erro junto com o objeto.
| **Mensagem de erro** | **Recomendação** |
| --- | --- |
| A chave UNIQUE ou a chave PROFILE não existe no objeto de perfil | Modifique o mapeamento de dados ou o objeto, verifique se as chaves marcadas como UNIQUE e PROFILE no mapeamento de dados existem no objeto. Veja na [**página de mapeamento de dados**](customer-profiles-object-type-mapping.md) instruções sobre como configurá-lo. |
| Muitos objetos ingeridos no perfil por segundo | Muitos objetos atribuídos ao mesmo perfil em pouco tempo. Você pode reingerir o objeto ou adicionar o tempo de espera entre as chamadas da PutProfileObject API. |
| Os Perfis de Clientes não podem ingerir o objeto porque EncryptionKey ele não existe na região, EncryptionKey não tem permissão para uso dos Perfis de Cliente ou EncryptionKey não tem permissão GenerateDataKey | Verifique sua permissão do KMS e se o Customer Profiles tem o acesso necessário. Siga para a sessão [**Habilitar o Customer Profiles e especificar uma fila de mensagens não entregues e uma chave do KMS**](#enable-customer-profiles-step1). |
| A chave do KMS é inválida | Verifique sua permissão do KMS e se o Customer Profiles tem o acesso necessário. Siga para a sessão [**Habilitar o Customer Profiles e especificar uma fila de mensagens não entregues e uma chave do KMS**](#enable-customer-profiles-step1). |
| O Customer Profiles não ingere o objeto porque a chave do KMS é inválida | Verifique sua permissão do KMS e se o Customer Profiles tem o acesso necessário. Siga para a sessão [**Habilitar o Customer Profiles e especificar uma fila de mensagens não entregues e uma chave do KMS**](#enable-customer-profiles-step1). |
| Seus dados contêm objetos de perfil maiores que \$1 bytes | Remova todos os campos desnecessários e reduza o tamanho dos dados até que fiquem abaixo do limite especificado mencionado na mensagem de erro. |
| Todas as chaves desse objeto estão vinculadas a mais de um perfil | Modifique o mapeamento de dados ou o objeto, tenha pelo menos uma chave PROFILE vinculada a menos que ou igual a um perfil existente. |
Ao ativar o Customer Profiles, você tem a opção de especificar uma fila do Amazon SQS como fila de mensagens não entregues. Se você selecionar essa opção, adicione a seguinte política de recursos ao Amazon SQS para que o Customer Profiles tenha permissões para enviar mensagens para essa fila:
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
Para evitar um problema de segurança “confused deputy”, consulte [Prevenção do problema de substituto confuso entre serviços no Amazon Connect Customer Profiles](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service) para obter uma política de exemplo a ser aplicada.
Step-by-step instruções para criar uma fila de mensagens mortas são fornecidas posteriormente neste tópico, em. [Ativar o Customer Profiles e especificar uma fila de mensagens não entregues e uma chave KMS](#enable-customer-profiles-step1)
### Criar uma chave KMS para ser usada pelo Customer Profiles para criptografar dados (obrigatório)
**nota**
Para manter o acesso aos perfis de clientes APIs, as entidades que usam os perfis de clientes `profile` APIs devem ter `kms:GenerateDataKey` permissões `kms:Decrypt` explícitas em suas políticas de IAM. Isso permite que elas utilizem `kms:Decrypt` e `kms:GenerateDataKey` para a chave do KMS associada aos recursos recuperados da API relacionada ao Customer Profiles.
Quando você ativa os Perfis de cliente, você é solicitado a criar ou fornecer uma chave AWS Key Management Service [KMS.](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys) Step-by-stepas instruções para criar uma chave KMS são fornecidas posteriormente neste tópico, em[Ativar o Customer Profiles e especificar uma fila de mensagens não entregues e uma chave KMS](#enable-customer-profiles-step1).
Todos os dados em repouso do Customer Profiles são criptografados com a chave KMS escolhida por você. A chave gerenciada pelo cliente é criada e gerenciada por você e pertence a você. Você tem controle total sobre a chave KMS (AWS KMS taxas aplicáveis).
Se você optar por configurar uma chave KMS em que outra pessoa seja o administrador, a chave deverá ter uma política com permissões `kms:GenerateDataKey`, `kms:CreateGrant` e `kms:Decrypt` para a entidade principal de serviço do Customer Profiles. Para obter informações sobre como alterar uma política de chaves, consulte [Alterar uma política de chaves](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) no Guia do AWS Key Management Service desenvolvedor. Além disso, para evitar a falsificação de identidade entre serviços, consulte [Prevenção confusa de delegados entre serviços em AWS](cross-service-confused-deputy-prevention.md) para políticas de exemplo que você deve aplicar.
## Ativar o Customer Profiles e especificar uma fila de mensagens não entregues e uma chave KMS
**Armazenamento de dados**
Escolha se deseja ativar o armazenamento de dados. É necessário usar segmentação baseada em Spark SQL e insights preditivos. Se você optar por não ativar o armazenamento de dados ao criar um domínio, poderá ativá-lo depois que o domínio for criado e usado. Você não pode desativar o armazenamento de dados depois que ele foi ativado.
Você pode ativar o armazenamento de dados clicando no botão ativar no banner azul na página Perfis do cliente (painel esquerdo > **Perfis do cliente**). Você verá esse banner azul depois de criar seu domínio.
O armazenamento de dados requer uma chave gerenciada pelo cliente (CMK) e solicitará que você crie uma chave gerenciada pelo cliente (CMK), caso ainda não tenha habilitado uma para o seu domínio.
**Importante**
Ao usar o Data Vault, o Customer Profiles armazena seus dados por tipo de objeto e os criptografa usando sua chave AWS KMS. O Customer Profiles normaliza seus nomes de tipos de objetos da seguinte forma:
Convertendo o nome em minúsculas
Convertendo hífens - em sublinhados \$1
Anexar “padrão” a qualquer tipo de objeto padrão do Customer Profiles
Anexar “domínio” a qualquer tipo de objeto de domínio do Customer Profiles
Anexar “domain\$1standard” a qualquer tipo de objeto de domínio padrão do Customer Profiles
Você não pode ativar o Armazenamento de dados se o Customer Profiles detectar conflitos de nomenclatura. Depois de habilitar o Data Store, você não poderá criar tipos de objetos que entrem em conflito com os nomes de tipos de objetos existentes de acordo com essas regras de normalização.
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)
1. No painel de navegação, escolha **Perfis de clientes**.
A página **Domínio de perfis de clientes** lista as aplicações que estão disponíveis para integração. Na imagem a seguir, a página mostra que nenhum domínio do perfil do cliente foi ativado.
![\[A página de perfil do cliente, o botão Habilitar Customer Profiles.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-domains-page.png)
1. Escolha **Habilitar Customer Profiles** para começar.
1. Na página **Perfis de clientes habilitados**, escolha **Criar novo domínio**. Em **Especificar um domínio**, insira um nome amigável que seja significativo para você, como o nome da sua organização, por exemplo, *CustomerProfiles- ExampleCorp*.
![\[A página Perfis de clientes habilitados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-domain.png)
1. Em **Especificar fila não endereçada**, escolha se deseja enviar eventos com falha para uma fila de mensagens não entregues. Isso será útil se você quiser ter visibilidade dos dados que não foram ingeridos. Isso também oferece a opção de repetir essas ingestões de dados com falha no futuro.
Veja abaixo as etapas para criar uma fila de mensagens não entregues:
+ Na página **Perfis de clientes habilitados**, escolha **Criar nova fila do SQS ou selecionar uma existente** e **Criar uma nova fila não endereçada**.
![\[A opção Criar uma nova fila do SQS ou selecionar uma existente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-dlq-choose.png)
+ Uma nova guia no seu navegador é aberta para o console do Amazon SQS. Selecione **Criar fila**.
+ Na página **Criar fila**, escolha **Padrão** e atribua um nome à sua fila.
![\[A página Criar fila.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-dlq-name.png)
+ Em **Política de acesso**, escolha **Avançado**.
O nome da versão, o ID da política e a declaração são exibidos. Se necessário, atualize esta seção para dar acesso somente às funções apropriadas.
+ Ao final da seção Declaração (linha 15 na imagem a seguir), adicione uma vírgula após \$1 e pressione `Enter`.
![\[Role até a seção Política de acesso.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-dlq-statement.png)
+ Copie e cole o seguinte código:
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
+ Para substituir *region**accountID*, e *YourQueueName* com suas informações, copie e cole as `Resource` informações da linha 14.
![\[A seção Política de acesso, as informações do recurso.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-dlq-copyandpaste.png)
+ Selecione **Criar fila**.
+ Volte para a guia no navegador do console do Amazon Connect, página **Perfis de clientes habilitados**. Clique ou toque na caixa **Escolher fila do SQS existente** que você acabou de criar na lista suspensa.
![\[A fila do SQS na lista suspensa.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-dlq-final.png)
1. Em **Especificar chave do KMS**, crie ou insira sua própria chave AWS KMS key para criptografia. Siga estas etapas para criar a AWS KMS key:
+ Na página **Perfis de clientes habilitados**, escolha **Criar um AWS KMS key**.
![\[Página Perfis de clientes habilitados, o botão Criar um AWS KMS key .\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-kms-key.png)
+ Uma nova guia no navegador é aberta para o console do Key Management Service (KMS). Na página **Configurar chave**, escolha **Simétrica** e selecione **Próximo**.
![\[A página Configurar chave, a opção Simétrica.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
+ Na página **Adicionar rótulos**, insira um nome e uma descrição para a chave e selecione **Próximo**.
![\[A página Adicionar rótulos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-kms-key-add-labels.png)
+ Na página **Definir permissões administrativas da chave**, escolha **Próximo**.
+ Na página **Definir permissões de uso da chave**, escolha **Próximo**.
+ Na página **Revisar e editar política de chave**, escolha **Concluir**.
No exemplo a seguir, o nome da chave começa com **bcb6fdd**:
![\[A página Chaves gerenciadas pelo cliente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-kms-key-note-key.png)
+ Volte para a guia no navegador do console do Amazon Connect, página **Perfis de clientes habilitados**. Clique ou toque na caixa **Especificar chave do KMS** para que a chave que você criou apareça em uma lista suspensa. Escolha a chave que foi criada.
![\[A seção Especificar chave do KMS.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-kms-key-choose-key.png)
1. Em **Armazenamento de dados**, escolha se deseja ativar o armazenamento de dados. É necessário usar segmentação baseada em Spark SQL e insights preditivos. Se você optar por não ativar o armazenamento de dados ao criar um domínio, poderá ativá-lo depois que o domínio for criado e usado. Você não pode desativar o armazenamento de dados depois que ele foi ativado.
Se você tiver um domínio existente sem armazenamento de dados, poderá ativá-lo clicando no botão ativar no banner azul na página Perfis do cliente (painel esquerdo > Perfis do cliente)
O armazenamento de dados requer uma Chave Gerenciada pelo Cliente (CMK) e solicitará que você crie uma Chave Gerenciada pelo Cliente (CMK), caso ainda não tenha habilitado uma para o seu domínio.
1. Selecione **Enviar**. A página preenchida é semelhante à imagem a seguir. Ela mostra o nome do domínio do perfil do cliente, a fila de mensagens não entregues e a chave do KMS.
![\[A página de domínio preenchida dos perfis de clientes.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-final.png)
Tudo pronto\$1 O Amazon Connect Customer Profiles está ativado. Agora, a cada novo contato que chega, o Amazon Connect cria um registro de perfil de cliente. Em seguida, ele rastreia o histórico de contatos desse número de telefone (voz) ou endereço de e-mail (chat).
Seus atendentes podem [criar novos perfis de clientes](ag-cp-create.md) e visualizar registros de contato de seus clientes.
## Próximas etapas
1. [Disponibilize o Customer Profiles por meio da aplicação do atendente](customer-profile-access.md).
1. [Atribua permissões aos atendentes para acessar o Customer Profiles na aplicação do atendente](assign-security-profile-customer-profile.md).
1. [Integre-se a aplicações externas que fornecem dados de perfil do cliente (opcional)](integrate-external-apps-customer-profiles.md).
1. [Ative a Resolução de identidade para identificar dois ou mais perfis semelhantes e consolidá-los](use-identity-resolution.md).
# Conceitos básicos dos modelos de recurso do setor
O Amazon Connect Customer Profiles fornece modelos de recurso do setor para ajudar você a configurar rapidamente seu domínio com atributos calculados, segmentos e layouts do Explorador de Perfis personalizados para setores específicos.
## Antes de começar
Antes de habilitar os modelos de recurso do setor, verifique se você tem:
+ Uma instância do Amazon Connect com o Customer Profiles habilitado.
+ Permissões apropriadas para criar recursos em seu domínio do Customer Profiles.
## Sobre os modelos de recurso do setor
Quando você habilita um modelo de setor, o Customer Profiles cria automaticamente os seguintes recursos em seu domínio:
+ Definições de atributos calculados: atributos predefinidos derivados dos dados do seu cliente.
+ Definições de segmentos: agrupamentos de clientes com base em características comuns.
+ Layouts do Explorador de Perfis: visualizações personalizadas do painel para exibir as informações do cliente.
Esses recursos foram projetados para ajudar você a obter valor rapidamente dos dados do cliente sem precisar criar cada recurso manualmente.
## Habilitar modelos de recurso do setor
1. Na página inicial do Customer Profiles, localize a seção Modelos por setor.
+ Se esta for a primeira vez que você configura o Customer Profiles, um anúncio será exibido na parte superior da página.
![\[O banner para habilitar os modelos aparecerá se esta for a primeira vez que você usa perfis de clientes.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-industry-resource-templates-1.png)
+ Se você já tiver recursos em seu domínio, a lista de modelos habilitados aparecerá na seção Modelos por setor.
![\[Se você já tiver usado perfis de clientes antes, uma lista de modelos habilitados aparecerá na seção Modelos por setor.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-industry-resource-templates-2.png)
1. Para habilitar um modelo, escolha **Habilitar um modelo**.
1. No menu suspenso **Selecionar modelo**, escolha o setor que melhor se adequa à sua empresa:
+ **Companhia aérea**: para empresas de viagens aéreas.
+ **Hotel**: para empresas de hospitalidade.
1. Analise os recursos que serão criados na seção **Revisar recursos**.
![\[Analise os recursos que serão criados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-industry-resource-templates-3.png)
1. Escolha **Habilitar modelo**.
1. Aguarde até que os recursos sejam criados. Mantenha a guia do navegador aberta enquanto a criação de recursos estiver em andamento.
1. Após a conclusão, você verá uma mensagem de confirmação e o modelo aparecerá na seção Modelos por setor com o número de recursos criados.
![\[O banner de criação bem-sucedida é exibido.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-industry-resource-templates-4.png)
## Recursos criados por modelos do setor
### Modelo do setor de companhia aérea
#### Atributos calculados
O modelo de companhia aérea cria atributos calculados em várias categorias:
**Atributos calculados para companhias aéreas**
| Nome do atributo calculado | Nome de exibição | Description | Tipo de objeto |
| --- | --- | --- | --- |
| air\$1airPreference\$1departure\$1airport\$1last\$1occurrence | Aeroporto de partida preferido | Retorna a preferência de aeroporto de partida configurada mais recentemente pelo cliente. | \$1airPreference |
| air\$1airPreference\$1arrival\$1airport\$1last\$1occurrence | Aeroporto de chegada preferido | Retorna a preferência de aeroporto de chegada configurada mais recentemente pelo cliente. | \$1airPreference |
| air\$1airPreference\$1travel\$1type\$1last\$1occurrence | Tipo de viagem preferido | Retorna a preferência de tipo de viagem configurada mais recentemente pelo cliente. | \$1airPreference |
| air\$1airPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | Preferência de aceitação de marketing | Retorna a configuração de aceitação de marketing configurada mais recentemente pelo cliente. | \$1airPreference |
| air\$1airPreference\$1language\$1in\$1person\$1language\$1last\$1occurrence | Idioma presencial preferido | Retorna a preferência de idioma configurada mais recentemente pelo cliente para interações presenciais. | \$1airPreference |
| air\$1airPreference\$1seat\$1location\$1last\$1occurrence | Localização de assento preferida | Retorna a preferência de localização de assento selecionada mais recentemente pelo cliente. | \$1airPreference |
| air\$1airPreference\$1home\$1airport\$1last\$1occurrence | Aeroporto de origem preferido | Retorna o aeroporto de origem especificado mais recentemente pelo cliente. | \$1airPreference |
| air\$1airPreference\$1dining\$1dietary\$1restriction\$1last\$1occurrence | Restrição alimentar preferencial | Retorna a restrição alimentar especificada mais recentemente pelo cliente. | \$1airPreference |
| air\$1airBookings\$1number\$1of\$1passengers\$1average | Média de passageiros por reserva | Retorna o número médio de passageiros nas reservas do cliente. | \$1airBooking |
| air\$1airBookings\$1price\$1total\$1price\$1average | Preço médio da reserva | Retorna o custo médio entre todas as reservas do cliente. | \$1airBooking |
| air\$1airBookings\$1count | Contagem de reservas | Retorna a contagem de reservas feitas por um cliente. | \$1airBooking |
| air\$1airSegments\$1flight\$1delay\$1time\$1sum | Duração total de atrasos em voos | Retorna a duração total dos atrasos de voo sofridos pelo cliente. | \$1airSegment |
| air\$1airSegments\$1cancelled\$1flights\$1count\$130\$1days | Voos cancelados nos últimos 30 dias | Retorna a contagem de voos cancelados do cliente nos últimos 30 dias. | \$1airSegment |
| air\$1airSegments\$1delayed\$1flights\$1count\$130\$1days | Voos atrasados nos últimos 30 dias | Retorna a contagem de voos atrasados do cliente nos últimos 30 dias. | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$130\$1days | Voos realizados nos últimos 30 dias | Retorna a contagem de voos realizados pelo cliente nos últimos 30 dias. | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$11\$1year | Voos realizados no último ano | Retorna a contagem de voos realizados pelo cliente no último ano. | \$1airSegment |
| air\$1airSegment\$1departure\$1date\$1last\$1occurrence | Data de partida do último voo | Retorna a data de partida do voo mais recente do cliente. | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum | Total de milhas voadas | Retorna o total de todas as distâncias de voo em milhas para um cliente. | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum\$11\$1year | Milhas de voo no último ano | Retorna o total de milhas de voo percorridas pelo cliente no último ano. | \$1airSegment |
| air\$1airSegments\$1business\$1first\$1class\$1count | Contagem de voos de classe premium | Retorna a contagem de trechos aéreos reservados como classe executiva ou primeira classe pelo cliente. | \$1airSegment |
| air\$1loyalties\$1points\$1redeemed\$1sum | Total de pontos de fidelidade resgatados | Retorna o total de pontos resgatados em todos os programas de fidelidade do cliente. | \$1loyalty |
| air\$1loyalties\$1count | Contagem de associações de fidelidade | Retorna o número de associações a programas de fidelidade mantidas pelo cliente. | \$1loyalty |
| air\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | Pontos para o próximo nível | Retorna o registro mais recente de pontos necessários para que o cliente alcance o próximo nível de fidelidade. | \$1loyalty |
| air\$1loyalty\$1points\$1balance\$1last\$1occurrence | Saldo atual de pontos de fidelidade | Retorna o saldo de pontos de fidelidade mais recente do cliente. | \$1loyalty |
| air\$1loyalty\$1membership\$1id\$1last\$1occurrence | ID atual de membro do programa de fidelidade | Retorna o identificador de fidelidade mais recente do cliente. | \$1loyalty |
| air\$1loyalty\$1program\$1name\$1last\$1occurrence | Nome atual do programa de fidelidade | Retorna o nome mais recente do programa de fidelidade do cliente. | \$1loyalty |
| air\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | Data de inscrição de fidelidade mais recente | Retorna a data mais recente de inscrição do cliente no programa de fidelidade. | \$1loyalty |
| air\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | Nível de fidelidade atual | Retorna o status mais recente do cliente no programa de fidelidade. | \$1loyalty |
| air\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | Número de adesões de nível premium | Retorna a contagem de programas de fidelidade do cliente com Silver. | \$1loyalty |
| air\$1loyaltyPromotions\$1count | Contagem de promoções de fidelidade | Retorna o número total de promoções de fidelidade recebidas pelo cliente. | \$1loyaltyPromotion |
#### Segmentos
O modelo de companhia aérea cria os seguintes segmentos:
+ [Companhia aérea] Assinantes de marketing
+ [Companhia aérea] Clientes com voos cancelados nos últimos 30 dias
+ [Companhia aérea] Clientes com voos atrasados nos últimos 30 dias
+ [Companhia aérea] Clientes com voos realizados nos últimos 30 dias
+ [Companhia aérea] Membros inativos
#### Layout do Explorador de Perfis
Um layout do Explorador de Perfis de demonstração é criado com o nome `DEMO-Airline-Layout`, que consiste nos seguintes widgets:
+ Detalhes do cliente e informações de contato
+ Status e pontos do programa de fidelidade
+ Reservas e voos recentes
+ Preferências do cliente
+ Métricas de valor do cliente
+ Indicadores de satisfação do cliente
### Modelo do setor de hotelaria
#### Atributos calculados
O modelo de hotelaria cria atributos calculados em várias categorias:
**Atributos calculados para hotéis**
| Nome do atributo calculado | Nome de exibição | Description | Tipo de objeto |
| --- | --- | --- | --- |
| hotel\$1hotelPreference\$1location\$1room\$1type\$1last\$1occurrence | Tipo de quarto preferido | Retorna a preferência de tipo de quarto configurada mais recentemente pelo cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1cleaning\$1time\$1last\$1occurrence | Tempo de limpeza preferido | Retorna a preferência de tipo de limpeza de quarto configurada mais recentemente pelo cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1location\$1view\$1last\$1occurrence | Vista do quarto preferida | Retorna a preferência de vista do quarto configurada mais recentemente pelo cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1in\$1type\$1last\$1occurrence | Método de check-in preferido | Retorna a preferência de método de check-in configurada mais recentemente pelo cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1out\$1type\$1last\$1occurrence | Método de check-out preferido | Retorna a preferência de método de check-out configurada mais recentemente pelo cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1special\$1request\$1last\$1occurrence | Último tipo de solicitação especial | Retorna o tipo de acomodação especial solicitado mais recentemente pelo cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1interest\$1name\$1of\$1interest\$1max\$1occurrence | Interesse mais frequente | Retorna o interesse ou a preferência de comodidade que o cliente mais expressa. | \$1hotelPreference |
| hotel\$1hotelPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | Preferência de aceitação de marketing | Retorna a configuração de aceitação de marketing configurada mais recentemente pelo cliente. | \$1hotelPreference |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1average | Duração média da estadia | Retorna a duração média da estadia entre todas as reservas de hotel do cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum\$11\$1year | Total de noites no último ano | Retorna o total de noites em hotéis no último ano entre todas as reservas do cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum | Total de noites em hotéis | Retorna o total de noites em hotéis entre todas as reservas do cliente. | \$1hotelReservation |
| hotel\$1hotelReservation\$1room\$1type\$1name\$1last\$1occurrence | Último tipo de quarto reservado | Retorna o tipo de quarto reservado mais recentemente pelo cliente. | \$1hotelReservation |
| hotel\$1hotelReservation\$1channel\$1method\$1last\$1occurrence | Último canal de reserva usado | Retorna o canal mais recente usado para reserva de hotel pelo cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1count | Contagem de reservas | Retorna a contagem de reservas de hotel feitas por um cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1average | Gasto médio por reserva | Retorna o valor médio gasto por reserva de hotel após impostos. | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1sum | Gasto total do com hotéis | Retorna o valor total gasto em todas as reservas de hotel do cliente após impostos. | \$1hotelReservation |
| hotel\$1hotelReservation\$1number\$1of\$1guests\$1max\$1occurrence | Tamanho de grupo mais comum | Retorna o número de hóspedes mais frequentemente reservado pelo cliente em todas as estadias. | \$1hotelReservation |
| hotel\$1hotelReservations\$1business\$1travel\$1count | Contagem de viagens de negócios | Retorna a contagem de reservas marcadas como viagem de negócios pelo cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1missed\$1checkin\$1count | Contagem de check-ins perdidos | Retorna a contagem de reservas em que o cliente não compareceu ao check-in. | \$1hotelReservation |
| hotel\$1hotelReservation\$1cancelled\$1count | Contagem de reservas canceladas | Retorna a contagem de reservas de hotel que foram canceladas pelo cliente. | \$1hotelReservation |
| hotel\$1 hotelStayRevenues \$1amount\$1sum | Receita total gerada | Retorna a receita total gerada por todas as estadias do cliente em hotéis. | \$1hotelStayRevenue |
| hotel\$1 \$1quantidade\$1média hotelStayRevenues | Receita média por estadia | Retorna o valor médio da receita calculado com base em todas as estadias do cliente. | \$1hotelStayRevenue |
| hotel\$1 \$1quantidade\$1máxima hotelStayRevenues | Valor da receita mais alta | Retorna o maior valor de receita gerado por qualquer estadia do cliente. | \$1hotelStayRevenue |
| hotel\$1 \$1receita\$1tipo\$1máx\$1ocorrência hotelStayRevenue | Fonte de receita mais comum | Retorna o tipo mais frequente de receita gerada em estadias do cliente em hotéis. | \$1hotelStayRevenue |
| hotel\$1loyalties\$1points\$1redeemed\$1sum | Total de pontos de fidelidade resgatados | Retorna o total de pontos resgatados em todos os programas de fidelidade do cliente. | \$1loyalty |
| hotel\$1loyalties\$1count | Contagem de associações de fidelidade | Retorna o número de associações a programas de fidelidade mantidas pelo cliente. | \$1loyalty |
| hotel\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | Pontos para o próximo nível | Retorna o registro mais recente de pontos necessários para que o cliente alcance o próximo nível de fidelidade. | \$1loyalty |
| hotel\$1loyalty\$1points\$1balance\$1last\$1occurrence | Saldo atual de pontos de fidelidade | Retorna o saldo de pontos de fidelidade mais recente do cliente. | \$1loyalty |
| hotel\$1loyalty\$1membership\$1id\$1last\$1occurrence | ID atual de membro do programa de fidelidade | Retorna o identificador de fidelidade mais recente do cliente. | \$1loyalty |
| hotel\$1loyalty\$1program\$1name\$1last\$1occurrence | Nome atual do programa de fidelidade | Retorna o nome mais recente do programa de fidelidade do cliente. | \$1loyalty |
| hotel\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | Data de inscrição de fidelidade mais recente | Retorna a data mais recente de inscrição do cliente no programa de fidelidade. | \$1loyalty |
| hotel\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | Nível de fidelidade atual | Retorna o status mais recente do cliente no programa de fidelidade. | \$1loyalty |
| hotel\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | Número de adesões de nível premium | Retorna a contagem de programas de fidelidade do cliente com Silver. | \$1loyalty |
| hotel\$1loyaltyPromotions\$1count | Contagem de promoções de fidelidade | Retorna o número total de promoções de fidelidade recebidas pelo cliente. | \$1loyaltyPromotion |
#### Segmentos
O modelo de hotel cria segmentos como:
+ [Hotel] Assinantes de marketing de preferências
+ [Hotel] Viajantes individuais
+ [Hotel] Viajantes em casal ou em dupla
+ [Hotel] Viajantes em família ou em grupo
+ [Hotel] Clientes com reserva nos próximos 30 dias
#### Layout do Explorador de Perfis
Um layout personalizado que exibe:
+ Detalhes do cliente e informações de contato
+ Preferências de quarto
+ Histórico do estadias
+ Informações de receita
+ Status de lealdade
## Desabilitar modelos do setor
Você pode desabilitar um modelo de setor para remover os recursos que ele criou do seu domínio. Para desabilitar um modelo:
1. Na página inicial do Customer Profiles, localize a seção Modelos por setor.
1. Encontre o modelo que deseja desabilitar e escolha a ação **Desabilitar**.
1. Revise a mensagem de confirmação e escolha **Confirmar** para desabilitar o modelo.
**Importante**
Quando você desabilita um modelo, todos os recursos criados por esse modelo são excluídos do seu domínio. Se algum desses recursos for usado em segmentos de clientes, campanhas externas ou fluxos de contato, a desabilitação do modelo poderá afetá-los.
Antes de desabilitar um modelo, analise os recursos em uso para entender o impacto potencial.
## Solução de problemas
**Solucionar problemas de modelos do setor**
| Erro | Recomendação |
| --- | --- |
| Falha na criação dos recursos do modelo | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| Os recursos criados não são exibidos no Explorador de Perfis | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| Não é possível habilitar vários modelos | Cada domínio pode ter vários modelos por setor habilitados. Se estiver enfrentando problemas, verifique se você não atingiu os limites de recursos do seu domínio. |
| É necessário excluir recursos do modelo | No momento, o recurso de Conceitos básicos não fornece uma maneira de excluir automaticamente todos os recursos criados por um modelo. Você pode excluir manualmente recursos individuais por meio de suas respectivas páginas de gerenciamento. |
## Próximas etapas
Depois de habilitar um modelo do setor, você pode:
+ Navegar até o Explorador de Perfis para ver o novo layout em ação.
+ Visualizar e editar atributos calculados para melhor atender às suas necessidades específicas.
+ Gerenciar segmentos de clientes no Amazon Connect.
+ Editar o layout do Explorador de Perfis com base nos requisitos da sua empresa.
+ Integrar aplicações externas ao Amazon Connect Customer Profiles para começar a preencher perfis.
# Acessar o Amazon Connect Customer Profiles no espaço de trabalho do atendente
Depois de ativar os perfis de Amazon Connect clientes, os agentes podem começar a interagir com os clientes e acessar [as informações dos clientes](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles.html) para fornecer um serviço personalizado. Este tópico explica como acessar o espaço de trabalho do Amazon Connect agente.
**dica**
Certifique-se de que seus atendentes tenham permissões do **Customer Profiles** nos perfis de segurança para que possam acessá-lo. Para obter mais informações, consulte [Permissões do perfil de segurança do Amazon Connect Customer Profiles](assign-security-profile-customer-profile.md).
## Opção 1: usar perfis de clientes com a CCP out-of-the-box
O Customer Profiles já está incorporado ao Painel de Controle de Contatos (CCP). Seus agentes podem acessar o CCP, os perfis de clientes e o gerenciamento Amazon Connect de casos na mesma janela do navegador, fazendo login na Amazon Connect instância e escolhendo o botão **Espaço de trabalho do agente** localizado no canto superior direito, conforme mostrado na imagem a seguir.
![\[A página Customer Profiles e o botão destacado que abre o espaço de trabalho do atendente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-agent-workspace-open.png)
**nota**
Você também pode acessar o espaço de trabalho do atendente usando o seguinte URL:
***instance name*agent-app-vhttps://.my.connect.aws/ 2/**
Se você acessar a instância usando o domínio **awsapps.com**, use o seguinte URL:
**https://*instance name*.awsapps. com/connect/agent-aplicativo-v2/**
Para obter ajuda para encontrar o nome da instância, consulte [Encontrar o nome da sua instância do Amazon Connect](find-instance-name.md).
Este é um exemplo da aparência do Customer Profiles no espaço de trabalho do atendente.
![\[A guia Customer Profiles e o CCP no espaço de trabalho do atendente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-agent-app.png)
## Opção 2: incorporar Customer Profiles a um espaço de trabalho personalizado do atendente
Ao incorporar seu Painel de Controle de Contatos (CCP), você tem a opção de mostrar ou ocultar a interface de usuário predefinida do CCP. Por exemplo, talvez você queira desenvolver um espaço de trabalho do atendente personalizado que tenha uma interface de usuário projetada por você, com botões personalizados para aceitar e rejeitar chamadas. Ou talvez você queira incorporar o CCP predefinido que está incluído no Amazon Connect em outra aplicação personalizada.
Independentemente de exibir a interface de usuário do CCP predefinida ou ocultá-la e criar sua própria, você usa a biblioteca [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) para incorporar o CCP e o Customer Profiles ao espaço de trabalho do atendente. Dessa forma, o Amazon Connect Streams é inicializado e o atendente pode se conectar e se autenticar no Amazon Connect e no Customer Profiles.
Para obter informações sobre a incorporação do Customer Profiles, consulte [Initialization for CCP, Customer Profiles, and Wisdom](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#initialization-for-ccp-customer-profiles-and-wisdom).
Para criar seu próprio widget usando dados brutos dos perfis de clientes, consulte a documentação do [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles) sobre como usar a biblioteca de código aberto CustomerProfiles JS.
**dica**
Ao personalizar o espaço de trabalho do atendente, você determina o URL que os atendentes usarão para acessar o espaço de trabalho do atendente, e ele pode ser muito diferente do fornecida pelo Amazon Connect. Por exemplo, seu URL pode ser https://example-corp.com/agent-support-app.
# Preencher automaticamente os perfis de clientes
Por padrão, o Amazon Connect Customer Profiles usa os seguintes valores para pesquisar e preencher automaticamente um perfil de cliente em sua interface de usuário:
+ Para contatos de voz: número de telefone
+ Para contatos de chat: e-mail
Ele preenche automaticamente um perfil de cliente usando o bloco de fluxo do Customer Profiles. Para personalizar esse comportamento, use o bloco [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md) (veja abaixo) para os seguintes atributos de contato:
| 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 |
Por exemplo, para pesquisar contatos de chat por e-mail, você pode definir o atributo `profileSearchKey` como a chave de pesquisa `_email` e fornecer o valor do e-mail como o `profileSearchValue`.
Se tiver definido chaves personalizadas em seus objetos de perfil, você também poderá pesquisar por essas chaves de pesquisa. Para garantir que suas chaves personalizadas possam ser pesquisadas, consulte [Detalhes de definição da chave](object-type-mapping-definition-details.md#key-definition-details).
A imagem a seguir mostra como você pode usar esses atributos no bloco [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md).
![\[A página Propriedades do bloco Definir atributos de contato.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-attributes1.png)
## Associar automaticamente um perfil de cliente a um contato
Por padrão, os atendentes precisam associar manualmente um perfil de cliente a um contato depois de verificarem a identidade do cliente. Para alterar esse comportamento para associar automaticamente contatos a um perfil com base no número de telefone, consulte [Associar o registro de contato a um perfil encontrado usando a chave \$1phone no Customer Profiles](auto-associate-profile-using-phone-profile-key.md).
Se vários perfis corresponderem ao número de telefone de um contato, os vários perfis correspondentes serão mostrados ao atendente. O atendente precisa escolher qual perfil associar ao contato.
# Permissões do perfil de segurança do Amazon Connect Customer Profiles
Atribua permissões aos perfis de segurança dos atendentes para que eles possam realizar tarefas como pesquisar perfis e visualizar detalhes do cliente, associar registros de contato a perfis, editar perfis e criar e salvar perfis. Os tópicos na seção ajudam você a atribuir permissões atualizando as permissões para atendentes, fluxos e atributos calculados. Também há informações para ajudar na solução de possíveis erros durante a atualização das permissões.
**Topics**
+ [
# Atualizar as permissões do Customer Profiles para atendentes
](security-profile-customer-profile-agent.md)
+ [
# Atualizar as permissões do Customer Profiles para fluxos
](security-profile-customer-profile-contact-flows.md)
+ [Atualizar permissões para atributos calculados](security-profile-customer-profile-calc-attribs.md)
+ [Permissões de perfil de segurança para segmentos de clientes](security-profile-customer-profile-segmentation.md)
+ [
# Atribuir novas permissões do Customer Profiles em caso de erro
](security-profile-customer-profile-issues.md)
# Atualizar as permissões do Customer Profiles para atendentes
Atribua as seguintes permissões do **Customer Profiles**, conforme necessário, ao perfil de segurança do atendente:
+ **Exibir**: permite que os atendentes vejam a aplicação do Customer Profiles. Ele pode:
+ Visualize perfis preenchidos automaticamente na aplicação do atendente.
+ Pesquisar perfis.
+ Visualize os detalhes armazenados nos perfis dos clientes (por exemplo, Nome, Endereço).
+ Associe registros de contato a perfis conforme mostrado na imagem a seguir.
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-associate.png)
+ **Editar**: permite que os atendentes editem detalhes no perfil do cliente (por exemplo, alterar endereço). Eles herdam as permissões de **Exibir** por padrão.
+ **Criar**: permite que os atendentes criem e salvem um novo perfil. Eles herdam as permissões de **Exibir** por padrão, mas não herdam as permissões de **Editar**.
Para obter informações sobre como adicionar mais permissões a um perfil de segurança existente, consulte [Atualizar perfis de segurança no Amazon Connect](update-security-profiles.md).
Por padrão, o perfil de segurança **Admin** já tem permissões para realizar todas as atividades do Customer Profiles.
# Atualizar as permissões do Customer Profiles para fluxos
1. Acesse a página Perfis de segurança, escolha o perfil de segurança que deseja editar ou escolha **Adicionar novo perfil de segurança**.
![\[Página Perfis de segurança.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. Selecione a permissão **Exibir** para Customer Profiles.
![\[Selecione permissões de exibição na página dos perfis de segurança.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-2.png)
1. Escolha **Salvar**. Agora você pode navegar até a seção **Gerenciamento de usuários** e fornecer esse perfil de segurança aos usuários de sua escolha.
# Atualizar permissões para atributos calculados no Amazon Connect Customer Profiles
1. Acesse a página Perfis de segurança, escolha o perfil de segurança que deseja editar ou escolha **Adicionar novo perfil de segurança**.
![\[Página Perfis de segurança.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. Selecione a permissão **Tudo** ou **Exibir**, **Editar**, **Criar** e **Excluir** para atributos calculados.
![\[Selecione permissões de exibir, editar, criar e excluir no console dos perfis de segurança.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/security-profile-customer-profile-calc-attribs-2.png)
1. Escolha **Salvar**. Agora você pode navegar até a seção **Gerenciamento de usuários** e fornecer esse perfil de segurança aos usuários de sua escolha.
# Atribuir permissões do perfil de segurança para gerenciar segmentos de clientes
Atribua as seguintes permissões de segmentos de clientes, conforme necessário, ao perfil de segurança do usuário. Para obter mais detalhes sobre perfis de segurança, consulte [Perfis de segurança para acesso ao Amazon Connect e ao Painel de controle do contato (CCP)](connect-security-profiles.md).
1. Acesse a página Perfis de segurança, escolha o perfil de segurança que deseja editar ou escolha **Adicionar novo perfil de segurança**.
![\[A página Perfis de segurança e a seção Perfis de clientes.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-1.png)
1. Selecione a permissão **Tudo** ou **Exibir**, **Criar**, **Excluir** e **Exportar** para segmentos de clientes.
![\[A permissão para segmentos de clientes definida como Tudo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-2.png)
1. Escolha **Salvar**. Agora você pode navegar até a seção **Gerenciamento de usuários** e fornecer esse perfil de segurança aos usuários de sua escolha.
# Atribuir novas permissões do Customer Profiles em caso de erro
1. Para atualizar as permissões no caso de um erro 403 de chamada proibida para qualquer back-end APIs, navegue até a seção de domínio do console Perfis de Amazon Connect clientes e escolha **Exibir detalhes**.
![\[A seção de domínio do console Amazon Connect Customer Profiles.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-1.png)
1. Escolha **Atualizar permissões** na seção Exibir detalhes do domínio.
![\[O botão Atualizar permissões aparecerá aqui se alguma permissão pendente precisar ser atualizada.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-2.png)
1. Feito isso, as permissões serão atualizadas com êxito, e o botão **Atualizar permissões** não estará mais visível na seção de detalhes do domínio. Isso atenuará o problema do erro 403 proibido, e você poderá fazer chamadas de API com êxito.
![\[O botão Atualizar permissões desaparece assim que a ação é concluída com êxito.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-3.png)
# Expiração de dados do Amazon Connect Customer Profiles
Se um perfil não for atualizado dentro de um período especificado, ele expirará. Isso fará com que o perfil seja limpo e removido do domínio do Customer Profiles.
O tempo de expiração dos dados dos perfis de clientes pode ser dividido em duas categorias diferentes:
## Perfis criados via CreateProfile
Os perfis criados usando a `CreateProfile` API expirarão com base na data e hora atribuída por um domínio de perfis **DefaultExpirationDays**de clientes. Se nenhuma expiração for configurada, o padrão será 365 dias.
## Perfis criados ou atualizados via PutProfileObject
Os perfis criados ou atualizados usando sempre `PutProfileObject` respeitarão o **ExpirationDays**definido no tipo de objeto associado a eles. Se nenhuma expiração for definida no tipo de objeto, a data de expiração do domínio do Customer Profiles será usada. Por fim, se nenhum deles for fornecido, o perfil ou o objeto do perfil expirarão nos 365 dias padrão.
## Modelo mental visualizado
![\[Um fluxograma mostrando a lógica de expiração do Customer Profiles.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-expiration-model.png)
## Expiração do perfil de importação
Se um perfil tiver sido importado para um domínio de perfil de cliente usando a importação de segmentos, sua expiração se enquadrará em dois cenários diferentes.
1. **Definição explícita de expiração ao ligar CreateUploadJob**
Por padrão, os perfis importados usando a importação de segmentos expirarão em 14 dias se nenhuma atualização tiver sido realizada. Esse número [pode ser definido](customer-segments-imported-files.md#set-profile-expiry) usando a API ou no site do Amazon Connect administrador durante a criação da importação, com no máximo 90 dias.
1. **Importar perfis que já existem em seu domínio do Customer Profiles de um trabalho de importação anterior**
Se dois trabalhos de importação tiverem sido executados e um perfil duplicado for encontrado, os perfis de clientes sempre respeitarão o prazo de validade mais longo.
# Usar a Resolução de identidade para consolidar perfis semelhantes no Amazon Connect
Um *perfil semelhante* ocorre quando dois ou mais perfis são determinados para o mesmo contato. Pode haver vários perfis quando os registros do cliente são capturados em vários canais e aplicações para o mesmo cliente e não compartilham um identificador exclusivo comum.
A Resolução de identidade encontra automaticamente perfis semelhantes e ajuda você a consolidá-los. Ela executa um trabalho semanalmente, que executa as seguintes etapas:
1. [Correspondência automática de perfis](how-identity-resolution-works.md#auto-profile-matching)
1. [Mesclagem automática de perfis semelhantes](how-identity-resolution-works.md#auto-profile-merging) com base em seus critérios de consolidação
Sempre que um trabalho da Resolução de identidade é executado, ele exibe métricas na página **Customer Profiles**. As métricas mostram o número de perfis analisados, o número de grupos de correspondência encontrados e o número de perfis consolidados.
Podem ser aplicadas cobranças adicionais para ativar a Resolução de identidade. Para obter mais informações, consulte [Preços do Amazon Connect](https://aws.amazon.com/connect/pricing/).
![\[A página Amazon Connect Customer Profiles, o botão Habilitar Identity Resolution (Resolução de identidade).\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Habilitar a Resolução de identidade para seu domínio do Amazon Connect Customer Profiles
**Importante**
Amazon Connect Os casos não são totalmente compatíveis com a resolução de identidade de perfis de clientes do Amazon Connect ao usar o Agent Workspace. Veja o que acontece com os chamados existentes quando os perfis são mesclados:
Os chamados permanecem vinculados ao ID original do perfil após a mesclagem.
Os chamados não se consolidam automaticamente em perfis mesclados.
Não há nenhum método compatível para associar novamente um chamado existente a outro perfil. Use [CreateCase](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html)e [CreateRelatedItem](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateRelatedItem.html)como solução alternativa se precisar consolidar os casos manualmente.
Ao ativar a Resolução de identidade, você especifica as seguintes informações:
+ Quando o trabalho da Resolução de identidade deve ser executado semanalmente. Por padrão, ele é executado aos sábados às 12h UTC.
+ O bucket do Amazon S3 em que o trabalho da Resolução de identidade deve gravar os resultados do processo automático de correspondência de perfis. Se não tiver um bucket do S3, você terá a opção de criar um durante o processo de habilitação.
Você pode consultar o bucket do Amazon S3 ou usar a [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API para filtrar os resultados com base nas pontuações de [confiança](how-identity-resolution-works.md#confidence-score).
Depois de ativar a Resolução de identidade, você verá a opção de [criar critérios de consolidação](create-consolidation-criteria.md) para o processo opcional de mesclagem automática.
**Para habilitar Resolução de identidade**
1. Você deve ter um domínio do Customer Profiles ativado para sua instância. Para instruções, consulte [Habilitar o Customer Profiles para a instância do Amazon Connect](enable-customer-profiles.md).
1. No painel de navegação, escolha **Perfis de clientes**.
1. Na seção **Resolução de identidade**, escolha **Habilitar Identity Resolution (Resolução de identidade)**.
![\[A página Amazon Connect Customer Profiles, o botão Habilitar Identity Resolution (Resolução de identidade).\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
1. Na caixa pop-up **Resolução de identidade**, escolha **Habilitar Identity Resolution (Resolução de identidade)**.
![\[A página Amazon Connect Customer Profiles, o botão Habilitar Identity Resolution (Resolução de identidade).\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-ir-2.png)
1. Na página **Habilitar Identity Resolution (Resolução de identidade)**, especifique a data e a hora em que você deseja que o trabalho da Resolução de identidade seja executado.
1. Se você quiser revisar o perfil correspondente IDs de um bucket do Amazon S3, **selecione Write profile ID matches to Amazon S3**. Caso contrário, você pode usar a [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API para revisar os perfis correspondentes.
**nota**
Se você ativar automaticamente as mesclagens, não receberá o perfil correspondente. IDs
1. Especifique o bucket do Amazon S3 em que o trabalho da Resolução de identidade deve gravar as correspondências de perfis.
Recomendamos aplicar uma política para evitar um problema de segurança “confused deputy”. Para obter mais informações e uma política de exemplo consulte [Prevenção do problema de substituto confuso entre serviços no Amazon Connect Customer Profiles](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service).
1. Quando terminar, escolha **Habilitar Identity Resolution (Resolução de identidade)**. Tanto a correspondência baseada em regras quanto a correspondência baseada em ML serão ativadas depois que você ativar a Resolução de identidade. Você pode desativar uma delas ou ambas na página Resolução de identidade. Para obter mais informações, consulte [Desabilitar a Resolução de identidade no Amazon Connect Customer Profiles](disable-identity-resolution.md).
1. Correspondência baseada em regras para Resolução de identidade:
1. Depois de habilitar a correspondência baseada em regras com um novo domínio, a correspondência começará imediatamente se você configurar uma integração e ela estiver em execução.
1. Depois que você ativar a correspondência baseada em regras com um domínio existente, o processo de correspondência começará em uma hora.
1. Correspondência baseada em ML para Resolução de identidade:
1. Depois que você habilitar a Resolução de identidade, o trabalho da Resolução de identidade será executado pela primeira vez em 24 horas.
**nota**
Antes de executar um trabalho de Resolução de identidade pela primeira vez em um novo domínio do Customer Profiles, recomendamos verificar as métricas do seu perfil para garantir que os perfis tenham sido criados. Caso contrário, não haverá resultados correspondentes.
1. Configure critérios de consolidação para mesclar automaticamente os perfis correspondentes. Se sim, consulte [Configurar critérios de consolidação para a Resolução de identidade no Amazon Connect](create-consolidation-criteria.md).
# Configurar critérios de consolidação para a Resolução de identidade no Amazon Connect
**nota**
Você deve [Habilitar resolução de identidade](#create-consolidation-criteria) para acessar a opção de criar critérios de consolidação usando o console administrativo do Amazon Connect.
Quando perfis semelhantes são detectados por um trabalho da Resolução de identidade, o processo pode mesclá-los automaticamente em um perfil unificado com base nos critérios de consolidação especificados por você.
Os atributos que você seleciona são comparados em todos os perfis semelhantes em um grupo de correspondência para obter a correspondência exata. Por exemplo, se você especificar `email` como um atributo nos critérios, todos os perfis semelhantes em um grupo de correspondência terão exatamente o mesmo valor de `email address` e serão mesclados em um perfil unificado.
**dica**
Se você quiser configurar sua própria lógica de mesclagem, use a [MergeProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MergeProfiles.html)API.
## Limites
Você pode selecionar qualquer atributo do [perfil padrão](standard-profile-definition.md) para comparar perfis semelhantes. Por exemplo, você pode escolher número de telefone, endereço de e-mail e nome, além de atributos personalizados.
Você pode especificar até:
+ Dez critérios de consolidação
+ Vinte atributos por critério
## Dicas para criar critérios fortes
Para melhorar a segmentação de perfis exclusivos e evitar a consolidação de perfis que não sejam duplicados, recomendamos as seguintes etapas:
+ Selecione atributos que possam identificar um cliente de forma exclusiva e que provavelmente não sejam os mesmos para todos os clientes, como um número de conta ou uma forma de identificação oficial.
+ Evite critérios de atributo único. Selecione vários atributos para criar uma combinação de atributos para melhorar a segmentação. Por exemplo:
+ **Número de telefone** com **Nome**, **Nome do meio**, **Sobrenome** é um critério mais forte
do que
+ **Número de telefone** sozinho, ou
+ A combinação de **Nome, nome do meio, nome, sobrenome** sozinho
+ Selecione todos os atributos em um grupo de atributos específico, quando aplicável. Por exemplo, se você quiser usar o nome, selecione todos os atributos de nome relacionados: **Nome, nome do meio, sobrenome**. Se você quiser usar o endereço comercial, selecione todos os atributos de endereço comercial relacionados.
+ Inclua um dos seguintes atributos que provavelmente identificarão de forma exclusiva um cliente em combinação com outros atributos nos critérios:
+ Número da conta
+ Número de telefone
+ E-mail
## Como configurar critérios de mesclagem automática
Antes de configurar seus critérios de consolidação para mesclagem automática ou mesclagem automática, é recomendável analisar [Como funciona o processo de mesclagem automática](how-identity-resolution-works.md#consolidation-criteria-how-it-works).
1. Depois de ativar a Resolução de identidade, na página **Resolução de identidade**, você terá a opção de configurar critérios de mesclagem automática. Escolha **Criar critérios de consolidação**.
1. Se você receber uma caixa de diálogo **Data e hora ausentes**, será recomendável adicionar novos atributos de carimbo de data/hora aos seus tipos de objetos personalizados antes de continuar. Consulte [Data e hora ausentes para conflitos de perfil](#missing-timestamp-for-profile-conflicts).
1. Na seção **Conflitos de perfil**, escolha como os conflitos de perfil deverão ser resolvidos quando dois ou mais registros tiverem conflitos.
1. Na seção **Critérios de consolidação**, crie um ou mais critérios. É recomendável incluir pelo menos dois ou mais atributos por critério.
## Data e hora ausentes para conflitos de perfil
A mensagem **Data e hora ausentes** será exibida se você tiver mapeamentos de tipo de objeto personalizados.
Use a [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API para adicionar os seguintes novos atributos ao seu tipo de objeto personalizado:
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
Se o atributo de carimbo de data/hora não for especificado, você poderá continuar criando critérios de consolidação. No entanto, será usado um carimbo de data e hora padrão de quando os registros foram ingeridos no Customer Profiles. É recomendável adicionar os novos atributos antes de criar seus critérios de consolidação.
Se você já tiver definido um tipo de objeto personalizado e quiser atualizar seu tipo de objeto personalizado, executaremos um preenchimento programado toda semana para atualizar os perfis existentes com o `Fields.sourceLastUpdatedTimestamp`. Para aceitar o preenchimento programado:
1. Atualize seu tipo de objeto de perfil personalizado usando a [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
1. Depois de atualizar seu tipo de objeto de perfil personalizado, abra um [tíquete do Suporte](https://console.aws.amazon.com/support/home) e agendaremos o preenchimento para você. O preenchimento programado vai até o final de fevereiro de 2022.
Como alternativa, você pode excluir e recriar o que ingestion/connector você tem para seu domínio que usa o tipo de objeto personalizado. Todos os seus dados serão ingeridos novamente usando seu tipo de objeto atualizado, e `Fields.sourceLastUpdatedTimestamp` será analisado a partir dele.
## Exemplo: como os critérios de exemplo são aplicados
Neste exemplo, há três critérios:
+ **Resolver conflitos de perfil** está definido como **Use o carimbo de data e hora atualizado mais recentemente**. Isso significa que, quando dois campos tiverem valores conflitantes, a Resolução de identidade usará o último carimbo de data/hora atualizado para determinar qual valor usar.
+ Critério 1:
+ Nome, sobrenome
+ E-mail
+ Critério 2:
+ Número de telefone
Esses critérios são aplicados aos seguintes perfis:
+ Perfil A
+ John Doe [última atualização às **5h**]
+ doefamily@anyemail.com [última atualização às **5h**]
+ 555-555-5555 [última atualização às **7h**]
+ Perfil B
+ John Doe [última atualização às **4h**]
+ doefamily@anyemail.com [última atualização às **6h**]
+ 555-555-555**6** [última atualização às *4h*]
+ Perfil C
+ **Jane** Doe [última atualização às **6h**]
+ doefamily@anyemail.com [última atualização às **7h**]
+ 555-555-5555 [última atualização às **6h**]
A seguir estão os resultados de quando o Critério 1 é aplicado:
+ Os perfis A e B são mesclados = Perfil AB
Isso resulta em ProfileAB, que se parece com este:
+ John Doe [última atualização às **5h**]
+ doefamily@anyemail.com [última atualização às **7h**]
+ 555-555-555**5** [última atualização às **6h**]
Como há um conflito entre os números de telefone, a Resolução de identidade usa o último carimbo de data/hora para escolher o número 555-555-555.
Em seguida, o Critério 2 é aplicado. Estes são os resultados:
+ Os perfis AB e C são mesclados = Perfil ABC
Isso resulta em Perfil ABC, que se parece com este:
+ **Jane** Doe [última atualização às **6h**]
+ doefamily@anyemail.com [última atualização às **7h**]
+ 555-555-555**5** [última atualização às **7h**]
A Resolução de identidade usa o nome, o sobrenome e o e-mail do perfil C porque eles têm os carimbos de data/hora mais recentes.
# Machine learning para Resolução de identidade no Amazon Connect
A Resolução de identidade no Amazon Connect encontra automaticamente perfis semelhantes e ajuda você a consolidá-los. Os tópicos desta seção descrevem como configurar a correspondência de machine learning para consolidar perfis duplicados como parte do processo de mesclagem automática.
**Topics**
+ [Como a Resolução de identidade de machine learning funciona](how-identity-resolution-works.md)
+ [Configurar machine learning para Resolução de identidade](setup-machine-learning-matching.md)
# Como a Resolução de identidade de machine learning funciona no Amazon Connect
Este tópico descreve como a Resolução de identidade executa a correspondência automática de perfis e, se configurada, como ela mescla automaticamente perfis semelhantes.
## Correspondência automática de perfis
Para identificar perfis semelhantes, a Resolução de identidade usa machine learning para analisar os seguintes atributos de informações de identificação pessoal (PII) em cada perfil:
+ Nome: todos os nomes são analisados quanto à semelhança, incluindo nome, segundo nome e sobrenome.
+ E-mail: todos os endereços de e-mail são analisados quanto à semelhança, incluindo e-mail pessoal e e-mail comercial. Não diferenciam letras maiúsculas de minúsculas.
+ Número de telefone: todos os números e formatos de telefone são analisados quanto à semelhança, incluindo telefone residencial, celular e telefone comercial.
+ Endereço: todos os tipos e formatos de endereço são analisados quanto à semelhança, incluindo endereço comercial, endereço para correspondência, endereço para entrega e endereço de cobrança.
+ Data de nascimento: todas as datas e formatos de nascimento são analisados para verificar a semelhança.
Ela usa essas informações para criar grupos de correspondência de perfis semelhantes.
### Grupos de correspondência
Um grupo de correspondência consiste em todos os perfis semelhantes que representam um cliente. Cada grupo de correspondência contém as seguintes informações:
+ Um ID de correspondência, que identifica de forma exclusiva o grupo de dois ou mais perfis semelhantes que representam um contato
+ O número do perfil IDs no grupo de partida
+ Uma pontuação de confiança associada ao grupo de correspondência
### Pontuações de confiança
Depois que o processo de correspondência automática for executado, você poderá consultar o bucket do S3 ou usar a [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API para filtrar os resultados com base nas pontuações de confiança. Por exemplo, é possível filtrar correspondências de alta confiança para uma análise mais aprofundada.
Uma pontuação de confiança é um número entre 0 e 1 que representa o nível de confiança da atribuição de perfis a um grupo de correspondência. Uma pontuação de 1 provavelmente indica uma correspondência exata.
## Mesclagem automática de perfis semelhantes
Depois que os perfis forem combinados, o trabalho da Resolução de identidade poderá mesclar perfis semelhantes com base em seus critérios. Se você excluir ou atualizar critérios, os critérios atualizados serão aplicados a perfis semelhantes na próxima execução.
**Importante**
Você não pode desfazer o processo de consolidação. É altamente recomendável usar a [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API para executar o processo de mesclagem automática antes de executar o Identity Resolution Job.
**nota**
Ao mesclar dois perfis, os campos de perfil preenchidos manualmente por meio de uma chamada de API ou do espaço de trabalho do atendente não serão substituídos por campos de perfil ingeridos automaticamente de uma integração ou mapeamento de tipo de objeto personalizado.
Por exemplo, suponha que um perfil seja criado manualmente com FirstName “John” por um agente no Espaço de trabalho do agente. Outro perfil é criado usando uma integração do S3 com FirstName “Peter”. Se esses perfis forem mesclados automaticamente, o FirstName “John” será preservado.
### Como funciona o processo de mesclagem automática
+ **Todos os atributos selecionados em um critério de consolidação são conectados a critérios `AND` com comparação exata de valores antes da mesclagem**.
+ Por exemplo, quando vários atributos são especificados nos critérios, como `email address` e `phone number`, todos os perfis semelhantes em um grupo de correspondência que têm exatamente o mesmo valor de `email address` e `phone number` são mesclados.
+ Se um ou mais dos perfis semelhantes em um grupo de correspondência tiverem um valor diferente ou um valor ausente para um ou mais dos atributos em um critério, os perfis semelhantes serão mesclados.
Por exemplo, um grupo de correspondência pode ter cinco perfis semelhantes, dos quais três perfis são consolidados, porque esses três perfis atendem aos critérios. Os outros dois perfis não são mesclados porque não atendem aos critérios.
+ **Vários critérios são avaliados na ordem de prioridade, começando com o Critério 1**.
+ A sequência na qual os critérios de consolidação são aplicados. Começa com o Critério 1 como a prioridade mais alta e o Critério 10 como a prioridade mais baixa.
+ Depois que o trabalho da Resolução de identidade aplica um critério, ele aplica os próximos critérios aos perfis consolidados e aos demais perfis semelhantes em um grupo de correspondência.
+ Você pode ter, no máximo, dez critérios de consolidação.
+ **Cada critério é executado de forma independente e opera um `OR` com outros critérios**.
+ Quando você tem vários critérios, cada critério é aplicado individualmente e na sequência de ordem de prioridade antes que o trabalho da Resolução de identidade passe para o próximo critério.
+ Todos os critérios são aplicados na sequência em que você os listou. Não importa se os critérios falham ou conseguem consolidar perfis semelhantes em um grupo de correspondência.
+ **Por padrão, os conflitos de perfil são gerenciados por recência.**
+ Quando dois ou mais perfis semelhantes em um grupo de correspondência atendem a um critério de consolidação, o perfil consolidado resultante é criado comparando cada valor dos atributos de perfis que constituem perfis semelhantes.
+ Cada atributo pode ter uma correspondência exata no valor. Nesse caso, qualquer valor pode ser selecionado para esse atributo.
+ Se houver um conflito entre valores de dois ou mais perfis similares constituintes, o atributo atualizado mais recentemente será escolhido.
Por exemplo, se Jane Doe tiver três valores diferentes no atributo `Address` dos perfis semelhantes do constituinte, a Resolução de identidade escolherá o endereço mais recente para criar o perfil unificado.
+ Por padrão, o **Carimbo de data e hora da última atualização** é usado para determinar o registro que foi atualizado mais recentemente.
+ **Os conflitos de perfil são gerenciados por tipo de objeto de origem e por recência.**
+ Você também pode alterar o comportamento padrão da resolução de conflitos para escolher um perfil de constituinte semelhante de uma fonte específica como fonte confiável para informar a resolução de conflitos.
+ Se quiser especificar uma fonte de dados a ser usada para conflitos de perfil, você poderá escolher um dos seus tipos de objeto como fonte de dados se selecionar **Origem com o último carimbo de data e hora atualizado**.
+ O registro atualizado mais recentemente do tipo de objeto especificado é usado para resolver conflitos de perfil.
+ **O carimbo de data/hora da última atualização identifica qual registro foi atualizado mais recentemente**.
+ O atributo de data/hora associado ao tipo de objeto do registro de origem é usado para identificar qual registro foi atualizado mais recentemente.
+ Se o atributo de data/hora não estiver disponível para o tipo de objeto, a data/hora no qual o registro foi ingerido em seu domínio do Customer Profiles será usada.
+ Se tiver tipos de objetos personalizados, você precisará adicionar registros de data e hora. Consulte [Data e hora ausentes para conflitos de perfil](create-consolidation-criteria.md#missing-timestamp-for-profile-conflicts) para obter mais informações.
+ **Consolidação é um processo unidirecional e não pode ser desfeita.**
+ Escolha seus critérios cuidadosamente antes de iniciar o processo de consolidação. Para obter mais informações, consulte [Dicas para criar critérios fortes](create-consolidation-criteria.md#tips-for-creating-consolidation-criteria).
+ Use a [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API para testar as configurações de mesclagem automática da sua Resolução de Identidade sem mesclar seus dados.
Para obter um exemplo que mostra como os critérios são aplicados, consulte[Exemplo: como os critérios de exemplo são aplicados](create-consolidation-criteria.md#criteria-examples).
# Configurar machine learning para Resolução de identidade no Amazon Connect
## Editar programação de execução de correspondências de machine learning
![\[Edite a programação de execução de correspondências de machine learning.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/machine-learning-ir-edit-run-schedule.png)
## Editar correspondências de mesclagem de machine learning
![\[Edite as correspondências de mesclagem de machine learning.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/machine-learning-ir-edit-merge-matches.png)
## Editar local da correspondência de machine learning
![\[Edite o local da correspondência de machine learning.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/machine-learning-ir-edit-match-location.png)
# Correspondência baseada em regras para Resolução de identidade no Amazon Connect
A Resolução de identidade no AC encontra automaticamente perfis semelhantes e ajuda você a consolidá-los. Os tópicos desta seção descrevem como configurar a Resolução de identidade baseada em regras para consolidar perfis duplicados como parte do processo de mesclagem automática.
**Topics**
+ [Como funciona a Resolução de identidade baseada em regras](how-rule-based-identity-resolution-works.md)
+ [Correspondência baseada em regras para Resolução de identidade](setup-rule-based-matching.md)
+ [Configurar regras de correspondência para Resolução de identidade](setup-matching-rule-examples.md)
# Como funciona a Resolução de identidade baseada em regras no Amazon Connect
Este tópico descreve como a Resolução de identidade baseada em regras executa a correspondência automática de perfis e como mescla automaticamente perfis semelhantes.
## Correspondência automática de perfis
Para identificar perfis semelhantes, a Resolução de identidade baseada em regras usa uma lista de [atributos de regra correspondentes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html) para comparar cada perfil. Até 15 MatchingRule atributos são suportados no [MatchingRules](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html#customerprofiles-Type-RuleBasedMatchingRequest-MatchingRules).
### Regras de correspondência
Veja a seguir uma lista dos [ MatchingRule](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html)atributos que podem ser usados. Você pode configurar até 15 níveis de regras de correspondência. Para cada regra de correspondência, você pode usar os seguintes atributos de informações de identificação pessoal (PII) em cada perfil:
+ **AccountNumber**
+ **Endereço.Endereço**: todos os endereços especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à semelhança, incluindo Endereço,,, e BusinessAddress MaillingAddress ShippingAddress
+ **Address.City**: todos os endereços especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à similaridade, incluindo Endereço,,, e BusinessAddress MaillingAddress ShippingAddress
+ **Endereço.País**: todos os endereços especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à semelhança, incluindo Endereço,,, e BusinessAddress MaillingAddress ShippingAddress
+ **Address.County**: todos os endereços especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à similaridade, incluindo Endereço,,, e BusinessAddress MaillingAddress ShippingAddress
+ **Endereço. PostalCode**: todos os endereços especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à semelhança, incluindo endereço,, BusinessAddress MaillingAddress, e ShippingAddress
+ **Address.State**: todos os endereços especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à similaridade, incluindo Endereço,,, e BusinessAddress MaillingAddress ShippingAddress
+ **Endereço.Província**: todos os endereços especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à semelhança, incluindo Endereço,,, e BusinessAddress MaillingAddress ShippingAddress
+ **PhoneNumber**: os números de telefone especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à semelhança PhoneNumber, incluindo HomePhoneNumber, e. MobilePhoneNumber
+ **EmailAddress**: todos os endereços de e-mail especificados no [Seletor de tipos de atributos](#rule-based-attribute-type-selector) são analisados quanto à similaridade, incluindo EmailAddress, BusinessEmailAddress, e PersonalEmailAddress
+ **BirthDate**
+ **BusinessName**
+ **FirstName**
+ **LastName**
+ **MiddleName**
+ **Gender**
+ **Qualquer atributo de perfil personalizado com o prefixo *Attributes***
As regras de correspondência são processadas por prioridade. Por exemplo, a primeira regra deve ser a regra mais otimizada que você deseja definir e deve ser usada para obter o resultado mais preciso.
### Seletor de tipos de atributos
O seletor de tipos de atributos contém informações de configuração vitais para a resolução de identidade baseada em regras, facilitando a correspondência de perfis. Isso permite que você ajuste a comparação de perfis entre os tipos de atributos e selecione os principais atributos para correspondência em cada tipo. Dentro desse recurso, você tem a flexibilidade de configurar três tipos de atributos distintos, permitindo um controle preciso sobre o processo de correspondência.
+ **Tipo Email**
+ Você pode escolher entre EmailAddress, BusinessEmailAddress, e PersonalEmailAddress
+ **PhoneNumber tipo**
+ Você pode escolher entre PhoneNumberNumber, HomePhoneNumber, e MobilePhoneNumber
+ **Tipo Address**
+ Você pode escolher entre Endereço, BusinessAddress, MaillingAddress, e ShippingAddress
Você pode escolher `ONE_TO_ONE` ou `MANY_TO_MANY` como AttributeMatchingModel o. Ao escolher `MANY_TO_MANY`, o sistema pode combinar atributos entre os subtipos de um tipo de atributo. Por exemplo, se o valor do EmailAddress campo do Perfil A e o valor do BusinessEmailAddress campo do Perfil B corresponderem, os dois perfis serão correspondidos no EmailAddress tipo. Ao escolher `ONE_TO_ONE`, o sistema só poderá comparar se os subtipos forem iguais. Por exemplo, somente quando o valor do EmailAddress campo do Perfil A e o valor do EmailAddress campo do Perfil B coincidem, os dois perfis são correspondidos no EmailAddress tipo.
**Nível máximo de regra permitido para correspondência**
Você pode configurar o nível máximo de regra que deseja usar para corresponder a perfis semelhantes. Por exemplo, se seu nível máximo de regra permitido para correspondência for 5, o sistema não encontrará perfis semelhantes usando o nível de regra 6.
### Grupos de correspondência
Um grupo de correspondência consiste em todos os perfis semelhantes que representam um cliente. Cada grupo de correspondência contém as seguintes informações:
+ Um ID de correspondência, que identifica de forma exclusiva o grupo de dois ou mais perfis semelhantes que representam um contato
+ O número do perfil IDs no grupo de partida
### Status da correspondência
+ **PENDING (PENDENTES)**
O primeiro status após a configuração de uma regra de correspondência baseada em regras. Se for um domínio existente, a Resolução de identidade baseada em regras vai aguardar uma hora para criar a regra de correspondência. Se for um novo domínio, o sistema vai ignorar o estágio **PENDENTE**.
+ **IN\$1PROGRESS**
O sistema está criando a regra de correspondência baseada em regras. Nesse status, o sistema está avaliando os dados existentes e você não pode mais alterar a configuração de correspondência baseada em regras.
+ **ACTIVE**
A regra está pronta para uso. Você poderá alterar a regra um dia depois do status estar no estado **ACTIVE**.
### Como funciona o processo de correspondência automática
Depois de criar um novo domínio do Amazon Connect Customer Profiles com a regra de correspondência baseada em regras, a Resolução de identidade baseada em regras vai comparar perfis semelhantes com base na regra que você especificou durante a ingestão dos perfis. Se você atualizar a configuração da correspondência baseada em regras, o Customer Profiles começará a reavaliar os perfis em seu domínio usando a nova configuração em uma hora.
Se você estiver habilitando a correspondência baseada em regras com um domínio existente, o sistema passará para um estado **PENDING** e começará a avaliar os perfis existentes em seu domínio usando a nova configuração em uma hora. O tempo necessário para concluir a avaliação dos perfis depende de quantos perfis existem.
+ **Por padrão, a regra padrão será aplicada se nenhuma regra personalizada for especificada.**
+ O Amazon Connect Customer Profiles fornecerá uma regra de correspondência padrão se você não fornecer uma regra de correspondência personalizada. Você pode verificar a regra de correspondência personalizada aqui.
+ **Todos os registros passarão pelas regras de correspondência baseadas em regras.**
+ O sistema avalia cada nível de regra de correspondência até que uma correspondência seja identificada ou até que o nível máximo de regra permitido para correspondência seja atingido. O processo de avaliação começa na regra de nível 1, onde o registro é analisado. Se nenhum grupo correspondente for descoberto, o sistema continuará avaliando os níveis de regras subsequentes, procurando por um grupo de correspondência até que uma correspondência seja encontrada ou o nível máximo permitido de regras para correspondência seja atingido.
+ **Todos os atributos em um único nível de regra de correspondência são conectados usando uma relação *AND***
+ Quando vários atributos estão presentes em um único nível de regra, eles são interconectados por uma relação AND. Durante a correspondência de perfis, todos os valores de atributos devem estar alinhados para que os perfis sejam atribuídos ao mesmo grupo de correspondência. Por exemplo, somente quando os valores de todos os atributos são idênticos, os perfis são considerados como correspondências e agrupados para processamento posterior.
+ **Todos os atributos em um seletor de tipo de atributo estão conectados a um relacionamento *OR***
+ Durante a especificação de atributos no seletor de tipo de atributo, atributos do mesmo tipo são vinculados por meio de uma relação OR. Por exemplo, considere o PhoneNumber tipo em que HomePhoneNumber e BusinessPhoneNumber são usados. Nesse cenário, dois perfis podem ser combinados se estiverem alinhados HomePhoneNumber ou se estiverem BusinessPhoneNumber alinhados. Consequentemente, o processo de correspondência permite correspondências flexíveis com base em números de telefone residenciais ou comerciais.
+ **O resultado da correspondência acaba sendo otimizado.**
+ Devido à natureza quase em tempo real da correspondência de perfis no sistema, existe a possibilidade de que um grupo de correspondência para seu perfil possa ser encontrado em um nível de regra inferior (menos otimizado). No entanto, se uma correspondência estiver disponível em um nível de regra mais alto (mais otimizado), o sistema atribuirá o perfil a esse grupo específico.
**nota**
Quando a Resolução de identidade realiza a correspondência baseada em regras, a ordem na qual as regras que você configurou serão processadas depende de como os dados são ingeridos. Por exemplo, se você configurar as regras 1 e 2, a regra 2 poderá ser processada antes da regra 1. A ordem de processamento pode mudar, mas o resultado final será sempre o mesmo.
## Mesclagem automática de perfis semelhantes
Após a correspondência dos perfis, o Identity Resolution Job pode, opcionalmente, mesclar perfis semelhantes com base no [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)que você especificou na configuração de correspondência baseada em regras.
**Importante**
Você não pode desfazer o processo de consolidação. É recomendável ativar a correspondência apenas primeiro para avaliar o resultado da partida usando o ListMatches GetSimiliarProfiles APIs e. Você pode ativar a mesclagem configurando o [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)usando a [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API.
**nota**
Ao mesclar dois perfis, os campos de perfil preenchidos manualmente por meio de uma chamada de API ou do espaço de trabalho do atendente não serão substituídos por campos de perfil ingeridos automaticamente de uma integração ou mapeamento de tipo de objeto personalizado.
Por exemplo, suponha que um perfil seja criado manualmente com FirstName “John” por um agente no Espaço de trabalho do agente. Outro perfil é criado usando uma integração do S3 com FirstName “Peter”. Se esses perfis forem mesclados automaticamente, o FirstName “John” será preservado.
# Configurar a correspondência baseada em regras para Resolução de identidade no Amazon Connect
Este tópico fornece um passo a passo ilustrativo das etapas que você pode usar para editar tipos de atributos de correspondência baseada em regras, regras de correspondência baseada em regras, regras de mesclagem de correspondência baseada em regras e locais de correspondência baseada em regras. Ele também mostra como redefinir regras de correspondência baseada em regras.
## Editar tipos de atributos de correspondência baseada em regras
![\[Edite tipos de atributos de correspondência baseada em regras.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/rule-based-edit-attribute-types.png)
## Editar regras de correspondência baseada em regras
![\[Edite regras de correspondência baseada em regras.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/rule-based-edit-matching-rules.png)
## Redefinir regras de correspondência baseada em regras
![\[Redefina regras de correspondência baseada em regras.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/rule-based-edit-reset-rules.png)
## Editar regras de mesclagem baseada em regras
![\[Editar regras de mesclagem baseada em regras\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/rule-based-edit-merge-rules.png)
## Editar local da correspondência baseada em regras
![\[Edite local da correspondência baseada em regras.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/rule-based-match-location.png)
# Configurar regras de correspondência para Resolução de identidade no Amazon Connect
## Limites
Você pode selecionar qualquer atributo do perfil padrão para comparar perfis semelhantes. Por exemplo, você pode escolher número de telefone, endereço de e-mail e nome, além de atributos personalizados.
Você pode criar uma regra de correspondência baseada em regras com as seguintes limitações:
+ 15 níveis de regras
+ Cada nível de regra pode conter até 15 atributos de perfil
## Dicas
Para melhorar a segmentação de perfis exclusivos e evitar a consolidação de perfis que não sejam duplicados, as seguintes dicas são recomendadas:
+ Inclua pelo menos um atributo de alta cardinalidade que possa identificar um cliente de forma exclusiva e que provavelmente não seja o mesmo para todos os clientes, como um número de telefone, endereço de e-mail ou número de conta.
+ Evite usar atributos de perfil que possam pertencer a identidades diferentes sem um atributo de alta cardinalidade.
+ **Número de telefone** com **Nome**, **Sobrenome** é uma regra mais forte do que a combinação de **Nome** e **Sobrenome** apenas.
+ Se, em um nível de regra, todos os atributos de perfil dessa regra forem atributos de baixa cardinalidade (o atributo que pode pertencer a mais de 500 perfis diferentes), o Customer Profiles não tentará comparar o perfil. Você receberá a seguinte mensagem SQS em seu DLQ se configurar uma durante a criação do domínio:
+ Todos os atributos no nível de regra x estão associados a mais de 500 registros.
+ Sempre ative a **Partida apenas** primeiro, verifique os resultados da partida e ative a fusão apenas definindo **MaxAllowedRuleLevelForMerging**se você estiver satisfeito com os resultados da partida.
## Resolver conflitos de perfil para mesclagem de perfis
Você pode definir qual registro usar quando o valor de um atributo de dois ou mais perfis semelhantes for diferente, como registros de endereço conflitantes.
**Use o carimbo de data e hora atualizado mais recentemente**
Por padrão, os conflitos de perfil são gerenciados por recência. Quando houver um conflito entre valores de dois ou mais perfis similares, o atributo atualizado mais recentemente será escolhido.
**Use a fonte com o carimbo de data e hora atualizado mais recentemente**
Permite priorizar registros de um tipo de objeto específico como fonte de dados para gerenciar conflitos de perfil. Quando houver um conflito entre valores de dois ou mais perfis similares, o atributo atualizado mais recentemente do tipo de objeto especificado será escolhido.
Se um carimbo de data/hora não for especificado em seu tipo de objeto, a data em que o registro foi inserido no Customer Profiles será usada. A fonte com o carimbo de data/hora da última atualização não está disponível quando você não tem nenhuma integração configurada. Quando você adiciona uma integração, seus tipos de objeto estarão disponíveis como fonte para essa opção.
## Data e hora ausentes para conflitos de perfil
A mensagem Data e hora ausentes será exibida se você tiver mapeamentos de tipo de objeto personalizados.
Use a [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API para adicionar os seguintes novos atributos ao seu tipo de objeto personalizado:
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
Se o atributo de carimbo de data/hora não for especificado, você poderá continuar criando critérios de consolidação. No entanto, será usado um carimbo de data e hora padrão de quando os registros foram ingeridos no Customer Profiles. É recomendável adicionar os novos atributos antes de criar seus critérios de consolidação.
Se você já tiver definido um tipo de objeto personalizado e quiser atualizar seu tipo de objeto personalizado, executaremos um preenchimento programado toda semana para atualizar os perfis existentes com o `Fields.sourceLastUpdatedTimestamp`. Para optar pelo preenchimento programado, use as seguintes etapas:
1. Atualize seu tipo de objeto de perfil personalizado usando a [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
1. Depois de atualizar seu tipo de objeto de perfil personalizado, abra um [tíquete do AWS Support](https://console.aws.amazon.com/support/home).
1. AWS agendará o preenchimento em seu nome. O preenchimento programado vai até o final de fevereiro de 2022.
Como alternativa, você pode excluir e recriar a ingestão/conector que você tem para seu domínio que usa o tipo de objeto personalizado. Todos os seus dados serão ingeridos novamente usando seu tipo de objeto atualizado, e `Fields.sourceLastUpdatedTimestamp` será analisado a partir dele.
## Exemplo: como funciona a correspondência
### Exemplo de ONE\$1TO\$1ONE
Você pode escolher `ONE_TO_ONE` como o `AttributeMatchingModel`. Ao escolher `ONE_TO_ONE`, o sistema só poderá comparar se os subtipos forem iguais.
**Por exemplo**:
Você está usando `EmailAddress` e `BusinessEmailAddress` para representar os tipos `EmailAddress`. O `AttributeMatchingModel` é `ONE_TO_ONE`.
**Sua regra de correspondência é**:
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
O Perfil A e o Perfil B coincidem no nível de regra 1, pois o tipo `EmailAddress`, `LastName` e `FirstName` coincidem.
### Exemplo de MANY\$1TO\$1MANY
Você pode escolher `MANY_TO_MANY` como o `AttributeMatchingModel`. Ao escolher `MANY_TO_MANY`, o sistema pode combinar atributos entre os subtipos de um tipo de atributo.
**Por exemplo**:
Você está usando `EmailAddress` e `BusinessEmailAddress` para representar os tipos `EmailAddress`. O `AttributeMatchingModel` é `MANY_TO_MANY`.
**Sua regra de correspondência é**:
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com (match with Profile B’s BusinessEmailAddress)
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: 1@email.com (match with Profile A's EmailAddress)
LastName: Doe
FirstName: John
AccountNumber: account1234
```
O Perfil A e o Perfil B coincidem no nível de regra 1, pois o tipo `EmailAddress`, `LastName` e `FirstName` coincidem.
# Ver métricas de Resolução de identidade no Amazon Connect Customer Profiles
Sempre que a Resolução de identidade combina ou mescla perfis, as métricas sobre o processo são exibidas no painel do Customer Profiles. Você pode revisar a métrica da semana passada na página de resumo **Resolução de identidade**.
As métricas a seguir são geradas sempre que o trabalho da Resolução de identidade é executado:
+ **Grupos de correspondência encontrados**: o número de grupos de correspondência encontrados.
+ Disponível para Resolução de identidade baseada em ML e baseada em regras.
+ **Perfis mesclados**: o número de perfis que foram mesclados.
+ Disponível para Resolução de identidade baseada em ML e baseada em regras.
+ **Grupo de correspondência por regra**: o número de grupos de correspondência que foram criados por nível de regra.
+ Disponível somente para Resolução de identidade baseada em regras.
![\[A página Amazon Connect Customer Profiles, o botão Habilitar Identity Resolution (Resolução de identidade).\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ir-metrics-example-1.png)
![\[A página Amazon Connect Customer Profiles, o botão Habilitar Identity Resolution (Resolução de identidade).\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Desabilitar a Resolução de identidade no Amazon Connect Customer Profiles
## Desativar a correspondência baseada em machine learning
Você poderá desativar a correspondência baseada em machine learning quando não quiser mais que ela encontre automaticamente perfis semelhantes. Se você tiver critérios de consolidação, todos os seus critérios serão excluídos e seus perfis não serão mais consolidados automaticamente. Os perfis que já foram consolidados permanecerão consolidados.
## Desativar a correspondência baseada em regras
Você poderá desativar a correspondência baseada em regras quando não quiser mais que ela encontre automaticamente perfis semelhantes. Se você tiver uma regra de correspondência personalizada, a regra de correspondência será excluída e seus perfis não serão mais consolidados automaticamente. Os perfis que já foram consolidados permanecerão consolidados.
# Resolução com a AWS Entity Resolution
O Amazon Connect Customer Profiles oferece um *conector gerenciado* que permite importar diretamente os resultados correspondentes do AWS Entity Resolution. Essa integração permite que você aproveite os poderosos recursos de correspondência do AWS Entity Resolution e, ao mesmo tempo, mantenha seus perfis de clientes no Amazon Connect.
O AWS Entity Resolution ajuda você a combinar e vincular registros relacionados em suas várias fontes de dados usando técnicas flexíveis de correspondência, incluindo regras, aprendizado de máquina ou provedores de dados terceirizados. Ao conectar os resultados da Resolução de Entidades aos Perfis do Cliente, você pode:
+ Consolide os registros de clientes de vários sistemas com mais precisão
+ Aplique uma lógica de correspondência sofisticada com base em suas necessidades comerciais específicas
+ Melhore os perfis dos clientes com dados vinculados de vários aplicativos e canais
+ Mantenha visões consistentes dos clientes em toda a sua organização
Para começar a usar a Resolução de Entidades da AWS com Perfis de Clientes, você precisará primeiro configurar seus fluxos de trabalho correspondentes no console da Resolução de Entidades da AWS. [Saiba mais sobre a resolução de entidades da AWS](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow.html).
Para configurar isso, você precisa dos seguintes pré-requisitos:
+ Instância ativa do Amazon Connect com perfis de clientes ativados
+ Dados do cliente armazenados no Amazon S3
+ Permissões apropriadas do IAM para acessar a resolução de entidades da AWS
**Para configurar, siga estas etapas:**
1. Crie um domínio de perfis de clientes
+ Se você ainda não o fez, crie um domínio Customer Profiles na sua instância Connect
+ Navegue até a seção Perfis de clientes no console do Amazon Connect
+ Observação: você verá uma nova seção para a resolução de entidades da AWS após a criação do domínio
1. Configurar a resolução de entidades da AWS
+ No seu domínio Customer Profiles, localize a seção Resolução de entidades da AWS
+ Clique em “Configurar resolução de entidades da AWS”
+ Você será redirecionado para o console de resolução de entidades da AWS.
+ Crie um fluxo de trabalho correspondente
+ Configure suas fontes de dados do S3
+ Definir critérios de correspondência
+ Revise e ative seu fluxo de trabalho correspondente
1. Conecte os resultados da Resolução de Entidades aos Perfis do Cliente
+ Retorne ao seu domínio Customer Profiles
+ Selecione seu fluxo de trabalho de resolução de entidades
+ Configure como os registros correspondentes devem ser consolidados
+ Habilite a integração
# Integrar aplicações externas ao Amazon Connect Customer Profiles
O Amazon Connect fornece um conjunto de integrações pré-criadas com tecnologia da Amazon e da AppFlow Amazon. EventBridge Depois de ativar o Amazon Connect Customer Profiles, você poderá usar essas integrações para combinar informações de aplicações externas, como Salesforce ou Zendesk, com o histórico de contatos do Amazon Connect. Isso cria um perfil de cliente com todas as informações de que os atendentes precisam durante as interações com o cliente em um único lugar.
Você também pode usar perfis de clientes na Amazon AppFlow. A Amazon AppFlow oferece suporte `CustomerProfiles` como destino. Você pode usar AppFlow APIs a Amazon para enviar dados para perfis de clientes usando `CustomerProfiles` como nome do destino.
Antes de começar, certifique-se de que esteja usando uma chave gerenciada pelo cliente. Para obter mais informações sobre como configurar chaves do KMS, consulte [Criar uma chave KMS para ser usada pelo Customer Profiles para criptografar dados (obrigatório)](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey).
## Configurar integrações
Você pode configurar uma integração usando aplicativos em destaque no Amazon Connect ou aplicativos externos usando a Amazon, AppFlow escolhendo o método que melhor se adequa ao seu caso de uso abaixo. Para obter informações mais detalhadas sobre a integração do ServiceNow Amazon Connect com o Slack, consulte a postagem do blog [Combine dados de várias fontes usando a Amazon AppFlow e crie um perfil unificado de cliente do Amazon Connect para agentes da central de atendimento](https://aws.amazon.com/blogs/contact-center/unified-customer-data/).
**Topics**
+ [Configurar integrações](#setup-integrations-title-menu)
+ [Configurar a integração para aplicações em destaque no Amazon Connect](integrate-customer-profiles-appflow.md)
+ [Configure a integração para aplicativos externos usando a Amazon AppFlow](integrate-external-applications-appflow.md)
+ [
# Excluir o Customer Profiles ou interromper integrações
](delete-customer-profile-connection.md)
# Configurar a integração para aplicações em destaque no Amazon Connect
Essas integrações usam as aplicações em destaque do Amazon Connect para fornecer atualizações periódicas para o Amazon Connect Customer Profiles.
## Antes de começar
### Ingestão de dados em massa
Ao configurar sua integração, você deverá inserir uma data até a qual deseja ir para ingerir dados. Se você escolher uma data que seja há mais de dois meses, o Customer Profiles ativará automaticamente a ingestão em massa criando vários fluxos. Ele faz isso para que você não precise calcular quantos fluxos são necessários para ingerir dados.
Quando a ingestão automática em massa está ativada, o Customer Profiles faz o seguinte:
+ Define o tamanho do lote como dois meses.
+ Tenta novamente em caso de falhas transitórias até três vezes antes de falhar.
Você pode usar a [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API para chamar seu próprio tamanho de lote.
### Por que preciso selecionar ou criar uma função do IAM?
Para Salesforce, Marketo e Customer Profiles ServiceNow, ajuda a melhorar a ingestão histórica dessas fontes usando sua função do IAM para criar vários fluxos de trabalho para ingerir seus dados com rapidez e eficiência.
Para essas fontes, se selecionar mais de 60 dias atrás no seletor **Data para a importação de registros**, você precisará criar uma nova função do IAM ou selecionar uma existente. Essa função permite que o Customer Profiles gerencie sua integração. Ela fornece ao Customer Profiles as permissões necessárias para atualizar e criar um fluxo de trabalho para ingerir seus dados. Depois que o fluxo de trabalho é concluído, o Customer Profiles cria uma integração padrão e contínua que ingere seus novos dados à medida que são atualizados em sua fonte.
A função criada no console só pode ser usada pelo domínio em que foi criada. Isso ocorre porque o Amazon Connect limita o acesso da função somente à chave do KMS usada pelo domínio.
Para obter mais informações, consulte [Conceder acesso de privilégio mínimo ao perfil de execução do Customer Profiles](#grant-least-privilege-cp).
## Conceder acesso de privilégio mínimo ao perfil de execução do Customer Profiles
Se você quiser criar sua própria função do IAM, será recomendável usar as permissões mostradas no código a seguir para limitar a função ao mínimo de permissões necessárias. Use o trecho abaixo para criar sua função manualmente. Use sua própria chave do KMS e especifique sua região quando necessário.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:CreateFlow",
"appflow:TagResource",
"profile:TagResource",
"profile:PutIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "CreateFlowResources"
},
{
"Action": [
"appflow:UseConnectorProfile"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "UseConnectorResources"
},
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:DeleteFlow",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow",
"profile:DeleteIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "AccessFlowResources"
},
{
"Action": [
"kms:CreateGrant",
"kms:ListGrants"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"appflow.us-east-1.amazonaws.com"
]
}
},
"Effect": "Allow",
"Sid": "KMSAppflow"
},
{
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"profile.us-east-1.amazonaws.com"
]
},
"ForAllValues:StringEquals": {
"kms:GrantOperations": [
"Decrypt"
]
}
},
"Effect": "Allow",
"Sid": "KMSCustomerProfiles"
}
]
}
```
------
## Monitorar suas integrações do Customer Profiles
Depois que sua conexão for estabelecida, se ela parar de funcionar, exclua a integração e a restabeleça.
## O que fazer se os objetos não estiverem sendo enviados
Se um objeto não for enviado, escolha **Detalhes do fluxo** para saber mais sobre o que deu errado.
Talvez seja necessário excluir a configuração e se reconectar à aplicação externa.
# Configurar a integração dos Chamados do Amazon Connect
Para atualizar seus dados de Amazon Connect casos nos perfis de clientes do Amazon Connect e usar recursos como atributos calculados, você pode integrar usando a Amazon AppIntegrations. Comece configurando um stream de eventos de Cases para enviar campos do sistema para um EventBridge ônibus e, em seguida, use AppIntegrations a Amazon para encaminhar esses eventos aos perfis de clientes.
## Transmitir dados da funcionalidade Chamados do Amazon Connect ao EventBridge
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
![\[O alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. No painel de navegação, escolha **Casos** e anote o ID de domínio da funcionalidade Chamados na seção **Detalhes do domínio**.
![\[A página Casos, a seção Detalhes do domínio e uma seta apontando para o ID do domínio.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. Usando o AWS CLI, crie uma configuração de evento de caso para enviar eventos de casos Conta da AWS do Amazon Connect para o seu ônibus Event Bridge padrão.
```
// set up Case Event Configuration including all system fields
aws connectcases put-case-event-configuration --domain-id --region --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"summary\"
},
{
\"id\": \"reference_number\"
},
{
\"id\": \"created_datetime\"
},
{
\"id\": \"last_updated_datetime\"
},
{
\"id\": \"last_closed_datetime\"
},
{
\"id\": \"customer_id\"
}
]
}
}
}"
```
1. Abra o console do Event Bridge AWS da sua região. Por exemplo, [https://us-west-2.console.aws.amazon.com/events/em casa? region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. Selecione **Create event bus (Criar barramento de eventos)**.
![\[A página de ônibus de eventos no EventBridge console da Amazon, o botão Criar barramento de eventos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. Crie um barramento de eventos com o nome `connect-cases-to-customer-profiles`.
![\[A página Criar barramento de eventos e a caixa Nome.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. Volte ao **barramento de eventos padrão** e crie uma regra chamada `connect-cases-to-customer-profiles-rule`.
![\[A barramento de eventos padrão e o botão Criar regra.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[A etapa Criar padrão de eventos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Trecho do Padrão de evento:
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[A seção Método de criação, a opção Padrão personalizado (editor JSON) e o código de padrão de evento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ Escolha **Ir para Analisar e criar** e depois **Criar regra**.
![\[O botão Ir para Revisar e criar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## Ingira dados de casos do Event Bridge em perfis de clientes usando AppIntegrations
1. Usando o AWS CLI, crie uma integração de eventos com AppIntegrations e registre a saída do ARN. Isso representa uma fonte de dados que uma instância do Amazon Connect pode usar.
```
aws appintegrations create-event-integration --region
--name Connect-Cases-Event-Integration
--event-bridge-bus connect-cases-to-customer-profiles --event-filter
"{\"Source\": \"aws.cases\" }"
--description "Event Integration for Cases Event Bus"
```
1. Usando o AWS CLI, crie uma integração com perfis de clientes usando a API put-integration. Isso iniciará o fluxo de dados para o Customer Profiles, substituindo os valores do espaço reservado pelo ARN de integração de eventos e pelo nome de domínio do perfil domínio cliente.
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Verificar a integração dos Chamados
1. Crie um caso nos Chamados do Amazon Connect.
1. A entrega do evento deve ser quase instantânea, mas aguarde um minuto para que ela seja concluída e associada a um perfil de cliente.
1. Usando o AWS CLI, localize o objeto Connect-case abaixo do perfil, substituindo os espaços reservados pelos valores corretos.
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. Se você não encontrar um item na resposta da chamada de API acima, há um problema com a integração. Para solucionar problemas:
1. Acesse o EventBridge console da Amazon.
1. Verifique se EventSource está ativo e se a correspondência EventBus existe e está em execução.
1. Verifique se a configuração do evento de caso está configurada corretamente.
1. Se estiverem funcionando, entre em contato Suporte para obter ajuda na investigação do problema.
# Configurar a integração do Amazon Connect com Salesforce ServiceNow, Marketo ou Zendesk
Para fornecer atualizações periódicas aos perfis de clientes do Amazon Connect, você pode fazer a integração com o Salesforce ServiceNow, o Marketo ou o Zendesk usando a Amazon. AppFlow Primeiro, você configura a conexão no Amazon Connect e na aplicação de sua escolha e, em seguida, verifica a integração.
## Configure a conexão no Amazon Connect e no Salesforce ServiceNow, Marketo ou Zendesk
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)
1. No painel de navegação, escolha **Perfis de clientes**.
1. Na página **Configuração dos perfis do cliente**, escolha **Adicionar integração**, conforme mostrado na imagem a seguir.
![\[A página Configuração dos perfis do cliente, o botão Adicionar integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Na página **Selecionar fonte de dados**, escolha de qual aplicação externa você deseja obter dados de perfis de clientes. Você pode visualizar os [requisitos de integração](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) para entender melhor os requisitos de conexão necessários para sua aplicação.
![\[A página Selecionar fonte de dados\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. Na página **Estabelecer conexão**, escolha uma das seguintes opções:
+ **Use a conexão existente**: Isso permite que você reutilize AppFlow os recursos existentes da Amazon que você possa ter criado em sua conta da AWS.
+ **Criar nova conexão**: insira as informações exigidas pela aplicação externa.
![\[A página Estabelecer conexão.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. Na página de **Opções de integração**, escolha quais objetos de origem você deseja ingerir e selecione o tipo de objeto.
Os tipos de objeto armazenam seus dados ingeridos. Eles também definem como os objetos de suas integrações são mapeados para os perfis quando são ingeridos. O Customer Profiles fornece modelos de tipo de objeto padrão que você pode usar para definir como os atributos em seus objetos de origem são mapeados para os objetos padrão nos Customer Profiles. Você também pode usar os mapeamentos de objetos que você criou a partir do. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) Ao adicionar ou criar a integração do Salesforce para o mapeamento de dados criado pelo usuário, você precisa especificar o mapeamento de dados específico; caso contrário, ele escolherá o mapeamento de dados padrão do Salesforce para o tipo de objeto. Você pode criar seu mapeamento de dados e usá-lo ao configurar um conector de dados em destaque.
![\[A página Opções de integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. Para a **Data de início da ingestão**, o Customer Profiles começa a ingerir registros criados após essa data. Por padrão, a data para importação de registros é definida como 30 dias antes.
1. Na página **Analisar e integrar**, verifique se o **Status da conexão** é **Conectado** e escolha **Criar integração**.
![\[A página Analisar e integrar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. Depois que a integração estiver configurada, de volta à página **Configuração dos perfis de clientes**, escolha **Visualizar objetos** para ver quais dados estão sendo agrupados e enviados. Atualmente, esse processo ingere registros que foram criados ou modificados nos últimos 30 dias.
![\[A página Configuração dos perfis do cliente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Configurar a integração para o Segment para fornecer atualizações periódicas ao Amazon Connect Customer Profiles
Para fornecer atualizações periódicas aos perfis de clientes do Amazon Connect, você pode fazer a integração com o Segment usando a Amazon AppFlow. Primeiro, você configura a conexão no Amazon Connect e no Segment e, em seguida, verifica a integração.
## Configurar a conexão no Amazon Connect e no Segment
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)
1. No painel de navegação, escolha **Perfis de clientes**.
1. Na página **Configuração dos perfis do cliente**, escolha **Adicionar integração**.
![\[A página Configuração dos perfis do cliente, botão Adicionar integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Na página **Selecionar fonte de dados**, escolha **Segmento**. Analise os requisitos da aplicação listados na página **Selecionar aplicação**.
![\[A página Selecionar fonte de dados\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. Na página **Estabelecer conexão**, escolha uma das seguintes opções:
+ **Use a conexão existente**: Isso permite que você reutilize os EventBridge recursos existentes da Amazon que você possa ter criado no seu Conta da AWS.
+ **Criar nova conexão**: insira as informações exigidas pela aplicação externa.
![\[A página Estabelecer conexão.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **Nome da conexão**: forneça um nome para a conexão. O nome da conexão é referenciado pelas integrações que usam essa conexão.
+ **URL da conexão**: insira o URL de conexão da aplicação. Esse URL é usado para criar links diretos para os objetos criados na aplicação externa. O URL de conexão é o URL do espaço de trabalho do segmento disponível no site da aplicação.
Para encontrar o URL do seu espaço de trabalho:
1. Faça login na sua conta segment.com.
1. Vá para **Configurações**, **Configurações gerais**.
1. Copie o URL do navegador.
1. O Customer Profiles usa a Amazon EventBridge para integrações com o Segment. Na página de **configuração da fonte**, copie seu Conta da AWS ID para a área de transferência e escolha **Login to Segment para** configurar a Amazon. EventBridge
1. Use as instruções a seguir para configurar o Segment:
1. Faça login no Segment.
1. Em seu aplicativo, selecione uma fonte para configurar o destino para a Amazon EventBridge.
1. Cole seu Conta da AWS ID e selecione sua AWS região.
1. Selecione **Ativado** para ligar a fonte de eventos do seu parceiro.
1. Vá até o **Testador de eventos** e envie um evento de teste para concluir a ativação da fonte de eventos do seu parceiro.
1. **ID do cliente**: é uma string que distingue de forma exclusiva o cliente em sua aplicação externa. Esse ID do cliente é o nome da fonte disponível no site da aplicação. Você usa o ID especificado para identificar o cliente do qual deseja que o Customer Profiles consuma seus objetos.
Como localizar seu ID de origem:
1. Vá para **Fontes** e escolha uma fonte.
1. Vá para **Configurações**, **Chaves de API**.
1. Copie seu **ID de origem**.
Depois de configurar o destino da origem do evento, retorne ao console do Customer Profiles e cole o ID do cliente.
1. Você verá um alerta indicando que o Amazon Connect se conectou com sucesso ao Segment.
1. Na página de **Opções de integração**, escolha quais objetos de origem você deseja ingerir e selecione o tipo de objeto.
Os tipos de objeto armazenam seus dados ingeridos. Eles também definem como os objetos de suas integrações são mapeados para os perfis quando são ingeridos. O Customer Profiles fornece modelos de tipo de objeto padrão que você pode usar para definir como os atributos em seus objetos de origem são mapeados para os objetos padrão nos Customer Profiles. Você também pode usar os mapeamentos de objetos que você criou a partir do. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[A página Opções de integração, a seção Tipo de objeto.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. Para a **Data de início da ingestão**, o Customer Profiles começará a ingerir registros criados depois que a integração for adicionada.
**nota**
Se precisar de registros históricos, você poderá [usar o Amazon S3 como fonte de integração para importá-los](customer-profiles-object-type-mappings.md).
1. Na página **Analisar e integrar**, verifique se o **Status da conexão** é **Conectado** e escolha **Adicionar integração**.
1. Depois que a integração for configurada, de volta à página **Configuração dos perfis do cliente**, a página **Integrações** exibirá quais integrações estão atualmente configuradas. **Última execução** e **Integridade da integração** não estão atualmente disponíveis para esse tipo de integração.
![\[A página Configuração dos perfis do cliente, a seção Integrações.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Para ver quais dados estão sendo enviados, escolha a integração e, em seguida, escolha **Visualizar objetos**.
## Verifique a integração do Segment
Para executar esta etapa, você precisa dos seguintes pré-requisitos:
+ Acesso ao seu espaço de trabalho do Segment.
+ [Acesso ao Painel de Controle de Contatos do Amazon Connect](amazon-connect-contact-control-panel.md).
**Para verificar a integração do Segment**
1. Acesse o painel do seu espaço de trabalho do Segment e escolha **Destinos**.
![\[A página de visão geral do Segment.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. Você verá uma lista de destinos para os quais o Segment envia dados. Escolha o EventBridge destino para os perfis de clientes.
![\[A página da lista de destinos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. Escolha a guia **Testador de eventos**. Nessa página, você enviará um evento de teste para Customer Profiles. O evento é ingerido e transformado em um perfil de cliente que você pode visualizar na aplicação do atendente Amazon Connect.
![\[A guia do testador de eventos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. Selecione **Identificar** como o tipo de evento e selecione **Criador de eventos** como seu método de entrada.
1. Você pode especificar um **ID de usuário** e algumas características. Os atendentes podem pesquisar essas características na aplicação.
1. Escolha **Enviar evento**.
1. A entrega do evento deve ser quase instantânea, mas aguarde um minuto para que seja entregue e crie um perfil de cliente.
1. Abra a aplicação de atendente Amazon Connect. Pesquise o ID de usuário que você inseriu no **Criador de eventos**. Você deve ser capaz de ver o perfil do cliente com o ID do usuário e as características que inseriu.
1. Se você não consegue ver o perfil do cliente, há um problema com sua integração. Para solucionar problemas:
1. Acesse o EventBridge console da Amazon.
1. Verifique se EventSource está ativo e se a correspondência EventBus existe e está em execução.
Se estiverem funcionando, entre em contato Suporte para obter ajuda na investigação do problema.
## Monitorar suas integrações do Customer Profiles
Depois que sua conexão for estabelecida, se ela parar de funcionar, exclua a integração e a restabeleça.
## O que fazer se os objetos não estiverem sendo enviados
Se um objeto não for enviado, escolha **Detalhes do fluxo** para saber mais sobre o que deu errado.
Talvez seja necessário excluir a configuração e se reconectar à aplicação externa.
# Configurar a integração para a Shopify para fornecer atualizações periódicas ao Amazon Connect Customer Profiles
Para fornecer atualizações periódicas aos perfis de clientes do Amazon Connect, você pode fazer a integração com a Shopify usando a Amazon. AppIntegrations Primeiro, você configura a conexão no Amazon Connect e na Shopify e, em seguida, verifica a integração.
## Configurar a conexão no Amazon Connect e na Shopify
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)
1. No painel de navegação, escolha **Perfis de clientes**.
1. Na página **Configuração dos perfis do cliente**, escolha **Adicionar integração**.
![\[A página Configuração dos perfis do cliente, o botão Adicionar integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Na página **Selecionar fonte**, escolha **Shopify**. Analise os requisitos da aplicação listados na página **Selecionar aplicação**.
![\[A página Selecionar fonte.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. Na página **Estabelecer conexão**, escolha uma das seguintes opções:
+ **Use a conexão existente**: Isso permite que você reutilize os EventBridge recursos existentes da Amazon que você possa ter criado no seu Conta da AWS.
+ **Criar nova conexão**: insira as informações exigidas pela aplicação externa.
![\[A página Estabelecer conexão.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **Nome da conexão**: forneça um nome para a conexão. O nome da conexão é referenciado pelas integrações que usam essa conexão.
+ **URL da conexão**: insira o URL de conexão da aplicação. Esse URL é usado para criar links diretos para os objetos criados na aplicação externa. O URL de conexão é o URL da aplicação do Shopify Partner no site da aplicação.
Para encontrar o URL da aplicação do Shopify Partner:
+ Faça login na sua conta partners.shopify.com.
+ Acesse sua aplicação.
+ Copie o URL do navegador.
+ **ID do cliente**: insira o ID do cliente da aplicação. É uma string que distingue de forma exclusiva o cliente em sua aplicação externa. Esse ID do cliente é o nome da fonte disponível no site da aplicação. Você usa o ID especificado aqui para identificar o cliente do qual deseja que o Customer Profiles consuma seus objetos. Seu ID de cliente poderá estar disponível depois de seguir as etapas de configuração da fonte.
Para encontrar o nome da fonte:
+ Faça login na sua conta partners.shopify.com.
+ Acesse sua aplicação.
+ Copie o nome da fonte da sua fonte de EventBridge eventos da Amazon.
1. Na página de **configuração da fonte**, copie seu Conta da AWS ID para a área de transferência e escolha **Fazer login na** Shopify.
1. Use as instruções a seguir para configurar a Shopify:
1. Faça login em partners.shopify.com.
1. Em Amazon EventBridge, escolha **Criar fonte**.
1. Cole seu Conta da AWS ID e selecione sua AWS região.
1. Depois de configurar o destino da origem do evento, retorne ao Customer Profiles. Você verá um alerta indicando que o Amazon Connect se conectou com sucesso à Shopify.
1. Na página de **Opções de integração**, escolha quais objetos de origem você deseja ingerir e selecione o tipo de objeto.
Os tipos de objeto armazenam seus dados ingeridos. Eles também definem como os objetos de suas integrações são mapeados para os perfis quando são ingeridos. O Customer Profiles fornece modelos de tipo de objeto padrão que você pode usar para definir como os atributos em seus objetos de origem são mapeados para os objetos padrão nos Customer Profiles. Você também pode usar os mapeamentos de objetos que você criou a partir do. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[A página Opções de integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. Para a **Data de início da ingestão**, o Customer Profiles começará a ingerir registros criados depois que a integração for adicionada.
**nota**
Se precisar de registros históricos, você poderá [usar o Amazon S3 como fonte de integração para importá-los](customer-profiles-object-type-mappings.md).
1. Na página **Analisar e integrar**, verifique se o **Status da conexão** é **Conectado** e escolha **Adicionar integração**.
**nota**
Depois de adicionar essa integração, você precisa [configurar assinaturas de webhook](#shopify-webhook-subscriptions) para permitir que os eventos comecem a fluir para essa integração.
![\[A página Analisar e integrar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. Depois que a integração for configurada, de volta à página **Configuração dos perfis do cliente**, a seção **Integrações** exibirá quais integrações estão atualmente configuradas. **Última execução** e **Integridade da integração** não estão atualmente disponíveis para esse tipo de integração.
![\[A seção Integrações.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Para ver quais dados estão sendo enviados, escolha a integração e, em seguida, escolha **Visualizar objetos**.
1. Vá para a próxima etapa para usar a API a fim de configurar **assinaturas de webhook** para que os eventos possam começar a fluir para essa integração.
## Configurar assinaturas de webhook
1. Use o seguinte URL para garantir que sua aplicação tenha as permissões necessárias:
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
Em que:
+ `shop` é o nome da sua loja da Shopify.
+ `api_key` é a chave de API da sua aplicação da Shopify. Você pode encontrar isso na página de detalhes **Aplicação** da Shopify.
+ `scopes` deve ter o valor `read_customers,read_orders,read_draft_orders`.
+ `redirect_uri` é o URI de redirecionamento que você especificou para sua aplicação quando a criou. Para nossos propósitos, pode ser qualquer URL válido.
+ `nonce` pode ser qualquer valor exclusivo para identificar uma determinada solicitação de autorização de outras pessoas. Recomendamos o uso de um carimbo de data e hora.
Depois de criar o URL, cole-o em seu navegador. Uma installation/authorization página semelhante à imagem a seguir é exibida, solicitando que o proprietário da loja dê permissões para o escopo definido.
![\[Um exemplo de página da Shopify para instalação e autorização da aplicação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. Escolha **Instalar aplicação não listada** para instalar e autorizar a aplicação em nome da sua loja.
Você vai para o URI de redirecionamento inserido com um código de autorização anexado ao URI de redirecionamento como um parâmetro de consulta. Por exemplo:
```
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
```
1. Copie o `authorization_code` deste URI. Você o usará para obter um token de acesso permanente nas próximas etapas.
1. Acesse qualquer ferramenta que você usa para fazer chamadas de API. Por exemplo, [CURL](https://curl.se/) ou [POSTMAN](https://www.postman.com/).
1. Para obter um token de acesso permanente, faça uma solicitação POST para a API `Admin` da Shopify neste endpoint:
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
com o seguinte corpo de solicitação:
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
Essa solicitação retorna a seguinte resposta:
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. Anote o `access_token`. Esse é um token permanente que tem o escopo fornecido em uma etapa anterior. Agora você está pronto para criar assinaturas de webhook.
1. Para as seguintes chamadas de API, certifique-se de definir a chave do cabeçalho HTTP `X-Shopify-Access-Token` como o `access_token` que você recebeu da resposta da chamada anterior.
1. Para configurar assinaturas de webhook, faça a seguinte solicitação POST para cada um dos valores `topic` listados na próxima etapa:
Endpoint: `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
Corpo da solicitação:
```
{
"webhook": {
"topic": "replace_this_with_one_of_the_topics_in_the_list_below",
"address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration",
"format": "json"
}
}
```
1. Para cada assinatura, substitua o valor de `topic` pelos seguintes valores:
+ `customers/create`
+ `customers/enable`
+ `customers/update`
+ `draft_orders/create`
+ `draft_orders/update`
+ `orders/cancelled`
+ `orders/create`
+ `orders/fulfilled`
+ `orders/paid`
+ `orders/partially_fulfilled`
+ `orders/updated`
Agora está tudo pronto para receber eventos da sua loja da Shopify. Em seguida, verifique sua integração com a Shopify.
## Verificar sua integração com a Shopify
1. Faça login como administrador na sua Shopify Store.
1. No menu de navegação à esquerda, selecione **Clientes**.
1. Selecione **Adicionar Cliente**.
1. Insira os detalhes do seu cliente. Certifique-se de inserir um número de telefone e um e-mail. Eles não precisam pertencer a um cliente real. Você excluirá essa entrada do cliente depois de verificar a integração.
1. Salve o objeto do cliente.
1. A entrega do evento deve ser quase instantânea, mas aguarde um minuto para que ela seja entregue e criar um perfil de cliente.
1. Abra a experiência do atendente do Amazon Connect e procure o usuário pelo e-mail ou pelo número de telefone que você inseriu na Shopify Store. Você deve ser capaz de ver o perfil do cliente com o mesmo e-mail ou número de telefone.
1. Se você não consegue ver o perfil do cliente, há um problema com sua integração. Para solucionar problemas:
1. Acesse o EventBridge console da Amazon.
1. Verifique se EventSource está ativo e se a correspondência EventBus existe e está em execução.
Se estiverem funcionando, entre em contato Suporte para obter ajuda na investigação do problema.
## Monitorar suas integrações do Customer Profiles
Depois que sua conexão for estabelecida, se ela parar de funcionar, exclua a integração e a restabeleça.
## O que fazer se os objetos não estiverem sendo enviados
Se um objeto não for enviado, escolha **Detalhes do fluxo** para saber mais sobre o que deu errado.
Talvez seja necessário excluir a configuração e se reconectar à aplicação externa.
# Configure a integração para aplicativos externos usando a Amazon AppFlow
Essas integrações usam AppFlow a Amazon para fornecer atualizações periódicas aos perfis de clientes do Amazon Connect. As etapas abaixo fornecem orientação sobre como configurar um conector de sua escolha usando a Amazon AppFlow, configurar mapeamentos de dados e configurar integrações para ingerir dados de seus clientes.
Para obter mais informações sobre os AppFlow preços da Amazon, consulte AppFlow [Preços](https://aws.amazon.com/appflow/pricing/) da Amazon.
Para obter mais informações sobre os conectores AppFlow compatíveis com a Amazon, consulte [Aplicativos de origem e destino compatíveis](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).
## Antes de começar
Ao ativar o Amazon Connect Customer Profiles, você cria um domínio do Customer Profiles, que é um contêiner para todos os dados, como perfis de clientes, tipos de objetos, chaves de perfil e chaves de criptografia. Veja abaixo as diretrizes para criar domínios do Customer Profile:
+ Cada instância do Amazon Connect só pode ser associada a um domínio.
+ Você pode criar vários domínios, mas eles não compartilham integrações de aplicações externas ou dados de clientes entre si.
+ Todas as integrações de aplicações externas que você cria estão no nível do domínio. Todas as instâncias do Amazon Connect associadas a um domínio herdam as integrações do domínio.
**Pré-requisito: habilitar o Customer Profiles em sua instância do Amazon Connect**
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
1. No painel de navegação, escolha **Perfis de clientes**.
1. Escolha Habilitar Customer Profiles
No formulário, você deverá preencher todos os campos obrigatórios para criar um domínio do Customer Profiles seguindo as etapas abaixo:
1. **Configuração de domínio**. Você pode criar um novo domínio e fornecer um nome.
1. **Criptografia**. Em Especificar chave do KMS, você pode habilitar a criptografia selecionando uma chave existente do AWS KMS, criando uma nova chave do AWS KMS ou escolhendo **Selecionar domínio existente**.
1. **Relatório de erros**. Você pode fornecer uma fila de mensagens não entregues, que é uma fila SQS para lidar com erros no perfil do cliente
1. Escolha **Enviar**, e o Customer Profiles será criado usando as informações do histórico de contatos da sua instância.
### Configurar um aplicativo externo usando a Amazon AppFlow
Você pode adicionar uma integração de aplicativo externo a um domínio do Amazon Connect Customer Profiles usando a Amazon AppFlow seguindo as etapas abaixo. Você deve criar um fluxo para sua fonte de dados no AppFlow console da Amazon e definir o Amazon Connect Customer Profiles como o destino antes de continuar no console Customer Profiles. Se você tiver criado um fluxo há mais de 14 dias, ele terá expirado e você precisará criar um novo fluxo para sua integração.
Opcionalmente, você pode realizar transformações de dados`Arithmetic`, como,`Filter`,`Map`,`Map_all`,`Mask`, `Merge``Truncate`, e `Validate` ao usar o CloudFormation `AWS::AppFlow::Flow Task` recurso antes da ingestão.
1. Faça login no console AWS de gerenciamento, selecione Amazon AppFlow e escolha **Criar fluxo**.
![\[A AppFlow página da Amazon.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)
1. Insira o nome do fluxo e uma descrição opcional.
![\[A página de detalhes do fluxo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)
1. Você pode deixar a seção **Criptografia de dados** como está, pois seu domínio do Amazon Connect Customer Profiles já tem uma AWS KMS chave existente que será usada para esse fluxo. Opcionalmente, você pode criar tags e, em seguida, escolher **Próximo**.
![\[A seção de criptografia de dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)
1. Selecione uma aplicação externa de sua escolha no menu suspenso **Nome da fonte** e, em seguida, selecione o próximo campo relevante. Por exemplo, se você quiser configurar o Slack, selecione Slack no menu suspenso **Nome da fonte**. Depois, selecione um fluxo do Slack existente ou crie uma nova conexão.
![\[A página de configuração do fluxo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)
1. Se optar por criar uma nova conexão, você poderá inserir os detalhes da aplicação externa, como nome de usuário, senha e subdomínio. Você também pode selecionar a AWS KMS chave para criptografia de dados e inserir o nome da conexão para identificar essa conexão.
![\[A página de conexão com o Slack.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)
1. Se optar por usar uma conexão existente, você poderá selecionar o objeto específico da aplicação externa no menu suspenso. Por exemplo, se escolher uma conexão existente do Slack, você poderá selecionar **Conversas** como objeto e, em seguida, escolher o canal específico do Slack que será usado.
![\[A página de detalhes da fonte.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)
1. Na seção **Detalhes do destino**, selecione Amazon Connect como o nome do destino no menu suspenso e selecione o domínio do perfil do cliente criado na etapa anterior de pré-requisito.
![\[A seção Detalhes do destino.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)
1. Selecione um gatilho de fluxo escolhendo **Executar sob demanda** ou **Executar fluxo dentro do cronograma**. Escolha **Próximo**.
+ **Executar sob demanda** só executa o fluxo quando você o dispara.
+ **Executar fluxo dentro do cronograma** executa o fluxo em um horário específico usando um agendamento. A frequência da programação é limitada a 5 minutos, 15 minutos ou 1 hora.
![\[A seção de gatilho de fluxo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)
1. Escolha **Mapear campos manualmente** em **Método de mapeamento**. Escolha os campos de origem da aplicação externa e, em seguida, escolha **Mapear campos diretamente**.
![\[A seção Método de mapeamento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)
1. Analise e escolha **Criar fluxo**.
Para obter mais informações sobre a criação de fluxos no AppFlow console da Amazon, consulte [Criação de fluxos na Amazon AppFlow](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html).
Para obter mais informações sobre a configuração de aplicativos externos e muitos outros aplicativos compatíveis na Amazon AppFlow, consulte [Aplicativos de AppFlow origem e destino da Amazon compatíveis](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).
### Configurar mapeamentos de dados para definir como os dados da aplicação externo são mapeados para um Customer Profile
Depois que a AppFlow integração com a Amazon for configurada, você precisará configurar mapeamentos de dados nos Perfis do cliente para definir como os dados do aplicativo externo serão mapeados para o Perfil do cliente. Isso permitirá que você personalize os dados que deseja usar para criar seu perfil de cliente unificado. Escolha seu mapeamento com cuidado, pois você não poderá escolher um mapeamento diferente depois de criar a integração.
Para obter informações mais detalhadas sobre mapeamentos de dados, consulte [Object type mapping](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html).
1. Faça login no seu console AWS de gerenciamento, selecione **Amazon Connect** e escolha Perfis de cliente no alias da sua instância de conexão.
![\[A página Amazon Connect Customer Profiles.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)
1. Escolha **Mapeamentos de dados** e, em seguida, **Criar mapeamento de dados**. Forneça um nome e uma descrição do mapeamento de dados.
![\[A guia Mapeamento de dados, o botão Criar mapeamento de dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)
![\[A página Mapeamento de dados definida.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)
1. Em **Opções de mapeamento**, você pode escolher sua **Fonte de dados** como aplicação externa, o **Nome do fluxo** que você criou na seção anterior e o **Método de definição de dados** como *Destino do mapeamento*. Em **Destino do mapeamento**, você pode escolher os tipos de dados do cliente que deseja definir para seus perfis unificados de clientes. Escolha **Próximo**.
![\[A seção Opções de mapeamento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)
1. Adicione atributos de cliente, produto, caso e pedido com origem, destino e tipo de conteúdo e escolha **Próximo**.
![\[A página Mapear atributos do pedido.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)
1. Em **Especificar identificadores**, você pode selecionar vários atributos do seu objeto de fonte de dados que ajudam a distinguir seus dados de outros objetos de fonte de dados. Você pode selecionar atributos a partir de identificadores exclusivos, de cliente, de produto, de caso e de pedido. Para obter mais informações sobre identificadores, consulte [Identificadores padrão para definir atributos de chave no Customer Profiles](standard-identifiers.md).
![\[A página Identificadores padrão.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)
1. Analise e escolha **Criar mapeamento de dados**. O status do mapeamento de dados será exibido como *Ativo*.
![\[Identificadores na Etapa 6: Página Especificar identificadores.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)
### Configurar integrações para ingerir dados de seus clientes a partir de uma aplicação externa
Depois que a configuração do mapeamento de dados for concluída para uma aplicação externa, você configurará a integração da fonte de dados para ingerir os dados do cliente.
1. Faça login no Console de Gerenciamento da AWS, selecione **Amazon Connect** e escolha Customer Profiles no alias da sua instância de conexão.
1. Na seção **Integrações de origens de dados**, escolha **Adicionar integração com origem dos dados**.
![\[Guia Integrações de origens de dados, botão Adicionar integração com origem dos dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)
1. Na lista suspensa **Fonte de dados**, selecione a aplicação externa e escolha **Próximo**. Você também tem a opção de escolher **Criar novo fluxo**, que abrirá o AppFlow console da Amazon em uma nova guia.
![\[Seção Fonte de dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)
1. No menu suspenso **Nome do fluxo**, selecione o fluxo que você deseja usar na sua fonte de dados e escolha **Próximo**.
![\[Seleção de um nome de fluxo para estabelecer uma conexão.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)
1. No menu suspenso **Mapeamento de dados**, selecione o mapeamento de dados da aplicação externa para o objeto para definir como sua fonte de dados é mapeada para os perfis. Escolha **Próximo**.
![\[Selecione a página Mapeamento de dados, caixa suspensa Mapeamento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)
1. Analise e escolha **Adicionar integração com origem dos dados**. A integração da fonte de dados da aplicação externa aparecerá inicialmente como pendente antes de passar para um estado ativo.
![\[Página Analisar e integrar, botão Adicionar integração com origem dos dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)
### Ver o perfil unificado do cliente no Amazon Connect Customer Profile Agent CCP
Agora, seus atendentes poderão visualizar os dados do cliente que foram importados de uma aplicação externa fazendo login no Amazon Connect Agent CCP. Para obter mais informações sobre como se conectar ao Amazon Connect Agent CCP, consulte [Agent application: Everything in one place](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application).
O atendente precisará ter as permissões de perfil de segurança apropriadas para visualizar o Customer Profiles e poderá realizar pesquisas usando um nome e valor de chave na barra de pesquisa de perfis.
Para obter mais informações sobre permissões do perfil de segurança, consulte [Security profiles](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html).
Usuários avançados que desejam criar a própria aplicação de atendente personalizada e perfis de clientes incorporados podem usar o [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles), que fornece mais personalização em relação à aplicação do atendente.
# Excluir o Customer Profiles ou interromper integrações
**nota**
A exclusão de mapeamentos excluirá somente objetos e dados associados a esse mapeamento específico. Se houver vários objetos associados a um perfil, a exclusão de um mapeamento específico poderá não limpar os dados do perfil. Se quisesse excluir dados específicos, você excluiria o mapeamento, mas seus perfis ainda poderão existir se contiverem dados de outros mapeamentos. Isso pode resultar em cobranças adicionais para os perfis existentes. Você pode excluir um domínio e todos os dados dos Perfis de clientes, incluindo todos os perfis, usando o [Amazon Connect console](delete-customer-profiles-domain.md) ou a [DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html)API.
**Método de console**
+ Se, a qualquer momento, você quiser interromper a ingestão de dados do perfil do cliente, escolha a integration/mapping e, em seguida, escolha **Excluir**.
+ Para excluir as integrações, os perfis dos clientes e todos os dados do perfil do cliente, você pode excluir o domínio dos perfis do cliente no Amazon Connect console. Para obter mais informações, consulte [Excluir um domínio do Amazon Connect Customer Profiles](delete-customer-profiles-domain.md).
**Método da API**
+ Para excluir dados de perfis de clientes para uma integração específica, use a API `DeleteProfileObjectType`.
+ Para excluir as integrações, os perfis dos clientes e todos os dados do perfil do cliente, use a API `DeleteDomain`.
Para reativar a ingestão dos dados do perfil do cliente, siga as etapas de configuração novamente.
# Mapeamento de tipo de objeto do Amazon Connect Customer Profiles
O mapeamento de tipo de objeto informa ao Customer Profiles como ingerir um tipo específico de dados. Ele fornece ao Customer Profiles informações essenciais, como:
+ Como os dados devem ser preenchidos a partir do objeto e ingeridos no objeto de perfil padrão.
+ Quais campos devem ser indexados no objeto e como esses campos devem ser usados para atribuir objetos desse tipo a um perfil específico.
Os tópicos desta seção fornecem informações e etapas para ajudar você a configurar o mapeamento de tipos de objetos, incluindo como criar um mapeamento de tipos de objetos, detalhes da definição do mapeamento e os principais conceitos e terminologia.
**Topics**
+ [
# Conceitos e terminologia para mapeamento de tipo de objeto do cliente
](customer-profiles-terminology.md)
+ [Criar um mapeamento de tipos de objetos](create-object-type-mapping.md)
+ [
# Detalhes da definição de mapeamento de tipo de objeto no Amazon Connect Customer Profiles
](object-type-mapping-definition-details.md)
+ [
# Propriedades adicionais dos tipos de objeto no Customer Profiles
](additional-properties-object-types.md)
+ [
# Perfis inferidos
](inferred-profiles.md)
+ [Modelos de registro de contato](ctr-contact-record-template.md)
+ [
# Associar o registro de contato a um perfil encontrado usando a chave \$1phone no Customer Profiles
](auto-associate-profile-using-phone-profile-key.md)
+ [
# Exemplos de mapeamentos de tipo de objeto no Amazon Connect Customer Profiles
](examples-object-type-mappings.md)
+ [
# Tipos de objetos de perfil implícitos no Amazon Connect Customer Profiles
](implicit-profile-object-types.md)
+ [Mapeamento de dados com IA generativa](genai-powered-data-mapping.md)
+ [Limites de dados do Customer Profiles](customer-profiles-data-limits.md)
# Conceitos e terminologia para mapeamento de tipo de objeto do cliente
Os seguintes conceitos e terminologia são fundamentais para o entendimento dos mapeamentos de tipos de objetos personalizados:
**Objeto de perfil padrão**
Um *objeto de perfil padrão* é um objeto predefinido que todos os perfis contêm.
Um objeto de perfil padrão contém campos padrão, como números de telefone, endereços de e-mail, nome e outros dados padrão. Esses dados podem ser recuperados em um formato padrão, independentemente da fonte (por exemplo, Salesforce ou ServiceNow Marketo).
**Objeto de perfil**
Um *objeto de perfil* é uma única unidade de informação conhecida de um perfil. Por exemplo, as informações sobre uma ligação telefônica, um tíquete, um caso ou até mesmo um registro de sequência de cliques de um site.
Um único objeto de perfil pode ter até 250 KB e pode ser qualquer documento JSON estruturado.
+ Cada objeto de perfil tem um tipo. Por exemplo, o objeto do perfil pode ser um registro de contato do Amazon Connect, ServiceNow usuários ou leads do Marketo.
+ O tipo se refere ao mapeamento de tipos de objetos.
+ O mapeamento do tipo de objeto define como esse objeto específico deve ser inserido nos perfis de clientes.
**Perfil**
Um *perfil* contém todas as informações conhecidas sobre um cliente ou contato específico. Ele inclui um único objeto de perfil padrão e qualquer número de objetos de perfil adicionais.
**Mapeamento de tipos de objetos.**
O *mapeamento de tipos de objetos* informa aos perfis do cliente como ingerir um tipo específico de dados. Ele fornece ao Customer Profiles as seguintes informações:
+ Como os dados devem ser preenchidos a partir do objeto e ingeridos no objeto de perfil padrão.
+ Quais campos devem ser indexados no objeto e como esses campos devem ser usados para atribuir objetos desse tipo a um perfil específico.
**Modelo de mapeamento**
Um *modelo de mapeamento* é um mapeamento de tipo de objeto predefinido incluído no serviço Customer Profiles.
Os perfis de clientes incluem modelos de mapeamento para registros de contatos do Amazon Connect, contas do Salesforce, ServiceNow usuários e leads do Marketo. Para obter uma lista completa dos modelos de mapeamento disponíveis, use a [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API.
Com os modelos de mapeamento, você pode ingerir rapidamente dados de fontes conhecidas sem precisar especificar nenhuma informação adicional.
# Criar um mapeamento de tipo de objeto do Amazon Connect Customer Profiles
Um mapeamento de tipo de objeto informa ao Customer Profiles como ingerir um tipo específico de dados de uma aplicação de origem, como Salesforce, Zendesk ou S3, em um objeto de perfil padrão unificado. Em seguida, você pode exibir dados nesse objeto (por exemplo, endereço do cliente e e-mail) para seus atendentes usando a [aplicação de atendente do Amazon Connect](customer-profile-access.md).
O mapeamento de tipo de objeto fornece ao Customer Profiles as seguintes informações:
+ Como os dados devem ser preenchidos a partir do objeto e ingeridos no objeto de perfil padrão.
+ Quais campos devem ser indexados no objeto e como esses campos devem ser usados para atribuir objetos desse tipo a um perfil específico.
Há duas maneiras de criar um mapeamento de tipo de objeto:
+ Use o console do Amazon Connect. A interface do usuário torna os recursos de mapeamento de dados facilmente acessíveis. Por exemplo, você pode adicionar atributos personalizados e definir identificadores exclusivos e de pesquisa para modelos de contato. Nenhuma codificação é necessária\$1
+ Use a API do Customer Profiles. Para obter mais informações, consulte [Referência de API do Amazon Connect Customer Profiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
Este tópico explica como criar um mapeamento usando o console do Amazon Connect.
## Criar um mapeamento de dados usando o console do Amazon Connect
O Amazon Connect fornece uma experiência sem código para mapear dados de clientes a partir de aplicativos internos e de terceiros com Amazon S3, Salesforce ServiceNow, Zendesk e Marketo.
Para criar um mapeamento de dados, você define um mapeamento de tipo de objeto que descreve a aparência do objeto de perfil personalizado. Esse mapeamento define como os campos de seus dados podem ser usados para preencher campos no perfil padrão ou como eles podem ser usados para atribuir os dados a um perfil específico.
### Etapa 1: Configurar o mapeamento de dados
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)
1. No painel de navegação, escolha **Perfis de clientes**, **Mapeamentos de dados**.
1. Escolha **Criar mapeamento de dados** para começar.
1. Na página **Configurar o mapeamento de dados**, na seção **Descrição**, adicione um nome que ajudará você a identificar a origem ou a finalidade desse mapeamento. Esses são os metadados do tipo de objeto.
1. Na seção **Fonte de dados**:
1. Escolha de onde os dados estão vindo, como Salesforce ou Zendesk. Com base na sua seleção, o Amazon Connect seleciona automaticamente os destinos disponíveis com base no modelo predefinido.
1. Escolha o objeto de origem. Isso é usado para você criar seu perfil unificado.
1. Na seção **Destino do mapeamento**, escolha os dados que você deseja usar para criar seu perfil de cliente unificado. Essas informações podem ser enviadas aos seus fluxos e atendentes para personalizar as interações com os contatos.
Para obter mais informações sobre destinos de mapeamento compatíveis, consulte [Informações sobre destinos de mapeamento no Amazon Connect](about-mapping-destinations.md).
1. Na seção **Opções adicionais**, você pode escolher quando optar por não criar novos perfis e por quanto tempo mantê-los. Essas opções ajudam você a gerenciar os custos.
**nota**
Por padrão, o período de retenção do domínio é de 366 dias. Para alterar o período de retenção definido em seu domínio, use a [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API.
1. Se você escolheu uma fonte diferente do S3, na *application* seção **Estabelecer uma conexão com**, escolha uma EventBridge conexão existente da Amazon AppFlow ou da Amazon para conectar seus dados ou crie uma nova conexão. Você pode criar uma nova conexão inserindo detalhes sobre sua conta para essa fonte de dados.
Depois que a conexão for estabelecida, você escolherá os objetos que deseja ingerir da sua fonte de dados.
1. Escolha **Próximo**.
### Etapa 2: Atributos do mapa
Na página **Atributos do *tipo* de mapa**, você verá a tabela de mapeamentos de campo preenchida com o modelo predefinido, com base no destino do mapeamento. Por exemplo, ele é preenchido com atributos de cliente, produto, caso ou pedido. Você pode alterar o modelo predefinido escolhendo um atributo (como AccountNumber) e, em seguida, selecionando um destino diferente ou inserindo um de seus próprios atributos personalizados.
A imagem a seguir mostra um exemplo da página preenchida com os atributos do cliente do modelo.
![\[O menu de navegação do Amazon Connect e a página Mapear atributos do cliente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)
Você pode remover o que não deseja preencher no perfil do cliente, alterar a fonte e adicionar atributos personalizados.
Esse mapeamento usa sua fonte de dados para preencher as informações de contato do cliente, como um número de telefone no perfil do cliente. Ele usa atributos do modelo de perfil padrão.
**dica**
Se você optar por adicionar atributos personalizados, o destino sempre terá o prefixo `Attributes.` adicionado a ele. Isso permite que o Amazon Connect reconheça que é um atributo personalizado.
![\[Interface de mapeamento de atributos do cliente mostrando campos de origem mapeados para campos de destino.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/custom-attribute-cp.png)
Agora, os atendentes podem visualizar atributos personalizados na aplicação Connect Agent, na guia **Informações adicionais**, classificada em ordem alfabética. Você pode criar o nome de sua escolha para cada atributo que será exibido aos atendentes usando o seguinte formato: `/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/`
Todos os atributos personalizados ingeridos serão exibidos na aplicação Connect Agent. Se você não quiser mostrar determinadas informações aos seus atendentes, não consuma atributos personalizados no momento.
### Etapa 3: Especificar identificadores
Na página **Especificar identificadores**, preencha as seções a seguir. Dependendo dos dados que você está mapeando, é possível que nem todos apareçam na sua página.
**nota**
Os nomes `_profileId`, `_orderId`, `_caseId` e `_assetId` são reservados para uso interno. Se você decidir usar esses nomes como um de seus nomes de identificação, eles devem ser declarados como `LOOKUP_ONLY`, o que significa que nosso sistema não os salvará para comparar com perfis, ativos padrão, pedidos padrão, casos padrão, nem os salvará para pesquisar seu perfil, ativo, caso ou pedido. Se você quiser que essas chaves possam ser usadas para pesquisa e correspondência, renomeie sua chave. Para obter mais informações, consulte o identificador padrão `LOOKUP_ONLY` e [Identificadores padrão para definir atributos de chave no Customer Profiles](standard-identifiers.md).
+ **Identificador exclusivo**: você deve ter um identificador exclusivo para seus dados para evitar erros ao serem ingeridos. Esse identificador também é conhecido como chave exclusiva. O Customer Profiles o usa para distinguir esses dados de outros objetos da fonte de dados e a fim de indexar para pesquisar e atualizar dados.
Só pode haver um identificador exclusivo.
+ **Identificador do cliente**: você deve ter pelo menos um identificador do cliente para seus dados para evitar erros ao serem ingeridos. O identificador também é conhecido como a chave do perfil.
O Customer Profiles o usa para determinar se o caso de dados está associado a um perfil existente ou usado para criar um novo perfil pesquisando esse identificador em outros perfis.
Você pode ter vários identificadores de clientes.
**dica**
Os atendentes podem usar qualquer um desses identificadores de cliente no Espaço de trabalho do atendente para encontrar o perfil que pertence ao cliente na interação.
+ **Identificador do produto**: você deve ter pelo menos um identificador do produto para seus dados para evitar erros ao serem ingeridos. O identificador também é conhecido como a chave do ativo.
O Customer Profiles o usa para distinguir esses dados de outros dados de compra de produtos do cliente. Ele também é usado para determinar se os dados podem estar associados a um perfil existente ou usados para criar um novo perfil pesquisando esse identificador em outros perfis.
Você pode ter vários identificadores de produtos.
+ **Identificador do caso**: você deve ter pelo menos um identificador do caso para seus dados para evitar erros ao serem ingeridos. O identificador também é conhecido como a chave do caso.
O Customer Profiles o usa para distinguir esses dados de outros dados de caso do cliente. Ele também é usado para determinar se os dados podem estar associados a um perfil existente ou usados para criar um novo perfil pesquisando esse identificador em outros perfis.
Você pode ter vários identificadores de casos.
+ **Identificador do pedido**: você deve ter pelo menos um identificador do pedido para seus dados para evitar erros ao serem ingeridos. O identificador também é conhecido como a chave do pedido.
O Customer Profiles o usa para distinguir esses dados de outros dados de caso do pedido. Ele também é usado para determinar se os dados podem estar associados a um perfil existente ou usados para criar um novo perfil pesquisando esse identificador em outros perfis.
Você pode ter vários identificadores de pedidos.
+ **Atributos de pesquisa adicionais - opcional**: você pode escolher atributos em seu objeto de fonte de dados que deseja indexar para serem pesquisáveis. Por padrão, todos os seus identificadores são indexados.
**dica**
Se os atributos de pesquisa nos objetos da fonte de dados contiverem basicamente o mesmo valor, isso poderá resultar em uma ingestão de dados mais lenta. Recomendamos criar atributos de pesquisa que sejam exclusivos em seus objetos de fonte de dados.
+ **Carimbo de data/hora do objeto de dados**: o carimbo de data/hora do objeto de dados é usado para resolver conflitos de perfil quando a Resolução de identidade está ativada para consolidar perfis semelhantes. Quando dois ou mais perfis semelhantes tiverem registros conflitantes, os registros do perfil com o carimbo de data/hora atualizado mais recentemente serão usados.
Você pode escolher um atributo em seu objeto para referenciar quando seu objeto foi atualizado pela última vez.
### Etapa 4: revisar e criar
Depois que o mapeamento de dados for criado, você poderá escolher **Adicionar integração com origem dos dados** para usar esse tipo de objeto.
![\[Interface do Amazon Connect Customer Profiles mostrando exemplos de detalhes de mapeamento de dados e status de integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)
# Informações sobre destinos de mapeamento no Amazon Connect
Um destino de mapeamento é seu mapeamento de uma fonte para uma definição padrão que já está definida no Amazon Connect.
A tabela a seguir lista os destinos de mapeamento compatíveis.
| Objeto de origem | Destino: cliente, produto, pedido, caso |
| --- | --- |
| S3 | Any |
| Salesforce-Account | Cliente |
| Salesforce-Contact | Cliente |
| Salesforce-Asset | Produto |
| Zendesk-users | Cliente |
| Marketo-leads | Cliente |
| Servicenow-sys\$1user | Cliente |
| Segment-Identify | Cliente |
| Segment-Customer | Cliente |
| Shopify-Customer | Cliente |
| Shopify- DraftOrder | Ordem |
| Zendesk-tickets | Caso |
| Servicenow-task | Caso |
| Servicenow-incident | Caso |
# Requisitos de mapeamento de tipo de objeto no Customer Profiles
As seguintes informações precisam estar em seu mapeamento de tipos de objetos para que o Customer Profiles possa processar os dados recebidos.
+ Uma definição de todos os campos no objeto ingerido que devem ser mapeados para o perfil padrão ou usados para atribuir os dados a um perfil. Isso informa aos perfis do cliente quais campos no objeto de **origem** ingerido devem ser mapeados para determinados campos no objeto de perfil padrão.
+ Quais campos no objeto de origem dos seus dados personalizados devem ser indexados e como.
Quando os dados de origem são ingeridos pelo Customer Profiles, os campos indexados determinam:
+ A qual perfil um objeto específico pertence.
+ Quais objetos estão relacionados entre si e devem ser colocados no mesmo perfil. Por exemplo, um número de conta ou ID de contato em um registro de contato.
+ Quais valores podem ser usados para encontrar um perfil. Por exemplo, o nome do contato pode ser indexado. Isso permitiria que os atendentes encontrassem todos os perfis pertencentes a clientes com um nome específico.
## Requisitos de chave
É necessário definir pelo menos uma chave. O Customer Profiles usa essa chave para mapear seu objeto de perfil personalizado para um perfil.
O mapeamento de objetos de perfil personalizado também precisa de pelo menos uma chave que identifique o objeto de forma exclusiva para que ele possa ser atualizado especificando o mesmo valor desse campo (esses requisitos podem ser atendidos com uma única chave).
Cada chave pode ser composta de um ou mais campos.
## Requisitos de campo
Uma definição de campo especifica como ler um valor para esse nome de campo a partir de um objeto de origem. A definição do campo também especifica que tipo de dados é armazenado no campo.
Os nomes dos tipos de objetos podem ser qualquer string alfanumérica ou os caracteres '-' e '\$1'. Eles também não podem começar com um caractere '\$1', que é usado para tipos de objetos padrão reservados.
# Detalhes da definição de mapeamento de tipo de objeto no Amazon Connect Customer Profiles
A definição do mapeamento do tipo de objeto tem duas partes: a definição do campo e a definição da chave.
**dica**
Para saber como criar um mapeador de tipos de objetos, consulte esta postagem no blog: [Unify and organize customer information with Amazon Connect Customer Profiles with the pre-built Amazon S3 connector](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/). Ou confira este vídeo sobre YouTube: [Como integrar os dados do perfil do cliente às suas experiências de contact center](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s).
## Detalhes da definição de campo
A definição do campo define a origem, o destino (destino) e o tipo de campo. Por exemplo:
```
"Fields": {
"{fieldName}": {
"Source": "{source}",
"Target": "{target}",
"ContentType": "{contentType}"
}, ...
}, ...
```
+ `Source`: pode ser um acessador JSON para o campo ou uma macro Handlebar para gerar o valor do campo.
O objeto de origem que está sendo analisado tem um nome ` _source`, para que todos os campos nos campos de origem precisem ser precedidos por essa string. Somente o objeto `_source` é compatível.
Use a solução de macro Handlebar para gerar constantes e combinar vários campos de objetos de origem em um único campo. Isso é útil para indexação.
+ `Target`: especifica onde, em um tipo de objeto padrão, os dados desse campo devem ser mapeados.
Preencher o perfil padrão permite que você use dados ingeridos de qualquer fonte de dados com aplicações criadas com base nos perfis de clientes sem nenhum conhecimento específico do formato dos dados que estão sendo ingeridos.
Esse campo é opcional. Talvez você queira definir campos somente com a finalidade de incluí-los em uma chave.
O formato desse campo é sempre um acessador JSON. O único objeto alvo compatível é `_profile`.
+ `ContentType`: os valores a seguir são compatíveis STRING, NUMBER, PHONE\$1NUMBER, EMAIL\$1ADDRESS, NAME. Se nenhum `ContentType` for especificado, STRING será assumido.
`ContentType` é usado para determinar como indexar o valor para que os atendentes possam pesquisá-lo. Por exemplo, se `ContentType` estiver definido como PHONE\$1NUMBER, um número de telefone será processado para que os atendentes possam procurá-lo em qualquer formato: a string “\$115551234567" corresponde a “(555) -123-4567".
## Detalhes de definição da chave
Uma chave contém um ou mais campos que, juntos, definem uma chave que pode ser usada para pesquisar objetos (ou os perfis aos quais eles pertencem) usando a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API. A chave também pode ser definida para identificar de forma exclusiva um perfil ou identificar com exclusividade o próprio objeto.
```
"Keys": {
"{keyName}": [{
"StandardIdentifiers": [...],
"FieldNames": [ "{fieldname}", ...]
}], ...
}, ...
```
Os nomes das chaves são globais para um domínio. Se você tiver duas chaves, com o mesmo nome em dois mapeamentos de tipos de objetos diferentes:
+ Essas chaves devem ocupar o mesmo namespace
+ Elas podem ser usadas para potencialmente vincular perfis entre objetos diferentes. Se elas corresponderem entre os objetos, o Customer Profiles colocará os dois objetos no mesmo perfil.
Para expressar isso de outra forma: as chaves deverão ter o mesmo nome de chave em um domínio se, e somente se, o mesmo valor indicar que elas estão relacionadas. Por exemplo, um número de telefone especificado em um tipo de objeto estaria relacionado ao mesmo número de telefone especificado em outro tipo de objeto. Um identificador interno especificado para um objeto importado do Salesforce pode não estar relacionado a outro objeto importado do Marketo, mesmo que tenha exatamente o mesmo valor.
As definições de chaves são usadas de duas maneiras:
+ Dentro do Customer Profiles durante a ingestão, elas são usadas para descobrir a qual perfil o objeto deve ser atribuído.
+ Eles permitem que você use a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para pesquisar o valor da chave e encontrar o perfil.
## Chaves de pesquisa padrão
As chaves de pesquisa padrão, como `_phone` e `_email`, são predefinidas pelo modelo de objetos de [Perfil padrão](standard-profile-definition.md), [Ativo padrão](standard-asset-definition.md), [Pedido padrão](standard-order-definition.md) e [Chamado padrão](standard-case-definition.md). Você pode usar as chaves de pesquisa padrão como um nome de chave com a [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para encontrar um perfil.
# Identificadores padrão para definir atributos de chave no Customer Profiles
Os identificadores padrão permitem que você defina atributos na chave. Decida quais identificadores usar com base em como você deseja que os dados sejam ingeridos nos perfis. Por exemplo, você marca o número de telefone com o identificador PROFILE. Isso significa que o número de telefone deve ser tratado como identificador exclusivo. Se o Customer Profiles obtiver dois contatos com o mesmo número de telefone, os contatos serão mesclados em um único perfil.
| Nome do identificador | Description |
| --- | --- |
| AIR\$1PREFERENCE | Esse identificador significa que essa chave identifica de forma exclusiva uma preferência aérea. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer preferência aérea que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1BOOKING | Esse identificador indica que essa chave identifica de forma exclusiva uma reserva aérea. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer reserva aérea que tenha essa chave associada a ela. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1SEGMENT | Esse identificador indica que essa chave identifica de forma exclusiva um trecho aéreo. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer trecho aéreo que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1PREFERENCE | Esse identificador significa que essa chave identifica de forma exclusiva uma preferência de hotel. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer preferência de hotel que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1STAY\$1REVENUE | Esse identificador significa que essa chave identifica de forma exclusiva a receita de uma estadia em hotel. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer receita de estadia em hotel que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1RESERVATION | Esse identificador significa que essa chave identifica de forma exclusiva uma reserva de hotel. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer reserva de hotel que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY | Esse identificador indica que essa chave identifica de forma exclusiva um cadastro em programa de fidelidade. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer cadastro em programa de fidelidade que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1TRANSACTION | Esse identificador indica que essa chave identifica de forma exclusiva uma transação de programa de fidelidade. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer transação de programa de fidelidade que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1PROMOTION | Esse identificador indica que essa chave identifica de forma exclusiva uma promoção de programa de fidelidade. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer promoção de programa de fidelidade que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| UNIQUE | Esse identificador deve ser especificado exatamente por um índice para cada tipo de objeto. Essa chave é usada para identificar de forma exclusiva objetos do tipo de objeto para buscá-los ou, se necessário, atualizar um objeto enviado posteriormente. Todos os campos que compõem as chaves UNIQUE devem ser especificados ao enviar um novo objeto ou ele será rejeitado. |
| PROFILE | Esse identificador indica que essa chave identifica um perfil com exclusividade. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer perfil que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| LOOKUP\$1ONLY | Esse identificador indica que a chave não é armazenada após a ingestão do objeto. A chave só deve ser usada para determinar o perfil durante a ingestão. O valor da chave não está associado ao perfil durante a ingestão, o que significa que não pode ser usado para permitir a pesquisa ou a correspondência de objetos ingeridos posteriormente com a mesma chave. Você não pode especificar uma chave tanto como identificador `UNIQUE` quanto como identificador `LOOKUP_ONLY`. Você só poderá usar `PROFILE` com `LOOKUP_ONLY` se houver pelo menos uma outra chave que tenha o identificador `PROFILE` sem os identificadores `NEW_ONLY` ou `LOOKUP_ONLY`. A única exceção é a chave `_profileId`, que pode ter a combinação de identificação `PROFILE` e `LOOKUP_ONLY` por si só. |
| NEW\$1ONLY | Se o perfil ainda não existir antes do objeto ser processado, a chave será associada ao perfil. Caso contrário, a chave só será usada para combinar objetos com perfis. Você não pode especificar uma chave tanto como identificador `UNIQUE` quanto como identificador `NEW_ONLY`. Você só poderá usar `PROFILE` com `NEW_ONLY` se houver pelo menos uma outra chave que tenha o identificador `PROFILE` sem os identificadores `NEW_ONLY` ou `LOOKUP_ONLY`. |
| SECONDARY | Durante a correspondência de um objeto com um perfil, o Customer Profiles primeiro consulta todas as chaves PROFILE que não tenham o identificador SECONDARY. Elas são consideradas primeiro. As chaves SECONDARY só serão consideradas se nenhum perfil correspondente for encontrado usando essas chaves. |
| ASSET | Esse identificador indica que essa chave identifica um ativo. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer ativo que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| ORDER | Esse identificador indica que essa chave identifica um pedido. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer pedido que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
| CASE | Esse identificador indica que essa chave identifica um caso. Quando esse identificador é especificado, significa que, durante a ingestão, o Customer Profiles procura qualquer caso que tenha essa chave associada a ele. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/standard-identifiers.html) |
## Identificadores compatíveis
![\[Matriz mostrando identificadores permitidos e restritos e nomes de chaves para diferentes tipos de dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)
# Como o Customer Profiles processa as principais definições
Quando o Customer Profiles ingere os mapeamentos de objetos personalizados, ele processa as principais definições. O diagrama a seguir mostra como ele processa identificadores padrão nas principais definições para determinar a qual perfil atribuir o objeto.
![\[Fluxograma mostrando o processo de verificação da chave de perfil para atribuição ou enfileiramento de objetos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-template1.png)
# Como o Customer Profiles adiciona chaves ao índice para pesquisas
O diagrama a seguir mostra como o Customer Profiles processa os identificadores padrão para determinar se a chave deve ser mantida.
![\[Um fluxograma que mostra o processo de decisão para chaves persistentes no Customer Profiles com base em pesquisa e novos critérios de objeto.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-template2.png)
O fluxograma mostra as seguintes etapas:
1. A chave tem `LOOKUP_ONLY` especificado?
+ Se Sim, não persista a chave.
1. Se Não, a chave tem `NEW_ONLY` especificado?
+ Se Não, salve a chave no índice para permitir que ela seja usada para pesquisas.
1. Se Sim, a ingestão do objeto resultou na criação de um perfil?
+ Se Sim, salve a chave no índice para permitir que ela seja usada para pesquisas.
+ Se Não, não persista a chave no índice para pesquisas futuras.
# Mapeamento de tipo de objeto para o perfil padrão no Amazon Connect Customer Profiles
Os tópicos desta seção fornecem a definição do perfil padrão e o mapeamento do tipo de objeto de aplicações externas para o perfil padrão.
**Topics**
+ [Requisitos de AppFlow acesso da Amazon](appflow-access-requirements-profile.md)
+ [Requisitos de AppIntegrations acesso da Amazon](standard-profile-appintegrations-requirements.md)
+ [
# Requisitos de EventBridge acesso da Amazon em perfis de clientes
](standard-profile-eventbridge-requirements.md)
+ [Definição de perfil padrão](standard-profile-definition.md)
+ [Mapeamento de objetos do Salesforce](mapping-salesforce-objects.md)
+ [Mapeamento de objetos do Zendesk](mapping-zendesk-objects.md)
+ [Mapeamento de objetos Marketo](mapping-marketo-objects.md)
+ [ServiceNowObjetos de mapeamento](mapping-servicenow-objects.md)
+ [Mapeamento de objetos Segment](mapping-segment-objects.md)
+ [Mapeamento de objetos Shopify](mapping-shopify-objects.md)
# Requisitos de AppFlow acesso da Amazon em perfis de clientes
Use os seguintes requisitos de AppFlow acesso da Amazon para criar e excluir os perfis de clientes do Zendesk, do Marketo, do Salesforce e das integrações ServiceNow com o Amazon Connect:
+ fluxo de aplicativos: CreateFlow
+ fluxo de aplicativos: DeleteFlow
# Requisitos de AppIntegrations acesso da Amazon em perfis de clientes
Use os seguintes requisitos de AppIntegrations acesso da Amazon para criar e excluir integrações do Segment e do Shopify com os perfis de clientes do Amazon Connect:
+ integrações de aplicativos: GetEventIntegration
+ integrações de aplicativos: ListEventIntegrationAssociations
+ integrações de aplicativos: CreateEventIntegrationAssociation
+ integrações de aplicativos: DeleteEventIntegrationAssociation
# Requisitos de EventBridge acesso da Amazon em perfis de clientes
Use os seguintes requisitos de EventBridge acesso da Amazon para criar e excluir integrações do Segment e do Shopify com os perfis de clientes do Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Definição de perfil padrão no Amazon Connect Customer Profiles
A tabela a seguir lista todos os campos no objeto de perfil padrão do Customer Profiles.
| Campo de perfil padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| ProfileId | String | O identificador exclusivo de um perfil do cliente. |
| AccountNumber | String | Um número de conta exclusivo que você forneceu ao cliente. |
| AdditionalInformation | String | Qualquer informação adicional relevante para o perfil do cliente. |
| PartyType | String | O tipo de perfil usado para descrever o cliente. Valores válidos: INDIVIDUAL \$1 BUSINESS \$1 OTHER |
| BusinessName | String | O nome da empresa do cliente. |
| FirstName | String | O nome do cliente. |
| MiddleName | String | O nome do meio do cliente. |
| LastName | String | O sobrenome do cliente. |
| BirthDate | String | A data de nascimento do cliente. |
| Gender | String | O gênero com o qual o cliente se identifica. |
| PhoneNumber | String | O número de telefone do cliente, que não foi especificado como número de celular, residencial ou comercial. |
| MobilePhoneNumber | String | O número de telefone celular do cliente. |
| HomePhoneNumber | String | O número de telefone residencial do cliente. |
| BusinessPhoneNumber | String | O número de telefone comercial do cliente. |
| EmailAddress | String | O endereço de e-mail do cliente, que não foi especificado como endereço pessoal ou comercial. |
| PersonalEmailAddress | String | O endereço de e-mail pessoal do cliente. |
| BusinessEmailAddress | String | O endereço de e-mail comercial do cliente. |
| Endereço | Endereço | Um endereço genérico associado ao cliente que não é para correspondência, envio ou cobrança. |
| ShippingAddress | Endereço | O endereço de entrega do cliente. |
| MailingAddress | Endereço | O endereço de correspondência do cliente. |
| BillingAddress | Endereço | O endereço de cobrança do cliente. |
| Atributos | String-to-string mapa | Par de atributos chave/valor de um perfil de cliente. |
| ProfileType | String | O tipo de perfil. Valores válidos: PROFILE \$1 ACCOUNT\$1PROFILE |
| EngagementPreferences | EngagementPreferences | As preferências de engajamento do cliente ou da conta. |
Os objetos de perfil padrão são indexados pelas chaves na tabela a seguir.
| Nome do índice padrão | Campo de perfil padrão |
| --- | --- |
| \$1phone | PhoneNumber, MobilePhoneNumber, HomePhoneNumber, ou BusinessPhoneNumber |
| \$1email | EmailAddress, PersonalEmailAddress, ou BusinessEmailAddress |
| \$1account | AccountNumber |
| \$1profileId | ProfileId |
| \$1fullName | "FirstName MiddleName LastName" |
Por exemplo, você pode usar `_phone` como nome de chave com a [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para encontrar um perfil cujo BusinessPhoneNumber atributo PhoneNumber MobilePhoneNumber, HomePhoneNumber,, ou corresponda ao valor da pesquisa.
## Tipo de dados do endereço
| Campo de perfil padrão | Tipo de dados | Description |
| --- | --- | --- |
| Address1 | String | A primeira linha do endereço de um cliente. |
| Address2 | String | A segunda linha do endereço de um cliente. |
| Address3 | String | A terceira linha do endereço de um cliente. |
| Address4 | String | A quarta linha do endereço de um cliente. |
| Cidade | String | A cidade em que o cliente mora. |
| País | String | O país em que o cliente mora. |
| Condado | String | O distrito em que o cliente mora. |
| PostalCode | String | O código postal de endereço do cliente. |
| Província | String | A província em que o cliente mora. |
| Estado | String | O estado em que o cliente mora. |
## EngagementPreferences tipo de dados
| Campo de perfil padrão | Tipo de dados | Description |
| --- | --- | --- |
| E-mail | Matriz de ContactPreference objetos | Uma lista de preferências de contato relacionadas a e-mail. |
| Telefone | Matriz de ContactPreference objetos | Uma lista de preferências de contato relacionadas a telefone. |
## ContactPreference tipo de dados
| Campo de perfil padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| KeyName | String | Um identificador exclusivo e pesquisável de um perfil de cliente. |
| KeyValue | String | O valor de chave usado para pesquisar o perfil com base em keyName. |
| ProfileId | String | O identificador exclusivo de um perfil do cliente. |
| ContactType | String | O tipo de contato usado para engajamento. Valores válidos: PhoneNumber \$1 MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress |
# Mapeamento de objetos do Salesforce para o perfil padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos do Salesforce são mapeados para o objeto de perfil padrão no Customer Profiles.
## Objeto Salesforce-Account
Esta é uma lista de todos os campos em um objeto Salesforce-Account. Os campos em seu objeto Salesforce-Account podem variar de acordo com a configuração da instância do Salesforce.
+ Id
+ IsDeleted
+ MasterRecordId
+ Nome
+ Tipo
+ ParentId
+ BillingStreet
+ BillingCity
+ BillingState
+ BillingPostalCode
+ BillingCountry
+ BillingLatitude
+ BillingLongitude
+ BillingGeocodeAccuracy
+ BillingAddress.Cidade
+ BillingAddress.País
+ BillingAddress.Precisão do código geográfico
+ BillingAddress.latitude
+ BillingAddress.longitude
+ BillingAddress. Código postal
+ BillingAddress.estado
+ BillingAddress.rua
+ ShippingStreet
+ ShippingCity
+ ShippingState
+ ShippingPostalCode
+ ShippingCountry
+ ShippingLatitude
+ ShippingLongitude
+ ShippingGeocodeAccuracy
+ ShippingAddress.city
+ ShippingAddress.país
+ ShippingAddress.latitude
+ ShippingAddress.longitude
+ ShippingAddress. Código postal
+ ShippingAddress.estado
+ ShippingAddress.rua
+ Telefone
+ Fax
+ AccountNumber
+ Website
+ PhotoUrl
+ Sic
+ Industry
+ AnnualRevenue
+ NumberOfEmployees
+ Ownership
+ TickerSymbol
+ Description
+ Rating
+ Site
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedId
+ SystemModstamp
+ LastActivityDate
+ LastViewedDate
+ LastReferencedDate
+ Jigsaw
+ JigsawCompanyId
+ CleanStatus
+ AccountSource
+ DunsNumber
+ Tradestyle
+ NaicsCode
+ NaicsDesc
+ YearStarted
+ SicDesc
+ DandbCompanyId
+ IsBuyer
## Mapeamento de um objeto Salesforce-Account para um perfil padrão
Um subconjunto dos campos no mapa de objeto para o objeto de perfil padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Salesforce-Account para o perfil padrão. (A tabela inclui o mapeamento de uma instância do Salesforce que foi configurada para incluir campos Pessoa.)
| Campo de origem Salesforce-Account | Campo de destino do perfil padrão |
| --- | --- |
| Id | Atributos. sfdcAccountId |
| Nome | BusinessName |
| Telefone | PhoneNumber |
| BillingStreet | BillingAddress.Endereço 1 |
| BillingCity | BillingAddress.Cidade |
| BillingState | BillingAddress.Estado |
| BillingCountry | BillingAddress.País |
| BillingPostalCode | BillingAddress.PostalCode |
| ShippingStreet | ShippingAddress.Endereço 1 |
| ShippingCity | ShippingAddress.Cidade |
| ShippingState | ShippingAddress.Estado |
| ShippingCountry | ShippingAddress.País |
| ShippingPostalCode | ShippingAddress.PostalCode |
| IsPersonAccount | PartyType |
| PersonMobilePhone | MobilePhoneNumber |
| PersonHomePhone | HomePhoneNumber |
| PersonEmail | PersonalEmailAddress |
| PersonMailingAddress.Rua | MailingAddress.Endereço 1 |
| PersonMailingAddress.Cidade | MailingAddress.Cidade |
| PersonMailingAddress.Estado | MailingAddress.Estado |
| PersonMailingAddress.País | MailingAddress.País |
| PersonMailingAddress.PostalCode | MailingAddress.PostalCode |
| PersonBirthDate | BirthDate |
| PersonOtherStreet | Address.Address1 |
| PersonOtherCity | Address.City |
| PersonOtherState | Address.State |
| PersonOtherCountry | Address.Country |
| PersonOtherPostalCode | Endereço. PostalCode |
| FirstName | FirstName |
| LastName | LastName |
| MiddleName | MiddleName |
| AccountNumber | AccountNumber |
Os dados do cliente Salesforce-Account do objeto Salesforce são associados a um perfil de cliente do Amazon Connect usando os índices na tabela a seguir.
| Nome do índice padrão | Campo de origem Salesforce-Account |
| --- | --- |
| \$1salesforceAccountId | Id |
Por exemplo, você pode usar `_salesforceAccountId` como nome de chave com a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para encontrar um perfil. Você pode encontrar os objetos Salesforce-Account associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com e definida como. `ProfileId` `ObjectTypeName` `Salesforce-Account`
## Objeto Salesforce-Contact
Esta é uma lista de todos os campos em um objeto Salesforce-Contact.
+ Id
+ IsDeleted
+ MasterRecordId
+ Accountd
+ LastName
+ FirstName
+ Salutation
+ Nome
+ OtherStreet
+ OtherCity
+ OtherState
+ OtherPostalCode
+ OtherCountry
+ OtherLatitude
+ OtherLongitude
+ OtherGeocodeAccuracy
+ OtherAddress.city
+ OtherAddress.país
+ OtherAddress.Precisão do código geográfico
+ OtherAddress.latitude
+ OtherAddress. Código postal
+ OtherAddress.estado
+ OtherAddress.rua
+ MailingStreet
+ MailingCity
+ MailingState
+ MailingPostalCode
+ MailingCountry
+ MailingLatitude
+ MailingLongitude
+ MailingGeocodeAccuracy
+ MailingAddress.city
+ MailingAddress.país
+ MailingAddress.Precisão do código geográfico
+ MailingAddress.latitude
+ MailingAddress.longitude
+ MailingAddress. Código postal
+ MailingAddress.estado
+ MailingAddress.rua
+ Telefone
+ Fax
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ E-mail
+ Título
+ Department
+ AssistantName
+ LeadSource
+ Birthdate
+ Description
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ Última CURequest data
+ Última CUUpdate data
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Jigsaw
+ JigawContactId
+ CleanStatus
+ IndividualId
## Mapeamento de um objeto Salesforce-Contact para um perfil padrão
Um subconjunto dos campos no mapa de objeto Salesforce-Contact para o objeto de perfil padrão no Customer Profiles. A tabela a seguir lista quais campos podem ser mapeados do objeto Salesforce-Contact para o objeto do perfil padrão.
| Campo de origem Salesforce-Contact | Campo de destino do perfil padrão |
| --- | --- |
| Id | Atributos. sfdcContactId |
| AccountId | Atributos. sfdcAccountId |
| LastName | LastName |
| FirstName | FirstName |
| MiddleName | MiddleName |
| OtherStreet | Address.Address1 |
| OtherCity | Address.City |
| OtherState | Address.State |
| OtherCountry | Address.Country |
| OtherPostalCode | Endereço. PostalCode |
| MailingStreet | MailingAddress.Endereço 1 |
| MailingCity | MailingAddress.Cidade |
| MailingState | MailingAddress.Estado |
| MailingCountry | MailingAddress.País |
| MailingPostalCode | MailingAddress.PostalCode |
| Telefone | PhoneNumber |
| HomePhone | HomePhoneNumber |
| MobilePhone | MobilePhoneNumber |
| E-mail | EmailAddress |
| Birthdate | BirthDate |
Os dados do cliente Salesforce-Contact de um objeto Salesforce são associados a um perfil de cliente do Amazon Connect usando os índices na tabela a seguir.
| Nome do índice padrão | Campo de origem Salesforce-Contact |
| --- | --- |
| \$1salesforceContactId | Id |
| \$1salesforceAccountId | AccountId |
Por exemplo, você pode usar `_salesforceAccountId` e `_salesforceContactId` como nome de chave com a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para encontrar um perfil. Você pode encontrar os objetos do Salesforce-Contact associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com e definida como. `ProfileId` `ObjectTypeName` `Salesforce-Contact`
# Mapeamento de objetos do Zendesk para o perfil padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos do Zendesk são mapeados para o perfil padrão no Customer Profiles.
## Objeto Zendesk-users
Esta é uma lista de todos os campos em um objeto Zendesk-users.
+ id
+ url
+ external\$1id
+ email
+ active
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ detalhes
+ last\$1login\$1at
+ locale
+ locale\$1id
+ moderator
+ notes
+ only\$1private\$1comments
+ default\$1group\$1id
+ phone
+ shared\$1phone\$1number
+ photo
+ restricted\$1agent
+ perfil
+ shared
+ tags
+ assinatura
+ suspended
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ verified
+ report\$1csv
+ created\$1at
+ updated\$1at
## Mapeamento de usuários do Zendesk para um perfil padrão
Um subconjunto dos campos no mapa de objeto Zendesk-users para o perfil padrão no Customer Profiles. A tabela a seguir lista quais campos podem ser mapeados do objeto Zendesk-users para o perfil padrão.
| Campo de origem Zendesk-users | Campo de destino do perfil padrão |
| --- | --- |
| id | Atributos. ZendeskUserId |
| external\$1id | Atributos. ZendeskExternalId |
| email | EmailAddress |
| phone | PhoneNumber |
Os dados de cliente Zendesk-users do objeto Zendesk são associados a um perfil de cliente do Amazon Connect usando os índices a seguir.
| Nome do índice padrão | Campo de origem Zendesk-user |
| --- | --- |
| \$1zendeskUserId | Id |
| \$1zendeskExternalId | external\$1id |
Por exemplo, você pode usar `_zendeskUserId` e `_zendeskExternalId` como um nome de chave com a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para encontrar um perfil de cliente do Amazon Connect. Você pode encontrar os objetos dos usuários do Zendesk associados a um perfil de cliente específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como. `Zendesk-users`
# Mapeamento de objetos do Marketo para o perfil padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos do Marketo são mapeados para o objeto de perfil padrão no Customer Profiles.
## Objeto Marketo-leads
Esta é uma lista de todos os campos em um objeto Marketo-leads.
+ id
+ firstName
+ lastName
+ middleName
+ email
+ phone
+ mobilePhone
+ billingStreet
+ billingCity
+ billingState
+ billingCountry
+ billingPostalCode
+ address
+ cidade
+ estado
+ país
+ postalcode
+ gender
+ dateOfBirth
## Mapeamento de Marketo-leads para um perfil padrão
Um subconjunto de campos no mapa de objetos Marketo-leads para o perfil padrão.
| Campo de origem Marketo-leads | Campo de destino do perfil padrão |
| --- | --- |
| id | Atributos. MarketoLeadId |
| sfdcAccountId | Atributos. sfdcAccountId |
| sfdcContactId | Atributos. sfdcContactId |
| firstName | FirstName |
| lastName | LastName |
| middleName | MiddleName |
| email | EmailAddress |
| phone | PhoneNumber |
| mobilePhone | MobilePhoneNumber |
| mobilePhone | MobilePhoneNumber |
| billingStreet | BillingAddress.Endereço 1 |
| billingCity | BillingAddress.Cidade |
| billingState | BillingAddress.Estado |
| billingCountry | BillingAddress.País |
| billingPostalCode | BillingAddress.PostalCode |
| address | Address.Address1 |
| cidade | Address.City |
| estado | Address.State |
| país | Address.Country |
| postalcode | Endereço. PostalCode |
| gender | Gender |
| dataOfBirth | BirthDate |
Os dados do cliente Marketo-leads do Marketo são associados a um perfil de cliente do Amazon Connect usando os índices na tabela a seguir.
| Nome do índice padrão | Campo de origem Marketo-leads |
| --- | --- |
| \$1marketoLeadId | id |
| \$1salesforceAccountId | sfdcAccountId |
| \$1salesforceContactId | sfdcContactId |
Por exemplo, você pode usar`_marketoLeadId`,`_salesforceAccountId`, e `_salesforceContactId` como um nome de chave com a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para encontrar um perfil de cliente do Amazon Connect. Você pode encontrar os objetos Marketo-leads associados a um perfil de cliente específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como. `Marketo-leads`
# Mapeamento de ServiceNow objetos para o objeto de perfil padrão nos perfis de clientes do Amazon Connect
Este tópico lista quais campos em ServiceNow objetos são mapeados para campos no objeto de perfil padrão nos perfis de clientes do Amazon Connect.
## Objeto Servicenow-sys\$1user
Esta é uma lista de todos os campos em um objeto Servicenow-sys\$1user.
+ sys\$1id
+ active
+ building
+ calendar\$1integration
+ cidade
+ company
+ cost\$1center
+ país
+ date\$1format
+ default\$1perspective
+ department
+ edu\$1status
+ email
+ employee\$1number
+ enable\$1multifactor\$1authn
+ failed\$1attempts
+ first\$1name
+ gender
+ home\$1phone
+ internal\$1integration\$1user
+ introduction
+ last\$1login
+ last\$1login\$1device
+ last\$1login\$1time
+ last\$1name
+ last\$1password
+ ldap\$1server
+ location
+ locked\$1out
+ manager
+ middle\$1name
+ mobile\$1phone
+ name
+ notificação
+ password\$1needs\$1reset
+ phone
+ photo
+ preferred\$1language
+ perfis
+ agendamento
+ origem
+ estado
+ street
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ sys\$1domain.link
+ sys\$1domain.value
+ sys\$1domain\$1path
+ sys\$1id
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1udpated\$1on
+ time\$1format
+ time\$1zone
+ título
+ user\$1name
+ user\$1password
+ web\$1service\$1access\$1only
+ zip
## Mapeamento de Servicenow-sys\$1users para um objeto do perfil padrão
Um subconjunto dos campos no mapa de objeto Servicenow-sys\$1users para o objeto do perfil padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Servicenow-sys\$1users para o perfil padrão.
| Campo de origem Servicenow-sys\$1users | Campo de destino do Customer Profiles |
| --- | --- |
| sys\$1id | Atributos. ServiceNowSystemId |
| first\$1name | FirstName |
| last\$1name | LastName |
| middle\$1name | MiddleName |
| gender | Gender |
| email | EmailAddress |
| phone | PhoneNumber |
| home\$1phone | HomePhoneNumber |
| mobile\$1phone | MobilePhoneNumber |
| street | Address.Address1 |
| cidade | Address.City |
| estado | Address.State |
| país | Address.Country |
| zip | Endereço. PostalCode |
Os dados de cliente Servicenow-sys\$1user do objeto Servicenow são associados a um perfil de cliente do Amazon Connect usando os índices na tabela a seguir.
| Nome do índice padrão | Campo de origem Servicenow-sys\$1user |
| --- | --- |
| \$1 serviceNowSystem Identificação | sys\$1id |
Por exemplo, você pode usar `_serviceNowSystemId` e `_serviceNowIncidentId` como um nome de chave com a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para encontrar um perfil de cliente do Amazon Connect. Você pode encontrar os objetos ServiceNow-Sys\$1User associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com e definida como. `ProfileId` `ObjectTypeName` `Servicenow-sys_user`
# Mapeamento de objetos do Segment para o perfil padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos do Segment são mapeados para o perfil padrão no Amazon Connect Customer Profiles.
## Objeto Segment-Identify
Esta é uma lista de todos os campos em um objeto Segment-Identify.
+ userId
+ campos comuns - consulte [Spec: Common Fields](https://segment.com/docs/connections/spec/common/) na documentação do Segment
+ Características reservadas do Segment - consulte [Traits](https://segment.com/docs/connections/spec/identify/#traits) na documentação do Segment
+ traits.address.street
+ traits.address.city
+ traits.address.state
+ traits.address.postalCode
+ traits.address.country
+ traits.age
+ traits.avatar
+ traits.birthday
+ traits.company.name
+ traits.company.id
+ traits.company.industry
+ traits.company.employee\$1count
+ traits.company.plan
+ traits.createdAt
+ traits.description
+ traits.email
+ traits.firstName
+ traits.gender
+ traits.id
+ traits.lastName
+ traits.name
+ traits.phone
+ traits.title
+ traits.username
+ traits.website
## Mapeamento de um Segment-Identify para um objeto de perfil padrão
Um subconjunto dos campos no mapa de objeto Segment-Identify para o objeto de perfil padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Segment-Identify para o perfil padrão.
| Campo de origem Segment-Identify | Campo de destino do perfil padrão |
| --- | --- |
| | Campo de destino do perfil padrão |
| userId | Atributos. SegmentUserId |
| traits.company.name | BusinessName |
| traits.firstName | FirstName |
| traits.lastName | LastName |
| traits.birthday | BirthDate |
| traits.gender | Gender |
| traits.phone | PhoneNumber |
| traits.email | EmailAddress |
| traits.address.street | Address.Address1 |
| traits.address.city | Address.City |
| traits.address.state | Address.State |
| traits.address.country | Address.Country |
| traits.address.postalCode | Endereço. PostalCode |
### Exemplo
O exemplo a seguir mostra como mapear um campo de origem para um campo de destino.
```
"segmentUserId": {
"Source": "_source.detail.event.detail.userId",
"Target": "_profile.Attributes.SegmentUserId"
}
```
Os dados de cliente Segment-Identify do objeto Segment são associados a um perfil de cliente do Amazon Connect usando o índice a seguir.
| Nome do índice padrão | Campo de origem Segment-Identify |
| --- | --- |
| \$1segmentUserId | userId |
Por exemplo, você pode usar `_segmentUserId` como nome de chave a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para encontrar um perfil de cliente do Amazon Connect. Você pode encontrar os objetos de identificação por segmento associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como. `Segment-Identify`
# Mapeamento de objetos da Shopify para o perfil padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos da Shopify são mapeados para o perfil padrão no Amazon Connect Customer Profiles.
## Objeto Shopify-Customer
Esta é uma lista de todos os campos em um objeto Shopify-Customer.
+ accepts\$1marketing
+ accepts\$1marketing\$1updated\$1at
+ endereços
+ currency
+ created\$1at
+ default\$1address.address1
+ default\$1address.address2
+ default\$1address.city
+ default\$1address.company
+ default\$1address.country
+ default\$1address.country\$1code
+ default\$1address.country\$1name
+ default\$1address.customer\$1id
+ default\$1address.default
+ default\$1address.first\$1name
+ default\$1address.id
+ default\$1address.last\$1name
+ default\$1address.name
+ default\$1address.phone
+ default\$1address.province
+ default\$1address.province\$1code
+ default\$1address.zip
+ email
+ first\$1name
+ id
+ last\$1name
+ last\$1order\$1id
+ last\$1order\$1name
+ metafield.key
+ metafield.value
+ metafield.namespace
+ metafield.value\$1type
+ marketing\$1opt\$1in\$1level
+ multipass\$1identifier
+ note
+ orders\$1count
+ phone
+ sms\$1marketing\$1consent.state
+ sms\$1marketing\$1consent.opt\$1in\$1level
+ sms\$1marketing\$1consent.consent\$1updated\$1at
+ sms\$1marketing\$1consent.consent\$1collected\$1from
+ estado
+ tags
+ tax\$1exempt
+ tax\$1exemptions
+ total\$1spent
+ updated\$1at
+ verified\$1email
## Mapeamento de um objeto Shopify-Customer para um perfil padrão
Um subconjunto dos campos no mapa de objeto Shopify-Customer para o objeto de perfil padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Shopify-Customer para o perfil padrão.
| Campo de origem de Shopify-Customer | Campo de destino do perfil padrão |
| --- | --- |
| id | Atributos. ShopifyCustomerId |
| email | EmailAddress |
| first\$1name | FirstName |
| last\$1name | LastName |
| note | AdditionalInformation |
| phone | PhoneNumber |
| default\$1address.address1 | Address.Address1 |
| default\$1address.address2 | Address.Address2 |
| default\$1address.city | Address.City |
| default\$1address.province | Address.Province |
| default\$1address.country | Address.Country |
| default\$1address.zip | Endereço. PostalCode |
### Exemplo
O exemplo a seguir mostra como mapear um campo de origem para um campo de destino.
```
"shopifyCustomerId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_profile.Attributes.ShopifyCustomerId"
}
```
Os dados de cliente Shopify-Customer do objeto Shopify são associados a um perfil de cliente do Amazon Connect usando o índice a seguir.
| Nome do índice padrão | Campo de origem de Shopify-Customer |
| --- | --- |
| \$1shopifyCustomerId | id |
Por exemplo, você pode usar `_shopifyCustomerId` como nome de chave a [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para encontrar um perfil de cliente do Amazon Connect. Você pode encontrar os objetos Shopify-Customer associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com o `ProfileId` e definido como. `ObjectTypeName` `Shopify-Customer`
# Mapeamento de tipo de objeto para o pedido padrão no Amazon Connect Customer Profiles
Os tópicos desta seção fornecem a definição do pedido padrão e o mapeamento do tipo de objeto de aplicações externas para o pedido padrão.
**Topics**
+ [Requisitos de AppIntegrations acesso da Amazon](standard-order-appintegrations-requirements.md)
+ [Requisitos de EventBridge acesso da Amazon](standard-order-eventbridge-requirements.md)
+ [Definição de pedido padrão](standard-order-definition.md)
+ [Mapeamento de objetos Shopify](mapping-shopify-objects-standard-order.html.md)
# Requisitos de AppIntegrations acesso da Amazon
Use os seguintes requisitos de AppIntegrations acesso da Amazon para criar e excluir integrações da Shopify com os perfis de clientes do Amazon Connect:
+ integrações de aplicativos: GetEventIntegration
+ integrações de aplicativos: ListEventIntegrationAssociations
+ integrações de aplicativos: CreateEventIntegrationAssociation
+ integrações de aplicativos: DeleteEventIntegrationAssociation
# Requisitos de EventBridge acesso da Amazon
Use os seguintes requisitos de EventBridge acesso da Amazon para criar e excluir integrações da Shopify com os perfis de clientes do Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Campos de objeto de pedido padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de pedido padrão do Customer Profiles.
| Campo de pedido padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| OrderId | String | O identificador exclusivo de um pedido padrão. |
| CustomerEmail | String | O endereço de e-mail do cliente. |
| CustomerPhone | String | O número de telefone do cliente. |
| CreatedDate | String | A data de criação do pedido. |
| UpdatedDate | String | A data de atualização do pedido. |
| ProcessedDate | String | A data de processamento do pedido. |
| ClosedDate | String | A data de fechamento do pedido. |
| CancelledDate | String | A data de cancelamento do pedido. |
| CancelReason | String | O motivo de cancelamento do pedido. |
| Nome | String | O nome do pedido. |
| AdditionalInformation | String | Qualquer informação adicional relevante para o pedido. |
| Gateway | String | O gateway de pagamento do pedido. |
| Status | String | O status do pedido. |
| StatusCode | String | O código de status do pedido. Valores válidos: DRAFT \$1 ACTIVATED |
| StatusUrl | String | O URL de status do pedido. |
| CreditCardNumber | String | Os últimos quatro dígitos do cartão de crédito do cliente. |
| CreditCardCompany | String | A administradora do cartão de crédito do cliente. |
| FulfillmentStatus | String | O status de atendimento do pedido. |
| TotalPrice | String | O preço total do pedido. |
| TotalTax | String | O total de impostos do pedido. |
| TotalDiscounts | String | O total de descontos do pedido. |
| TotalItemsPrice | String | O preço total dos itens do pedido. |
| TotalShippingPrice | String | O preço de envio total do pedido. |
| TotalTipReceived | String | A gorjeta total recebida no pedido. |
| Currency | String | A moeda do pedido. |
| TotalWeight | String | O peso total do pedido. |
| BillingAddress | OrderAddress | O endereço de cobrança do cliente. |
| ShippingAddress | OrderAddress | O endereço de entrega do cliente. |
| OrderItems | OrderItem lista | Os itens do pedido. |
| Atributos | String-to-string mapa | Par de chave/valor dos atributos de um pedido padrão. |
Os objetos de pedido padrão são indexados pelas chaves na tabela a seguir.
| Nome do índice padrão | Campo de pedido padrão |
| --- | --- |
| \$1orderId | OrderId |
Por exemplo, você pode usar `_orderId` como nome de chave com a [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para encontrar um perfil que tenha um pedido que OrderId corresponda ao valor da pesquisa. Você pode encontrar os objetos de pedido padrão associados a um perfil específico usando a [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) com `ProfileId` e `ObjectTypeName` definida como`_order`.
## OrderAddress tipo de dados
| Campo de pedido padrão | Tipo de dados | Description |
| --- | --- | --- |
| Nome | String | O nome associado ao endereço de um pedido. |
| Address1 | String | A primeira linha do endereço de um pedido. |
| Address2 | String | A segunda linha do endereço de um pedido. |
| Address3 | String | A terceira linha do endereço de um pedido. |
| Address4 | String | A quarta linha do endereço de um pedido. |
| Cidade | String | A cidade do endereço de um pedido. |
| Condado | String | O condado do endereço de um pedido. |
| Estado | String | O estado do endereço de um pedido. |
| Província | String | A província do endereço de um pedido. |
| País | String | O país do endereço de um pedido. |
| PostalCode | String | O código postal do endereço de um pedido. |
## OrderItem tipo de dados
| Campo de pedido padrão | Tipo de dados | Description |
| --- | --- | --- |
| Título | String | O título de um item do pedido. |
| Preço | String | O preço de um item do pedido. |
| Quantidade | String | A quantidade de um item do pedido. |
# Mapeamento de objetos da Shopify para o pedido padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos da Shopify são mapeados para o padrão padrão no Customer Profiles.
## Shopify - objeto DraftOrder
Para ver uma lista de todos os campos em um objeto da Shopify, consulte [O DraftOrder DraftOrder objeto na documentação da](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object) Shopify.
## Mapeando um DraftOrder objeto da Shopify para um pedido padrão
Um subconjunto dos campos no mapa de objetos da Shopify para o DraftOrder objeto de pedido padrão nos Perfis de clientes.
A tabela a seguir lista quais campos podem ser mapeados do DraftOrder objeto Shopify- para o pedido padrão.
O `StatusCode` será `ACTIVATED` se `order_status_url` existir na origem. Caso contrário, `StatusCode` será `DRAFT`.
| Shopify - DraftOrder campo de origem | Campo de destino padrão do pedido |
| --- | --- |
| id | Atributos. ShopifyOrderId |
| customer.id | Atributos. ShopifyCustomerId |
| note | AdditionalInformation |
| email | CustomerEmail |
| currency | Currency |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
| name | Nome |
| status | Status |
| order\$1status\$1url | StatusCode |
| billing\$1address.address1 | BillingAddress.Endereço 1 |
| billing\$1address.address2 | BillingAddress.Endereço 2 |
| billing\$1address.city | BillingAddress.Cidade |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Província |
| billing\$1address.country | BillingAddress.País |
| billing\$1address.name | BillingAddress.Nome |
| shipping\$1address.address1 | ShippingAddress.Endereço 1 |
| shipping\$1address.address2 | ShippingAddress.Endereço 2 |
| shipping\$1address.city | ShippingAddress.Cidade |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Província |
| shipping\$1address.country | ShippingAddress.País |
| shipping\$1address.name | ShippingAddress.Nome |
| invoice\$1url | StatusUrl |
| total\$1price | TotalPrice |
| total\$1tax | TotalTax |
| line\$1items[].title | OrderItems[] .Título |
| line\$1items[].price | OrderItems[] .Preço |
| line\$1items[].quantity | OrderItems[] .Quantidade |
### Exemplo
O exemplo a seguir mostra como mapear um campo de origem para um campo de destino.
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Os dados do DraftOrder cliente da Shopify do objeto Shopify são associados a um pedido padrão do Amazon Connect usando o índice a seguir.
| Nome do índice padrão | Shopify - DraftOrder campo de origem |
| --- | --- |
| \$1shopifyOrderId | id |
Por exemplo, você pode usar `_shopifyOrderId` as `ObjectFilter.KeyName` com a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar um pedido padrão. Você pode encontrar os DraftOrder objetos Shopify associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como. `Shopify-DraftOrder`
## Objeto Shopify-Order
Para ver uma lista de todos os campos em um objeto Shopify-Order, consulte [The Order object](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object) na documentação da Shopify.
## Mapeamento de um objeto Shopify-Order para um pedido padrão
Um subconjunto dos campos no mapa de objeto Shopify-Order para o objeto de pedido padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Shopify-Order para o pedido padrão.
O `StatusCode` será `ACTIVATED` se `order_status_url` existir na origem. Caso contrário, `StatusCode` será `DRAFT`.
| Campo de origem de Shopify-Order | Campo de destino padrão do pedido |
| --- | --- |
| id | Atributos. ShopifyOrderId |
| customer.id | Atributos. ShopifyCustomerId |
| cancelled\$1at | CancelledDate |
| cancel\$1reason | CancelReason |
| closed\$1at | ClosedDate |
| created\$1at | CreatedDate |
| currency | Currency |
| email | CustomerEmail |
| financial\$1status | Status |
| order\$1status\$1url | StatusCode |
| fulfillment\$1status | FulfillmentStatus |
| gateway | Gateway |
| name | Nome |
| note | AdditionalInformation |
| order\$1status\$1url | StatusUrl |
| phone | CustomerPhone |
| processed\$1at | ProcessedDate |
| total\$1discounts | TotalDiscounts |
| total\$1line\$1items\$1price | TotalItemsPrice |
| total\$1price | TotalPrice |
| total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice |
| total\$1tax | TotalTax |
| total\$1tip\$1received | TotalTipReceived |
| total\$1weight | TotalWeight |
| updated\$1at | UpdatedDate |
| billing\$1address.address1 | BillingAddress.Endereço 1 |
| billing\$1address.address2 | BillingAddress.Endereço 2 |
| billing\$1address.city | BillingAddress.Cidade |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Província |
| billing\$1address.country | BillingAddress.País |
| billing\$1address.name | BillingAddress.Nome |
| payment\$1details.credit\$1card\$1number | CreditCardNumber |
| payment\$1details.credit\$1card\$1company | CreditCardCompany |
| shipping\$1address.address1 | ShippingAddress.Endereço 1 |
| shipping\$1address.address2 | ShippingAddress.Endereço 2 |
| shipping\$1address.city | ShippingAddress.Cidade |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Província |
| shipping\$1address.country | ShippingAddress.País |
| shipping\$1address.name | ShippingAddress.Nome |
| line\$1items[].title | OrderItems[] .Título |
| line\$1items[].price | OrderItems[] .Preço |
| line\$1items[].quantity | OrderItems[] .Quantidade |
### Exemplo
O exemplo a seguir mostra como mapear um campo de origem para um campo de destino.
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Os dados de cliente Shopify-Order do objeto Shopify são associados a um perfil de cliente do Amazon Connect usando o índice a seguir.
| Nome do índice padrão | Campo de origem de Shopify-Order |
| --- | --- |
| \$1shopifyOrderId | id |
Por exemplo, você pode usar `_shopifyOrderId` as `ObjectFilter.KeyName` com a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar um pedido padrão. Você pode encontrar os objetos do Shopify-Order associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com o `ProfileId` e definido como. `ObjectTypeName` `Shopify-Order`
# Mapeamento do tipo de objeto para o registro de comunicação padrão
Os tópicos desta seção fornecem a definição do registro de comunicação padrão e o mapeamento do tipo de objeto dos eventos de campanha para o registro de comunicação padrão.
**Topics**
+ [Campos de objeto de registro de comunicação padrão do Customer Profiles](customer-profiles-standard-communication-record-object-fields.md)
+ [Mapear objetos de campanha para o registro de comunicação padrão no Amazon Connect Customer Profiles](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md)
# Campos de objeto de registro de comunicação padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de registro de comunicação padrão do Customer Profiles.
| Campo de communicationRecord padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| CommunicationRecordId | String | O identificador exclusivo de um registro de comunicação padrão. |
| Canal | String | O método usado para entrar em contato com sua central de atendimento. Por exemplo: VOICE, CHAT, EMAIL. |
| ConnectInstanceArn | String | O ARN da instância AWS Connect. |
| CreatedDate | String | O carimbo de data/hora que indica quando o registro de comunicação foi criado. |
| UpdatedDate | String | O carimbo de data/hora que indica quando o registro de comunicação foi atualizado pela última vez. |
| LastEventType | String | O tipo do último evento ingerido para essa comunicação. |
| Campaign | Campaign | Detalhes sobre a campanha associada a essa comunicação. |
| Endpoint | Endpoint | Informações sobre o endpoint usado para essa comunicação. |
| Eventos | Map | Um mapa de eventos em que a chave é o tipo de evento, como e-mail entregue, aberto ou clicado. Isso rastreia o último evento de cada tipo de evento exclusivo que ocorreu durante essa comunicação. |
| Atributos | Map | Par de chave/valor dos atributos de um registro de comunicação padrão. |
Os objetos de registro de comunicação padrão são indexados pelas chaves na tabela a seguir.
| Nome do índice padrão | Campo de registro de comunicação padrão |
| --- | --- |
| \$1communicationRecordId | CommunicationRecordId |
Por exemplo, você pode usar `_communicationRecordId` como nome de chave com a [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API para encontrar um perfil que tenha um registro de comunicação que `CommunicationRecordId` corresponda ao valor da pesquisa. Você pode encontrar os `communicationRecord` objetos padrão associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como`_communicationRecord`.
## Tipos de dados de campanha
| Campo | Tipo de dados | Descrição |
| --- | --- | --- |
| CampaignId | String | O identificador exclusivo da campanha externa. |
| CampaignName | String | O nome da campanha externa. |
| CampaignRunId | String | O ID exclusivo de uma execução específica da campanha. |
| CampaignActivityId | String | O ID exclusivo da atividade na campanha. |
| SegmentArn | String | O ARN de um segmento de usuários. |
## Tipos de dados de endpoint
| Campo | Tipo de dados | Descrição |
| --- | --- | --- |
| EndpointAddress | String | O endereço do endpoint (por exemplo, endereço de e-mail ou número de telefone). |
| EndpointType | String | O tipo do endpoint, como e-mail padrão ou e-mail comercial. |
## Tipos de dados de evento
| Campo | Tipo de dados | Descrição |
| --- | --- | --- |
| UpdatedDate | String | O carimbo de data/hora que indica quando o evento de comunicação ocorreu. |
| EventId | String | Um identificador exclusivo para cada evento de comunicação. |
| EventType | String | O tipo do evento de comunicação específico. |
| Atributos | Map | O par de chave/valor dos atributos específicos para o tipo de evento. |
# Mapear objetos de campanha para o registro de comunicação padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos de campanha são mapeados para o registro de comunicação padrão no Customer Profiles.
## Objeto Campaign-Email
Para obter uma lista de todos os campos em um objeto Campaign-Email, consulte o [Objeto de e-mail](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-retrieving-sns-contents.html) na documentação do Amazon SES.
**Mapear um objeto Campaign-Email para um registro de comunicação padrão**
Um subconjunto dos campos no objeto Campaign-Email é mapeado para o objeto de registro de comunicação padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Campaign-Email para o registro de comunicação padrão.
| Campo de origem de Campaign-Email | Campo de destino do registro de comunicação padrão |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| outbound\$1request\$1id | Atributos. OutboundCampaignRequestId |
| campaign\$1message\$1id | Atributos. CampaignMessageId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| endpoint\$1address | Ponto final. EndpointAddress |
| endpoint\$1type | Ponto final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campanha. CampaignName |
| campaign\$1id | Campanha. CampaignId |
| campaign\$1run\$1id | Campanha. CampaignRunId |
| campaign\$1activity\$1id | Campanha. CampaignActivityId |
| segment\$1arn | Campanha. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| email.bounce.bounceType | Eventos.Bounce.Attributes. BounceType |
| e-mail. bounce. bounceSubType | Eventos.Bounce.Attributes. BounceSubType |
| email.click.link | Events.Click.Attributes.Link |
| email.click.ipAddress | Eventos. Clique em Atributos. IpAddress |
| email.open.ipAddress | Eventos.Abrir.Atributos. IpAddress |
| email.reject.reason | Events.Reject.Attributes.Reason |
| email.renderingFailure.templateName | Eventos. RenderingFailure.Atributos. TemplateName |
| email.renderingFailure.errorMessage | Eventos. RenderingFailure.Atributos. ErrorMessage |
| email.deliveryDelay.delayType | Eventos. DeliveryDelay.Atributos. DelayType |
| email.reclamação. complaintFeedbackType | Eventos.Reclamação.Atributos. ComplaintFeedbackType |
| email.reclamação. complaintSubType | Eventos.Reclamação.Atributos. ComplaintSubType |
| email.mail.commonHeaders.subject | Attributes.Subject |
## Objeto Campaign-SMS
Para obter uma lista de todos os campos de um objeto Campaign-SMS, consulte o [Objeto de SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) na documentação do AWS End User Messaging SMS.
**Mapear um objeto Campaign-SMS para um registro de comunicação padrão**
Um subconjunto dos campos no objeto Campaign-SMS é mapeado para o objeto de registro de comunicação padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Campaign-SMS para o registro de comunicação padrão.
| Campo de origem de Campaign-SMS | Campo de destino do registro de comunicação padrão |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| outbound\$1request\$1id | Atributos. OutboundCampaignRequestId |
| campaign\$1message\$1id | Atributos. CampaignMessageId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| endpoint\$1address | Ponto final. EndpointAddress |
| endpoint\$1type | Ponto final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campanha. CampaignName |
| campaign.campaign\$1id | Campanha. CampaignId |
| campaign.campaign\$1run\$1id | Campanha. CampaignRunId |
| campaign\$1activity\$1id | Campanha. CampaignActivityId |
| segment\$1arn | Campanha. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| sms.messageType | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. MessageType |
| sms.messageStatus | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. MessageStatus |
| sms. messageStatusDescription | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. MessageStatusDescription |
| sms. totalMessagePrice | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. TotalMessagePrice |
| sms. totalCarrierFee | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. TotalCarrierFee |
| sms. isoCountryCode | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. IsoCountryCode |
## Objeto Campaign-Telephony
Para obter uma lista de todos os campos em um objeto Campaign-Telephony, consulte o [objeto Voice](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) na documentação do AWS End User Messaging SMS.
**Mapear um objeto Campaign-Telephony para um registro de comunicação padrão**
Um subconjunto dos campos no objeto Campaign-Telephony é mapeado para o objeto de registro de comunicação padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Campaign-Telephony para o registro de comunicação padrão.
| Campo de origem de Campaign-Telephony | Campo de destino do registro de comunicação padrão |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| outbound\$1request\$1id | Atributos. OutboundCampaignRequestId |
| campaign\$1message\$1id | Atributos. CampaignMessageId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| endpoint.endpoint\$1address | Ponto final. EndpointAddress |
| endpoint.endpoint\$1type | Ponto final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campanha. CampaignName |
| campaign.campaign\$1id | Campanha. CampaignId |
| campaign.campaign\$1run\$1id | Campanha. CampaignRunId |
| campaign.campaign\$1activity\$1id | Campanha. CampaignActivityId |
| campaign.segment\$1arn | Campanha. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| Voice.AgentInfo. connectedToAgentCarimbo de data/hora | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. ConnectedToAgentTimestamp |
| voz. customerVoiceActivity. greetingEndTimestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. GreetingEndTimestamp |
| voz. answeringMachineDetectionStatus | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. AnsweringMachineDetectionStatus |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Objeto Campaign-Orchestration
**Mapear um objeto Campaign-Orchestration para um registro de comunicação padrão**
Um subconjunto dos campos no objeto Campaign-Orchestration é mapeado para o objeto de registro de comunicação padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Campaign-Orchestration para o registro de comunicação padrão.
| Campo de origem de Campaign-Orchestration | Campo de destino do registro de comunicação padrão |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campanha. CampaignName |
| campaign.campaign\$1id | Campanha. CampaignId |
| campaign.campaign\$1run\$1id | Campanha. CampaignRunId |
| campaign.campaign\$1activity\$1id | Campanha. CampaignActivityId |
| campaign.segment\$1arn | Campanha. SegmentArn |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Exemplo
O exemplo a seguir mostra como mapear um campo de origem para um campo de destino:
```
"channel": {
"source": "_source.engagement.channel.name",
"target": "_communicationRecord.Channel"
}
```
# Mapeamento de tipo de objeto para o ativo padrão no Customer Profiles
Os tópicos desta seção fornecem a definição do ativo padrão e o mapeamento do tipo de objeto de aplicações externas para o ativo padrão.
**Topics**
+ [Requisitos de AppFlow acesso da Amazon](appflow-access-requirements-asset.md)
+ [Definição de ativo padrão](standard-asset-definition.md)
+ [Mapeamento de objetos do Salesforce para ativo padrão](mapping-salesforce-objects-to-asset.md)
# Requisitos de AppFlow acesso da Amazon em perfis de clientes
Use os seguintes requisitos de AppFlow acesso da Amazon para criar e excluir integrações do Salesforce com os perfis de clientes do Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Definição de ativo padrão no Amazon Connect Customer Profiles
A tabela a seguir lista todos os campos no objeto de ativo padrão do Customer Profiles.
| Campo de ativo padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| AssetId | String | O identificador exclusivo de um ativo padrão. |
| AssetName | String | O nome do ativo. |
| SerialNumber | String | O número de série do ativo. |
| ModelNumber | String | O número do modelo do ativo. |
| ModelName | String | O nome do modelo do ativo. |
| ProductSKU | String | A unidade de manutenção de estoque do ativo. |
| PurchaseDate | String | A data de compra do ativo. |
| UsageEndDate | String | A data de término de uso do ativo. |
| Status | String | O status do ativo. |
| Preço | String | O preço do ativo. |
| Quantidade | String | A quantidade do ativo. |
| Description | String | A descrição do ativo. |
| AdditionalInformation | String | Qualquer informação adicional relevante para o ativo. |
| DataSource | String | A fonte de dados do ativo. |
| Atributos | String-to-string mapa | Par chave/valor de atributos de um ativo padrão. |
Os objetos de ativo padrão são indexados pelas chaves na tabela a seguir.
| Nome do índice padrão | Campo de ativo padrão |
| --- | --- |
| \$1assetId | AssetId |
| \$1assetName | AssetName |
| \$1serialNumber | SerialNumber |
Por exemplo, você pode usar `_assetName` como nome de chave com a [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para encontrar um perfil que tenha um ativo que AssetName corresponda ao valor da pesquisa. Você pode encontrar os objetos de ativos padrão associados a um perfil específico usando a [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) com `ProfileId` e `ObjectTypeName` definida como`_asset`.
# Mapeamento de objetos do Salesforce para o perfil padrão no Customer Profiles
Este tópico lista quais campos nos objetos do Salesforce são mapeados para o objeto de ativo padrão no Customer Profiles.
## Objeto Salesforce-Asset
Esta é uma lista de todos os campos em um objeto Salesforce-Asset.
+ Id
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ Nome
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ Status
+ Preço
+ Quantidade
+ Description
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate
## Mapeamento de um objeto Salesforce-Asset para um ativo padrão
Um subconjunto dos campos no mapa de objeto Salesforce-Asset para o objeto de ativo padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Salesforce-Asset para o ativo padrão.
| Campo de origem Saleforce-Asset | Campo de destino do ativo padrão |
| --- | --- |
| Id | Atributos. sfdcAssetId |
| ContactId | Atributos. sfdcContactId |
| AccountId | Atributos. sfdcAccountId |
| SerialNumber | SerialNumber |
| StockKeepingUnit | ProductSKU |
| UsageEndDate | UsageEndDate |
| Status | Status |
| Preço | Preço |
| Quantidade | Quantidade |
| Description | Description |
Os dados do cliente Salesforce-Asset do objeto Salesforce são associados a um perfil de cliente do Amazon Connect usando os índices na tabela a seguir.
| Nome do índice padrão | Campo de origem Salesforce-Asset |
| --- | --- |
| \$1salesforceAssetId | Id |
| \$1salesforceContactId | ContactId |
| \$1salesforceAccountId | AccountId |
Por exemplo, você pode usar `_salesforceAssetId` e `_salesforceAccountId` como um `ObjectFilter.KeyName` com a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar um ativo padrão. Você pode encontrar os objetos do Salesforce-Asset associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com e definida como. `ProfileId` `ObjectTypeName` `Salesforce-Asset`
# Mapeamento de tipo de objeto para o caso padrão no Customer Profiles
Os tópicos desta seção fornecem a definição do caso padrão e o mapeamento do tipo de objeto de aplicações externas para o caso padrão.
**Topics**
+ [Requisitos de AppFlow acesso da Amazon](appflow-access-requirements-case.md)
+ [Definição de caso padrão](standard-case-definition.md)
+ [Mapeamento de objetos do Zendesk](mapping-zendesk-objects-case.md)
+ [ServiceNow Objetos de mapeamento](mapping-servicenow-objects-standard-case.md)
# Requisitos de AppFlow acesso da Amazon em perfis de clientes
Use os seguintes requisitos de AppFlow acesso da Amazon para criar e excluir o Zendesk e as ServiceNow integrações com os perfis de clientes do Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Campos de objeto de caso padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de caso padrão do Customer Profiles.
| Campo de caso padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| CaseId | String | O identificador exclusivo de um caso padrão. |
| Título | String | O título do caso |
| Resumo | String | O resumo do caso. |
| Status | String | O status do caso. |
| Motivo | String | O motivo do caso. |
| CreatedBy | String | O criador do caso. |
| CreatedDate | String | A data de criação do caso. |
| UpdatedDate | String | A data do caso foi atualizada. |
| ClosedDate | String | A data do caso foi encerrada. |
| AdditionalInformation | String | Qualquer informação adicional relevante para o caso. |
| DataSource | String | A fonte de dados do caso. |
| Atributos | String-to-string mapa | Par chave/valor de atributos de um caso padrão. |
Os objetos de caso padrão são indexados pelas chaves na tabela a seguir.
| Nome do índice padrão | Campo de caso padrão |
| --- | --- |
| \$1caseId | CaseId |
Por exemplo, você pode usar `_caseId` como nome de chave com a [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para encontrar um perfil que tenha um caso que CaseId corresponda ao valor da pesquisa. Você pode encontrar os objetos de caso padrão associados a um perfil específico usando a [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) com `ProfileId` e `ObjectTypeName` definida como`_case`.
# Mapeamento de objetos do Zendesk para o caso padrão no Amazon Connect Customer Profiles
Este tópico lista quais campos nos objetos do Zendesk são mapeados para o caso padrão no Customer Profiles.
## Objeto Zendesk-tickets
Esta é uma lista de todos os campos em um objeto Zendesk-tickets.
+ id
+ url
+ type
+ subject
+ raw\$1subject
+ descrição
+ priority
+ status
+ recipient (destinatário)
+ requester\$1id
+ submitter\$1id
+ assignee\$1id
+ organization\$1id
+ group\$1id
+ collaborator\$1ids
+ email\$1cc\$1ids
+ follower\$1ids
+ forum\$1topic\$1id
+ problem\$1id
+ has\$1incidents
+ due\$1at
+ tags
+ via.channel
+ custom\$1fields
+ satisfaction\$1rating
+ sharing\$1agreement\$1ids
+ followup\$1ids
+ ticket\$1form\$1id
+ brand\$1id
+ allow\$1channelback
+ allow\$1attachments
+ is\$1public
+ created\$1at
+ updated\$1at
## Mapeamento do objeto Zendesk-tickets para um caso padrão
Um subconjunto dos campos no mapa de objeto Zendesk-tickets para o caso padrão no Customer Profiles. A tabela a seguir lista quais campos podem ser mapeados do objeto Zendesk-tickets para o caso padrão.
| Campo de origem Zendesk-tickets | Campo de destino do caso padrão |
| --- | --- |
| requester\$1id | Atributos. ZendeskUserId |
| id | Atributos. ZendeskTicketId |
| subject | Título |
| descrição | Resumo |
| status | Status |
| requester\$1id | CreatedBy |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
Os dados de cliente Zendesk-tickets do objeto Zendesk são associados a um caso padrão do Amazon Connect usando os índices a seguir.
| Nome do índice padrão | Campo de origem Zendesk-tickets |
| --- | --- |
| \$1zendeskUserId | requester\$1id |
| \$1zendeskTicketId | id |
Por exemplo, você pode usar `_zendeskUserId` e `_zendeskTicketId` como um `ObjectFilter.KeyName` com a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar um caso padrão. Você pode encontrar os objetos Zendesk Tickets associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como. `Zendesk-tickets`
# Mapeamento de ServiceNow objetos para o caso padrão nos perfis de clientes do Amazon Connect
Este tópico lista quais campos em ServiceNow objetos são mapeados para campos no caso padrão nos perfis de clientes do Amazon Connect.
## Objeto Servicenow-task
Esta é uma lista de todos os campos em um objeto Servicenow-task.
+ sys\$1id
+ active
+ activity\$1due
+ additional\$1assignee\$1list
+ approval
+ approval\$1history
+ approval\$1set
+ assigned\$1to
+ assignment\$1group
+ business\$1duration
+ business\$1service
+ calendar\$1duration
+ closed\$1at
+ closed\$1by
+ cmdb\$1ci.display\$1value
+ cmdb\$1ci.link
+ comentários
+ comments\$1and\$1work\$1notes
+ company
+ contact\$1type
+ contract
+ correlation\$1display
+ active
+ correlation\$1id
+ delivery\$1plan
+ delivery\$1task
+ descrição
+ due\$1date
+ escalation
+ expected\$1start
+ follow\$1up
+ group\$1list
+ impact
+ knowledge
+ location
+ made\$1sla
+ número
+ opened\$1at
+ opened\$1by.display\$1value
+ order
+ parent
+ priority
+ reassignment\$1count
+ service\$1offering
+ short\$1description
+ sla\$1due
+ estado
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ active
+ sys\$1domain.global
+ sys\$1domain.link
+ sys\$1domain\$1path
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1updated\$1on
+ time\$1worked
+ upon\$1approval
+ upon\$1reject
+ urgency
+ user\$1input
+ watch\$1list
+ work\$1end
+ work\$1notes
+ work\$1notes\$1list
+ work\$1start
## Mapeamento de ServiceNow-Task para um caso padrão
Um subconjunto dos campos no mapa de objeto Servicenow-task para o caso padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Servicenow-task para o caso padrão.
| Campo de origem Servicenow-task | Campo de destino do caso padrão |
| --- | --- |
| sys\$1id | Atributos. ServiceNowTaskId |
| opened\$1by.link | Atributos. ServiceNowSystemUserId |
| short\$1description | Título |
| descrição | Resumo |
| status | Status |
| sys\$1created\$1by | CreatedBy |
| sys\$1created\$1on | CreatedDate |
| sys\$1updated\$1on | UpdatedDate |
Os dados de cliente Servicenow-task do Servicenow são associados a um caso padrão do Amazon Connect usando os índices na tabela a seguir.
| Nome do índice padrão | Campo de origem Servicenow-task |
| --- | --- |
| \$1 serviceNowTask Identificação | sys\$1id |
| \$1 serviceNowSystem Identificação | open\$1by.link |
Por exemplo, você pode usar `_serviceNowTaskId` e `_serviceNowSystemId` como um `ObjectFilter.KeyName` com a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar um caso padrão. Você pode encontrar os objetos ServiceNow-Task associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como. `Servicenow-task`
## Objeto Servicenow-incident
Esta é uma lista de todos os campos em um objeto Servicenow-incident.
+ sys\$1id
+ business\$1stc
+ calendar\$1stc
+ caller\$1id.link
+ caller\$1id.value
+ categoria
+ caused\$1by
+ child\$1incidents
+ close\$1code
+ hold\$1reason
+ incident\$1state
+ notify
+ parent\$1incident
+ problem\$1id
+ reopened\$1by
+ reopened\$1time
+ reopen\$1count
+ resolved\$1at
+ resolved\$1by.link
+ resolved\$1by.value
+ rfc
+ severidade
+ subcategory
## Mapeamento de Servicenow-incident para um caso padrão
Um subconjunto dos campos no mapa de objeto Servicenow-incident para o caso padrão no Customer Profiles.
A tabela a seguir lista quais campos podem ser mapeados do objeto Servicenow-incident para o caso padrão.
| Campo de origem Servicenow-Incident | Campo de destino do caso padrão |
| --- | --- |
| sys\$1id | Atributos\$1 ServiceNowIncidentId |
| caller\$1id.link | Atributos\$1 ServiceNowSystemUserId |
| incident\$1status | Status |
| caller\$1id.link | CreatedBy |
| resolved\$1at | ClosedDate |
| categoria | Motivo |
Os dados de cliente Servicenow-incident do Servicenow são associados a um caso padrão do Amazon Connect usando os índices na tabela a seguir.
| Nome do índice padrão | Campo de origem do Servicenow |
| --- | --- |
| \$1 serviceNowIncident Identificação | sys\$1id |
| \$1 serviceNowSystem Identificação | caller\$1id.link |
Por exemplo, você pode usar `_serviceNowIncidentId` e `_serviceNowSystemId` como um ObjectFilter. KeyName com a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar um caso padrão. Você pode encontrar os objetos ServiceNow-Incident associados a um perfil específico usando a [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API com `ProfileId` e `ObjectTypeName` definida como. `Servicenow-incident`
# Mapeamento de tipo de objeto para a preferência aérea padrão
Os tópicos desta seção fornecem a definição de preferência aérea padrão.
**Topics**
+ [
# Campos de objeto de preferência aérea padrão do Customer Profiles
](standard-air-preference-object-fields.md)
# Campos de objeto de preferência aérea padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de preferência aérea padrão do Customer Profiles.
**Preferência aérea**
| Campo de airPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| PreferenceId | String | O identificador exclusivo de uma preferência aérea padrão. |
| Nome | String | O nome da preferência. |
| CreatedDate | String | A data em que a preferência foi criada. |
| CreatedBy | String | O identificador do criador. |
| UpdatedDate | String | A data da última atualização. |
| UpdatedBy | String | O identificador da pessoa que atualizou pela última vez. |
| StartDate | String | A data de início da preferência. |
| EndDate | String | A data de término da preferência. |
| Status | String | O status atual da preferência. |
| ReferenceId | String | O ID do objeto referenciado. |
| ReferenceType | String | O tipo de objeto referenciado. |
| TravelType | String | O tipo de viagem (por exemplo, voos diretos). |
| Transferir | String | O tipo preferido de transferência. |
| ArrivalAirport | String | O aeroporto de chegada preferido. |
| ArrivalTerminal | String | O terminal do aeroporto de chegada preferido. |
| DepartureAirport | String | O aeroporto de partida preferido. |
| DepartureTerminal | String | O terminal do aeroporto de partida preferido. |
| HomeAirport | String | O aeroporto doméstico. |
| CheckInChannel | String | O modo de check-in. |
| CheckInChannelDevice | String | O dispositivo usado para fazer check-in. |
| Linguagem | Linguagem | Detalhes sobre os idiomas preferidos para comunicação. |
| Seat | Seat | Detalhe sobre a seleção de assentos. |
| Jornada | Jornada | Preferências de viagem. |
| Acessibilidade | Acessibilidade | Detalhes sobre os pedidos de acessibilidade. |
| Seguros | Seguros | Detalhes sobre seguros. |
| Interest | Interest | Detalhes sobre os interesses. |
| Loyalty | Loyalty | Detalhes sobre os cadastros em programas de fidelidade. |
| Jantar | Jantar | Preferências alimentares. |
| MediaEntertainment | MediaEntertainment | Preferências de mídia e entretenimento. |
| PaymentForm | PaymentForm | Preferências de método de pagamento. |
| PetInfo | PetInfo | Detalhes sobre animais de estimação. |
| SpecialRequest | SpecialRequest | Detalhes sobre pedidos especiais. |
| TicketDistribution | TicketDistribution | Preferências de distribuição de bilhetes. |
| Marketing | Marketing | Preferências de marketing. |
| Medical | Medical | Preferências relacionadas a aspectos médicos. |
| Baggage | Baggage | Preferências de bagagem. |
| ContactDetail | ContactDetail | Detalhes sobre a forma de contato preferencial. |
| ContactDetailAddress | ContactDetailAddress | Endereço associado à forma de contato preferencial. |
| ContactDetailCommunication | ContactDetailCommunication | Preferências de comunicação. |
| Atributos | Map | O par de chave/valor dos atributos de uma preferência aérea. |
Os objetos de preferência aérea padrão são indexados pelas chaves na tabela a seguir.
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1airPreferenceId | PreferenceId |
| \$1airReferenceId | ReferenceId |
Por exemplo, você pode usar `_airPreferenceId` como nome de chave com a [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para encontrar um perfil que tenha uma preferência aérea que PreferenceId corresponda ao valor da pesquisa. Você pode encontrar os objetos padrão do AirPreference associados a um perfil específico usando a [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) com `ProfileId` e `ObjectTypeName` definida como. `_airPreference`
**ContactDetail tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Type | String | O tipo de contato (por exemplo, pessoal ou emergencial) |
| PreferenceLevel | String | O nível de prioridade desse contato. |
| PhoneNumber | String | Número de telefone |
| Relacionamento | String | A relação com o perfil. |
| EmailAddress | String | Endereço de e-mail |
| EmailLanguage | String | Idioma preferido para comunicação pelo e-mail informado nos detalhes de contato. |
| PhoneLanguage | String | Idioma preferido para comunicação pelo telefone informado nos detalhes de contato. |
**ContactDetailAddress tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Type | String | O tipo de endereço do contato. |
| Address1 | String | A primeira linha do endereço de um contato. |
| Address2 | String | A segunda linha do endereço de um contato. |
| Address3 | String | A terceira linha do endereço de um contato. |
| Address4 | String | A quarta linha do endereço de um contato. |
| Cidade | String | A cidade do endereço de um contato. |
| País | String | O país do endereço de um contato. |
| Condado | String | O condado do endereço de um contato. |
| PostalCode | String | O código postal do endereço de um contato. |
| Província | String | A província do endereço de um contato. |
| Estado | String | O estado do endereço de um contato. |
**ContactDetailCommunication tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Método | String | Método de comunicação (por exemplo, SMS ou e-mail) |
| PreferenceLevel | String | O nível de preferência para o método de comunicação. |
**Tipos de dados de Language**
| Campo de airPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| PhoneLanguage | String | Idioma preferido para comunicação por telefone. |
| EmailLanguage | String | Idioma preferido para comunicação por e-mail. |
| InPersonLanguage | String | Idioma preferido para comunicação presencial. |
| PreferenceLevel | String | O nível de preferência do idioma. |
**Tipos de dados de Seat**
| Campo de airPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| PreferenceLevel | String | A prioridade das preferências de assento. |
| Direction | String | A direção preferida do assento (por exemplo, frente ou trás). |
| Local | String | A localização preferida do assento (por exemplo, janela ou corredor). |
| Position | String | A posição do assento (por exemplo, esquerdo ou direito). |
| Linha | String | A fila de assentos desejada. |
| ClassOfService | String | A classe de viagem (por exemplo, econômica ou executiva). |
| NeighborFree | String | Preferência por um assento sem vizinhos. |
| Infant | String | Preferência por assento infantil. |
| ExtraSeat | String | Preferência por assento extra. |
**Tipos de dados de Journey**
| Campo de airPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| MaxConnections | String | O máximo de conexões permitidas. |
| PreferredAirline | String | A companhia aérea preferida. |
| UpgradeAuction | String | Opção de participar de leilões de upgrade. |
| FlightTime | String | Horário de voo preferido. |
| FlightMaxDuration | String | Preferência de duração máxima de viagem. |
**Tipos de dados de Accessibility**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Wheelchair | String | Informações de acessibilidade para cadeiras de rodas. |
| Banheiro | String | Informações de acessibilidade do banheiro. |
| Assistance | String | Informações de assistência. |
| DisabilityType | String | Informações sobre deficiência. |
| SupportAnimal | String | Informações sobre animais de apoio. |
| ProximityToFacilities | String | Necessidade de proximidade às instalações. |
**Tipos de dados de Insurance**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Nome | String | Nome da seguradora ou do plano. |
| PreferenceLevel | String | O nível de preferência pelo seguro. |
**Tipos de dados de Interest**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Nome | String | Área de interesse específica. |
| PreferenceLevel | String | A prioridade desse interesse. |
**Tipos de dados de Loyalty**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Nome | String | Nome do programa de fidelidade. |
| MembershipId | String | ID de membro do programa de fidelidade. |
| PreferenceLevel | String | O nível de preferência pelo programa de fidelidade. |
**Tipos de dados de Dining**
| Campo de airPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| MealType | String | Tipo de refeição preferido. |
| FavoriteCuisine | String | Tipos de culinária favoritos. |
| Beverage | String | Bebidas preferidas. |
| DietaryRestriction | String | Restrições alimentares. |
| AllergyInfo | String | Detalhes sobre alergias. |
| PreferenceLevel | String | O nível de preferência alimentar. |
**Tipos de dados de MediaEntertainment**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Nome | String | Nome da forma de entretenimento preferida. |
| PreferenceLevel | String | O nível de preferência por mídia/entretenimento. |
**PaymentForm tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Nome | String | Nome do método de pagamento. |
| Tipo | String | Tipo de pagamento (por exemplo, cartão de crédito PayPal) |
| PreferenceLevel | String | O nível de preferência do método de pagamento. |
| UsageContext | String | Onde o método de pagamento é usado. |
**PetInfo tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Type | String | Tipo de animal de estimação. |
| PreferenceLevel | String | O nível de preferência em relação a animais de estimação. |
**SpecialRequest tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Type | String | Tipo de pedido especial. |
| Nome | String | Nome ou descrição do pedido. |
| PreferenceLevel | String | O nível de prioridade do pedido. |
**TicketDistribution tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| PreferenceLevel | String | O nível de preferência pela distribuição de bilhetes. |
| Método | String | Método de entrega de bilhetes (por exemplo, e-mail ou físico). |
| TicketTime | String | Horário preferido para entrega de bilhetes. |
**Tipos de dados de Marketing**
| Campo de airPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| ChannelType | String | Tipo de canal de marketing (por exemplo, SMS ou e-mail). |
| OptIn | String | Status de aceitação para marketing. |
| Frequência | String | Frequência das comunicações de marketing. |
| StartDate | String | Data de início da preferência de marketing. |
| EndDate | String | Data de término da preferência de marketing. |
**Tipos de dados de Medical**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Oxygen | String | Fornecido pela companhia aérea, de propriedade do passageiro, concentrador etc. |
| MedicalEquipment | String | Detalhes sobre equipamentos médicos (por exemplo, máquina de CPAP ou concentrador de oxigênio). |
| Assistance | String | Especifica se o viajante precisa de assistência médica geral durante a viagem (por exemplo, suporte a bordo ou ajuda com medicamentos). |
| Stretcher | String | Especifica se o viajante precisa de uma maca durante o voo, normalmente usada para casos de transporte médico. |
| WheelChair | String | Detalhes da cadeira de rodas (não derramável, célula úmida, imóvel, assistência na escada, companhia aérea fornecida RampNeeded, etc.) |
**Tipos de dados de Baggage**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Animal | String | Indica se o viajante está viajando com um animal de serviço ou animal de estimação, incluindo especificações ou restrições relevantes (inHold, Cabin). |
| BaggageType | String | Especifica o tipo preferido de manuseio de bagagem (por exemplo, somente bagagem de mão, bagagem despachada ou bagagem de tamanho excedente). |
| Assistance | String | Indica se o viajante precisa de ajuda para carregar ou gerenciar sua bagagem, como serviços de carregador no aeroporto ou ajuda com bagagem na calçada. |
| PreferenceLevel | String | O nível de preferência para campos de Baggage. |
# Mapeamento de tipo de objeto para a preferência de hotel padrão
Os tópicos desta seção fornecem a definição de preferência de hotel padrão.
**Topics**
+ [
# Campos de objeto de preferência de hotel padrão do Customer Profiles
](standard-hotel-preference-object-fields.md)
# Campos de objeto de preferência de hotel padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de preferência de hotel padrão do Customer Profiles.
**Preferência de hotel**
| Campo de hotelPreference padrão | Tipo de dados | Descrição |
| --- | --- | --- |
| PreferenceId | String | Identificador exclusivo de uma preferência de hotel padrão. |
| Nome | String | O nome da preferência. |
| CreatedDate | String | A data em que a preferência foi criada. |
| CreatedBy | String | O identificador do criador. |
| UpdatedDate | String | A data da última atualização. |
| UpdatedBy | String | O identificador da pessoa que atualizou pela última vez. |
| StartDate | String | A data de início da preferência. |
| EndDate | String | A data de término da preferência. |
| Status | String | O status atual da preferência. |
| Fumar | String | Preferência em relação à permissão para fumar. |
| CleaningTime | String | Tempo de limpeza. |
| CheckInType | String | Tipo de check-in. |
| CheckOutType | String | Tipo de check-out. |
| ReferenceId | String | O ID do objeto referenciado. |
| ReferenceType | String | O tipo de objeto referenciado. |
| Local | Local | Preferências quanto à localização do quarto do hotel. |
| Bedding | Bedding | Preferências relacionadas à roupa de cama. |
| Tour | Tour | Preferências em relação a passeios. |
| ContactDetail | ContactDetail | Detalhes sobre a forma de contato preferencial. |
| ContactDetailAddress | ContactDetailAddress | Endereço associado à forma de contato preferencial. |
| ContactDetailCommunication | ContactDetailCommunication | Preferências de comunicação. |
| Linguagem | Linguagem | Preferências de idioma. |
| CarRental | CarRental | Preferências em relação ao aluguel de carros. |
| Acessibilidade | Acessibilidade | Preferências de acessibilidade. |
| Interest | Interest | Detalhes sobre interesses. |
| Loyalty | Loyalty | Preferências em relação a programas de fidelidade. |
| Jantar | Jantar | Preferências alimentares. |
| MediaEntertainment | MediaEntertainment | Preferências de mídia e entretenimento. |
| PaymentForm | PaymentForm | Preferências em relação à forma de pagamento. |
| PetInfo | PetInfo | Preferências em relação às informações sobre animais de estimação. |
| SpecialRequest | SpecialRequest | Detalhes sobre pedidos especiais. |
| Marketing | Marketing | Preferências de marketing. |
| Medical | Medical | Preferências médicas. |
| Baggage | Baggage | Preferências de bagagem. |
| Atributos | Map | O par de chave/valor dos atributos de uma preferência de hotel. |
Os objetos de preferência de hotel padrão são indexados pelas chaves na tabela a seguir.
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1hotelPreferenceId | PreferenceId |
| \$1hotelReferenceId | ReferenceId |
Por exemplo, você pode usar `_hotelPreferenceId` como nome de chave com a [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para encontrar um perfil que tenha uma preferência de hotel que PreferenceId corresponda ao valor da pesquisa. Você pode encontrar os objetos HotelPreference padrão associados a um perfil específico usando a [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) com `ProfileId` e `ObjectTypeName` definida como. `_hotelPreference`
**ContactDetail tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Type | String | O tipo de contato (por exemplo, pessoal ou emergencial) |
| PreferenceLevel | String | O nível de prioridade desse contato. |
| PhoneNumber | String | Número de telefone |
| Relacionamento | String | A relação com o perfil. |
| EmailAddress | String | Endereço de e-mail |
| EmailLanguage | String | Idioma preferido para comunicação pelo e-mail informado nos detalhes de contato. |
| PhoneLanguage | String | Idioma preferido para comunicação pelo telefone informado nos detalhes de contato. |
**ContactDetailAddress tipo de dados**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Type | String | O tipo de endereço do contato. |
| Address1 | String | A primeira linha do endereço de um contato. |
| Address2 | String | A segunda linha do endereço de um contato. |
| Address3 | String | A terceira linha do endereço de um contato. |
| Address4 | String | A quarta linha do endereço de um contato. |
| Cidade | String | A cidade do endereço de um contato. |
| País | String | O país do endereço de um contato. |
| Condado | String | O condado do endereço de um contato. |
| PostalCode | String | O código postal do endereço de um contato. |
| Província | String | A província do endereço de um contato. |
| Estado | String | O estado do endereço de um contato. |
**ContactDetailCommunication tipo de dados**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Método | String | O método de comunicação. |
| PreferenceLevel | String | O nível de preferência para o método de comunicação. |
| Frequência | String | A frequência de comunicação. |
**Tipos de dados de Language**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| PhoneLanguage | String | Idioma preferido ao telefone. |
| EmailLanguage | String | Idioma preferido por e-mail. |
**CarRental tipo de dados**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Fornecedor | String | Fornecedor preferido de aluguel de carros. |
| VehicleType | String | Tipo preferido de veículo. |
| PreferenceLevel | String | O nível de preferência para aluguel de carros. |
**Tipos de dados de Location**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| PreferredFloor | String | Preferência por andar do quarto. |
| ElevatorProximity | String | Preferência pela proximidade de elevadores. |
| QuietZone | String | Preferência por zona tranquila. |
| LobbyProximity | String | Preferência pela proximidade ao saguão. |
| Visualizar | String | Vista desejada do quarto. |
| RoomType | String | Tipo de quarto preferido |
| PreferenceLevel | String | O nível de preferência pela localização. |
**Tipos de dados de Bedding**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| BedType | String | Tipo de cama preferido. |
| MattressType | String | Tipo de colchão preferido. |
| PillowType | String | Tipo de travesseiro preferido. |
| NumberOfPillows | String | Quantidade preferida de travesseiros. |
| BeddingMaterial | String | Material da roupa de cama. |
| Allergy | String | Preferências de roupa de cama relacionadas a alergias. |
**Tipos de dados de Tour**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Cidade | String | Cidades preferidas para passeios. |
| Cultural | String | Interesses em relação a passeios culturais. |
| Adventure | String | Interesses em relação a passeios de aventura. |
| Nightlife | String | Interesses em relação a passeios de vida noturna. |
| GuideLanguage | String | Idioma preferido para o guia turístico. |
| StartTime | String | Horário de início preferido para passeios. |
| GroupSize | String | Tamanho de grupo preferido para passeios. |
| PreferenceLevel | String | Importância das preferências em relação a passeios. |
**Tipos de dados de Accessibility**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Wheelchair | String | Informações de acessibilidade para cadeiras de rodas. |
| Banheiro | String | Informações de acessibilidade do banheiro. |
| Assistance | String | Informações de assistência. |
| DisabilityType | String | Informações sobre deficiência. |
| SupportAnimal | String | Informações sobre animais de apoio. |
| ProximityToFacilities | String | Necessidade de proximidade às instalações. |
**Tipos de dados de Interest**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| NameOfInterest | String | Nome do interesse. |
| PreferenceLevel | String | O nível de preferência pelo interesse. |
**Tipos de dados de Loyalty**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| LoyaltyName | String | Nome do programa de fidelidade. |
| MembershipId | String | ID de membro do programa de fidelidade. |
| PreferenceLevel | String | O nível de preferência pelo programa de fidelidade. |
| PriorityServices | String | Preferência por serviços prioritários. |
**Tipos de dados de Dining**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| MealType | String | Tipos preferidos de refeição. |
| FavoriteCuisine | String | Preferências de culinárias favoritas. |
| Beverage | String | Preferências de bebidas. |
| DietaryRestriction | String | Restrições alimentares. |
| AllergyInfo | String | Informações sobre alergias. |
| PreferenceLevel | String | O nível de preferência alimentar. |
**MediaEntertainment tipo de dados**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Nome | String | Nome da mídia ou forma de entretenimento preferida. |
| PreferenceLevel | String | O nível de preferência por mídia ou entretenimento. |
**PaymentForm tipo de dados**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Nome | String | Nome associado ao método de pagamento. |
| Tipo | String | Tipo de método de pagamento. |
| PreferenceLevel | String | O nível de preferência do método de pagamento. |
| UsageContext | String | Contexto em que o formulário de pagamento é usado. |
**PetInfo tipo de dados**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Type | String | Tipo de animal de estimação. |
| PreferenceLevel | String | O nível de preferência por animais de estimação. |
**Tipos de dados de SpecialRequest**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Type | String | Tipo de pedido especial. |
| Nome | String | Nome do pedido especial. |
| PreferenceLevel | String | O nível de preferência do pedido. |
**Tipos de dados de Marketing**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| ChannelType | String | Tipo de canal de marketing (por exemplo, SMS ou e-mail). |
| OptIn | String | Status de aceitação para marketing. |
| Frequência | String | Frequência das comunicações de marketing. |
| StartDate | String | Data de início da preferência de marketing. |
| EndDate | String | Data de término da preferência de marketing. |
**Tipos de dados de Medical**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Oxygen | String | Preferências de suprimento de oxigênio. |
| MedicalEquipment | String | Detalhes sobre equipamentos médicos. |
| Assistance | String | Tipo de assistência médica necessária. |
| Stretcher | String | Exigência de maca para hóspede. |
| WheelChair | String | Tipo de cadeira de rodas e assistência necessária. |
**Tipos de dados de Baggage**
| Campo de hotelPreference padrão | Tipo | Description |
| --- | --- | --- |
| Bicycle | String | Necessidades de bagagem de bicicleta. |
| BaggageType | String | Detalhes da bagagem (por exemplo, volumosa). |
| Courier | String | Preferência de bagagem relacionada ao serviço de courier. |
| Fragile | String | Preferências em relação a itens frágeis. |
| PreferenceLevel | String | O nível de preferência de bagagem. |
# Mapeamento de tipo de objeto para a reserva aérea padrão
Os tópicos desta seção fornecem a definição de reserva aérea padrão.
**Topics**
+ [
# Campos de objeto de reserva aérea padrão do Customer Profiles
](standard-air-booking-object-fields.md)
# Campos de objeto de reserva aérea padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de reserva aérea padrão do Customer Profiles.
**AirBooking**
| Campo de airBooking padrão | Tipo | Description |
| --- | --- | --- |
| BookingId | String | O identificador exclusivo da reserva aérea padrão. |
| ContextId | String | O identificador específico do contexto para rastrear a origem da reserva. |
| PreferenceRef | String | O identificador que faz referência ao objeto Preference da reserva. |
| BookingName | String | O nome associado à reserva. |
| PassengerIndex | String | Índice do passageiro na reserva. |
| TravellerId | String | Identificador exclusivo do viajante associado à reserva. |
| GroupBooking | String | Indica se a reserva é para um grupo. |
| NumberOfPassengers | String | Número total de passageiros na reserva. |
| NumberOfAdults | String | Número total de adultos na reserva. |
| NumberOfChildren | String | Número total de crianças na reserva. |
| ProcessedDate | String | Data em que a reserva foi processada. |
| CreatedDate | String | Data em que a reserva foi criada. |
| CreatedBy | String | Identidade do criador. |
| UpdatedDate | String | Data da última atualização. |
| UpdatedBy | String | O identificador de quem atualizou a reserva pela última vez. |
| Status | String | Status atual da reserva. |
| PriorityStatus | String | Nível de prioridade da reserva. |
| ReservationStatus | String | Status da reserva. |
| MarketingCode | String | Código representando a origem ou campanha de marketing. |
| MarketingName | String | Nome da campanha de marketing. |
| TravelAgent | String | Agente de viagens associado à reserva. |
| TravelAgency | String | Nome da agência de viagens corporativas. |
| TravelCorpNumber | String | Número de cliente corporativo. |
| Booker | String | Indica se foi a pessoa que fez a reserva. |
| AdditionalInformation | String | Informações adicionais de formato livre. |
| E-mail | String | E-mail de contato para atualizações no dia da viagem. |
| PhoneNumber | String | Telefone de contato para atualizações no dia da viagem. |
| CancelledDate | String | Data do cancelamento da reserva (se aplicável). |
| Diplomat | String | Indica status diplomático. |
| Child | String | Indica se o passageiro é criança. |
| Desabilitado | String | Indica status de deficiência. |
| Oxygen | String | Indica a necessidade de suporte de oxigênio. |
| PetOnly | String | A reserva é apenas para o transporte de animais de estimação. |
| CancellationCharge | String | Taxa de cancelamento, se aplicável. 0 significa nenhuma cobrança. |
| Refundable | String | Detalhes sobre o reembolso da reserva. |
| Inventory | Inventory | Detalhes do inventário associado à reserva. |
| Loyalty | Loyalty | Detalhes do programa de fidelidade associado à reserva. |
| Canal | Canal | Detalhes do canal associado à reserva. |
| Pagamento | Pagamento | Detalhes do pagamento associado à reserva. |
| BillingAddress | Endereço | Detalhes do endereço de cobrança associado à reserva. |
| Preço | Preço | Detalhes do preço da reserva. |
| PaymentStatus | PaymentStatus | Status do pagamento da reserva. |
| Atributos | Map | Atributos personalizados ou de extensão. |
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1airBookingId | BookingId |
| \$1airPreferenceRef | PreferenceRef |
**Tipos de dados de Loyalty**
| Campo de airBooking padrão | Tipo | Description |
| --- | --- | --- |
| ProgramName | String | Nome do programa de fidelidade. |
| MembershipId | String | Número de membro do programa de fidelidade. |
| Tier | String | Nível de associação ao programa de fidelidade. |
**Tipo de dados docanal**
| Campo de airBooking padrão | Tipo | Description |
| --- | --- | --- |
| CreationChannelId | String | ID do canal usado para criar a reserva. |
| LastUpdatedChannelId | String | ID do canal usado para atualizar a reserva. |
| Método | String | Método usado por meio do canal (por exemplo, web, aplicativo ou telefone). |
**Tipos de dados de Payment**
| Campo de airBooking padrão | Tipo | Description |
| --- | --- | --- |
| Type | String | Tipo de método de pagamento (por exemplo, cartão ou voucher). |
| CreditCardToken | String | Cartão com token para referência segura. |
| CreditCardType | String | Tipo de cartão de crédito usado. |
| CreditCardExpiration | String | Data de vencimento do cartão. |
| Cvv | String | Número CVV. |
| NameOnCreditCard | String | Nome do titular do cartão. |
| RoutingNumber | String | Número de roteamento bancário (se aplicável). |
| AccountNumber | String | Número da conta bancária (se aplicável). |
| VoucherId | String | Voucher usado para pagamento. |
| DiscountCode | String | Código de desconto promocional aplicado. |
| DiscountPercent | String | Porcentagem do desconto aplicada ao pagamento. |
**Tipos de dados de BillingAddress**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Address1 | String | A primeira linha do endereço de um cliente. |
| Address2 | String | A segunda linha do endereço de um cliente. |
| Address3 | String | A terceira linha do endereço de um cliente. |
| Address4 | String | A quarta linha do endereço de um cliente. |
| Cidade | String | A cidade do endereço do cliente. |
| País | String | O país do endereço do cliente. |
| Condado | String | O condado do endereço do cliente. |
| PostalCode | String | O código postal de endereço do cliente. |
| Província | String | A província do endereço do cliente. |
| Estado | String | O estado do endereço do cliente. |
**Tipos de dados de Price**
| Campo de airBooking padrão | Tipo | Description |
| --- | --- | --- |
| TotalPrice | String | Preço total da reserva. |
| BasePrice | String | Preço básico da reserva. |
| TravellerPrice | String | Preço pago por viajante. |
| DiscountAmount | String | Desconto aplicado à tarifa básica. |
| Currency | String | Moeda em que o pagamento foi feito. |
**Tipos de dados de PaymentStatus**
| Campo de airBooking padrão | Tipo | Description |
| --- | --- | --- |
| PaidAt | String | Carimbo de data/hora em que o pagamento foi concluído. |
| AwaitingPayment | String | Indica que o pagamento está pendente. |
| RequiredBy | String | Data de vencimento do pagamento |
**Tipos de dados de Inventory**
| Campo de airBooking padrão | Tipo | Description |
| --- | --- | --- |
| Seats | String | Número total de assentos na reserva. |
# Mapeamento de tipo de objeto para o trecho aéreo padrão
Os tópicos desta seção fornecem a definição de trecho aéreo padrão.
**Topics**
+ [
# Campos de objeto de trecho aéreo padrão do Customer Profiles
](standard-air-segment-object-fields.md)
# Campos de objeto de trecho aéreo padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de trecho aéreo padrão do Customer Profiles.
**Trecho aéreo**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| SegmentId | String | O identificador exclusivo do trecho aéreo padrão. |
| BookingRef | String | Identificador de referência da reserva. |
| SegmentName | String | Nome/descrição do trecho. |
| PassengerIndex | String | Número de índice do passageiro. |
| SegmentIndex | String | Número de índice do trecho. |
| SeatSelection | String | Detalhes sobre a seleção de assentos. |
| NumberOfPassengers | String | Número total de passageiros. |
| NumberOfLegs | String | Número de trechos de voo. |
| Tier | String | tier/status Nível de passageiro |
| Origem | String | Código do aeroporto de partida. |
| OriginCountryCode | String | Código do país de partida. |
| Dest | String | Código do aeroporto de destino. |
| DestCountryCode | String | Código do país de destino. |
| ProcessedDate | String | Data em que o trecho foi processado. |
| CreatedDate | String | Data em que o registro foi criado. |
| CreatedBy | String | Usuário que criou o registro. |
| UpdatedDate | String | Data em que o registro foi atualizado pela última vez. |
| UpdatedBy | String | Usuário que atualizou o registro pela última vez. |
| Status | String | Status atual do trecho. |
| FlightNumber | String | Número do voo. |
| Carrier | String | Código da companhia aérea operadora. |
| CarrierType | String | Tipo de operadora. |
| IsInternational | String | Indica se o voo é internacional. |
| IsEticket | String | Indica se o bilhete é eletrônico. |
| IsArmed | String | Indica se o passageiro está armado. |
| LapInfant | String | Detalhes sobre bebês de colo. |
| Pet | String | Indica se você está viajando com animal de estimação. |
| PrisonerOrGuard | String | Indica o status de prisioneiro ou guarda. |
| Child | String | Indica se o passageiro é criança. |
| Married | String | Indica se os trechos são casados. |
| CheckinEligible | String | Indica a elegibilidade para o check-in. |
| InEligibleReason | String | Motivo em caso de não elegível para o check-in. |
| UnEscortedMinor | String | Indica o status de menor desacompanhado. |
| PremiumAccess | String | Indica compra de acesso premium. |
| MissingData | String | Indica dados ausentes. |
| CurrentClassOfService | String | Classe de serviço atual. |
| BookedClassOfService | String | Classe de serviço da reserva original. |
| CodeShare | String | Indica um voo de codeshare. |
| ReverseCodeShare | String | Indica codeshare reverso. |
| MarketCarrierCode | String | Código da companhia aérea de marketing. |
| OpCarrierCode | String | Código da companhia aérea operadora. |
| InConnection | String | Detalhes da conexão de entrada. |
| OutConnection | String | Detalhes da conexão de saída. |
| MilesToEarn | String | Milhas a serem recebidas. |
| Duração | String | Duração do voo. |
| DurationTimeUnit | String | Unidade de tempo para a duração. |
| Distância | String | Distância do voo. |
| DistanceUnit | String | Unidade para medição da distância. |
| SellType | String | Indica se é uma venda forçada. |
| GoShow | String | Indica se é um “go show” (passageiro que se apresenta para voo diferente do reservado). |
| Incapacitated | String | Indica se o passageiro está incapacitado. |
| Upgraded | String | Indica se houve upgrade no voo. |
| Downgraded | String | Indica se houve downgrade no voo. |
| BaggageInsurance | String | Seguro de bagagem. |
| MaxAllowedBaggage | String | Máximo permitido de bagagens. |
| BaggageQuantity | String | Número de bolsas. |
| BaggageFee | String | Taxa total de bagagem. |
| Arrival | Porta | Detalhes de chegada para o trecho. |
| Departure | Porta | Detalhes de partida para o trecho. |
| Seat | Seat | Detalhes do assento. |
| Prioridade | Prioridade | Detalhe sobre prioridade. |
| Doc | Doc | Informações do documento de acompanhamento para viagem. |
| Baggage | Lista de Baggage | Detalhes de bagagens. |
| Pets | Lista de Pet | Detalhes sobre animais de estimação. |
| OtherServices | OtherService Lista | Detalhes sobre outros serviços. |
| Atributos | Map | Atributos adicionais. |
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1airSegmentId | SegmentId |
| \$1airBookingRef | BookingRef |
**Tipos de dados de Baggage**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| Id | String | Identificador de bagagem. |
| TagNumber | String | Número da etiqueta de bagagem. |
| DepartureDate | String | Data de partida. |
| BaggageType | String | Tipo de bagagem. |
| Weight | String | Peso da bagagem. |
| Tamanho | String | Comprimento da bagagem. |
| Largura | String | Largura da bagagem. |
| Altura | String | Altura da bagagem. |
| PriorityBagDrop | String | Serviço de entrega prioritário de bagagem. |
| PriorityBagReturn | String | Serviço de devolução prioritária de bagagem. |
| HandsFreeBaggage | String | Serviço de bagagem “hands-free” (mãos livres). |
| Taxa | String | Taxa de bagagem. |
| IsGateBag | String | Indica bagagem verificada no portão. |
| IsHeavy | String | Indica bagagem pesada. |
**Tipos de dados de Seat**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| SeatNumber | String | Número do assento. |
| SeatZone | String | Zona do assento. |
| SeatType | String | Tipo de assento. |
| Preço | String | Preço do assento. |
| NeighborFree | String | Indica se o assento vizinho está livre. |
| UpgradeAuction | String | Indica a disponibilidade de upgrade por leilão. |
| Available (Disponível) | String | Indica a disponibilidade do assento. |
| ExtraSeat | String | Indica assento extra. |
| AdditionalInformation | String | Informações adicionais sobre o assento. |
**Tipos de dados de Port**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| Local | String | Nome do local |
| Código | String | Código do aeroporto |
| Terminal | String | Terminal do aeroporto |
| País | String | País do aeroporto |
| Data | String | Data |
| Hora | String | Time |
| EstimatedTime | String | Tempo estimado |
| ScheduledTime | String | Horário programado |
**Tipos de dados de Priority**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| TransactionId | String | Identificador da transação. |
| PriorityServiceType | String | Tipo de serviço prioritário. |
| LoungeAccess | String | Indica acesso ao saguão |
| Preço | String | Preço do serviço prioritário |
| AdditionalInformation | String | Informações adicionais sobre prioridade |
**Tipos de dados de Pet**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| Species | String | Espécie do animal de estimação |
| Breed | String | Raça do animal de estimação |
| Weight | String | Peso do animal de estimação |
| WeightUnit | String | Unidade de medida do peso |
| TransportType | String | Tipo de transporte de animal de estimação |
**OtherService tipo de dados**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| ServiceType | String | Tipo de serviço |
| Description | String | Service description (Descrição do serviço) |
| Preço | String | Preço do serviço |
**Tipos de dados de Doc**
| Campo de airSegment padrão | Tipo | Description |
| --- | --- | --- |
| DocType | String | Tipos de documento |
| DocTypeNeeded | String | Indica se é necessário documento |
| Nationality | String | Nacionalidade no documento |
| DateOfBirth | String | Data de nascimento |
| AppId | String | Identificador da aplicação |
| AgentId | String | Identificador de atendente |
| VerifiedDateTime | String | Hora de verificação do documento |
# Mapeamento de tipo de objeto para a reserva de hotel padrão
Os tópicos desta seção fornecem a definição de reserva de hotel padrão.
**Topics**
+ [
# Campos de objeto de reserva de hotel padrão do Customer Profiles
](standard-hotel-reservation-object-fields.md)
# Campos de objeto de reserva de hotel padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de reserva de hotel padrão do Customer Profiles.
**Reserva de hotel**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| ReservationId | String | Identificador exclusivo da reserva de hotel padrão |
| ConfirmationNumber | String | Número de confirmação fornecido pelo hotel ou mecanismo de reserva |
| PreferenceRef | String | O identificador que faz referência ao objeto Preference da reserva |
| Status | String | Status atual da reserva (por exemplo, confirmada ou cancelada) |
| TripType | String | Propósito ou natureza da viagem (por exemplo, lazer ou negócios) |
| BrandCode | String | Código que representa a marca do hotel |
| HotelCode | String | Código que identifica o hotel específico |
| PhoneNumber | String | Número do telefone de contato da reserva |
| EmailAddress | String | Endereço de e-mail de contato da reserva |
| GroupId | String | ID que vincula a reserva a uma reserva de grupo |
| ContextId | String | Identificador específico do contexto para rastrear a origem da reserva |
| ProcessedDate | String | Carimbo de data/hora em que a reserva foi processada |
| CreatedDate | String | Carimbo de data/hora em que a reserva foi criada |
| CreatedBy | String | Identificador da user/system pessoa que criou a reserva |
| UpdatedDate | String | Carimbo de data/hora da última atualização da reserva |
| UpdatedBy | String | Identificador da pessoa user/system que atualizou a reserva |
| AgentId | String | ID do atendente responsável pela reserva |
| Reserver | String | Indica se o perfil é quem fez a reserva |
| SameDayRate | String | Indica se a reserva foi feita para o mesmo dia |
| Refundable | String | Indica se a reserva é reembolsável |
| CancellationCharge | String | Taxa de cancelamento, se aplicável. 0 significa nenhuma cobrança. |
| TransactionId | String | Identificador exclusivo da transação |
| AmountPerNight | String | Valor cobrado por noite pelo quarto |
| AdditionalNote | String | Observações ou instruções especiais |
| NumberOfNights | String | Número de noites na reserva |
| NumberOfGuests | String | Número total de hóspedes na reserva |
| TotalAmountBeforeTax | String | Custo total antes de impostos |
| TotalAmountAfterTax | String | Custo total após impostos |
| Checkout | CheckOut | Detalhes de checkout |
| Loyalty | Loyalty | Detalhes do programa de fidelidade |
| Sala | Sala | Detalhes do quarto |
| CheckIn | CheckIn | Detalhes de check-in |
| Pagamento | Pagamento | Detalhes do pagamento |
| Currency | Currency | Detalhes da moeda |
| Cancelamento | Cancelamento | Detalhes do cancelamento |
| Canal | Canal | Detalhes do canal |
| RatePlan | RatePlan | Detalhes do plano de tarifas |
| Convidados | Convidados | Detalhes dos hóspedes |
| Services | ServiceList | Lista de serviços |
| Atributos | Map | Atributos adicionais. |
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1hotelReservationId | ReservationId |
| \$1hotelPreferenceRef | preferenceRef |
**Tipos de dados de Checkout**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| Early | String | O check-out antecipado é agendado ou solicitado |
| Late | String | O check-out tardio é agendado ou solicitado |
| Self | String | O check-out via autoatendimento é agendado ou solicitado |
| Data | String | Data de checkout da reserva |
**Tipos de dados de Loyalty**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| ProgramName | String | Nome do programa de fidelidade. |
| MembershipId | String | ID de membro no programa de fidelidade |
| Tier | String | Nível no programa de fidelidade |
**Tipos de dados de Room**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| TypeCode | String | Código para o tipo/categoria de quarto |
| TypeName | String | Nome do tipo de quarto |
| TypeDesc | String | Descrição do tipo de quarto |
| Número | String | Número do quarto atribuído |
| Capacity | String | Capacidade máxima do quarto |
| AccessibilityType | String | Atributos de acessibilidade |
| SmokingAllowed | String | Indica se é permitido fumar no quarto |
**CheckIn tipo de dados**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| Data | String | Data de check-in da reserva |
| DigitalKey | String | Indica se foi emitida uma chave digital do quarto |
| Early | String | Indica se o check-in antecipado foi solicitado |
| Late | String | Indica se o check-in tardio foi solicitado |
| RoomKeys | String | Número de chaves do quarto emitidas |
| UserSelectedRoom | String | Verdadeiro se o hóspede selecionou seu próprio quarto |
**Tipos de dados de Payment**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| Type | String | Tipo de método de pagamento (por exemplo, crédito, débito ou voucher) |
| CreditCardToken | String | Número do cartão de crédito com token |
| CreditCardType | String | Tipo de cartão de crédito (por exemplo, Visa ou Amex) |
| CreditCardExpiration | String | Data de validade do cartão de crédito |
| Cvv | String | Valor de verificação do cartão |
| NameOnCreditCard | String | Nome impresso no cartão de crédito |
| RoutingNumber | String | Número de roteamento bancário |
| AccountNumber | String | Número de conta bancária |
| VoucherId | String | Identificador do voucher, se usado |
| DiscountCode | String | Código de desconto aplicado |
| DiscountPercent | String | Porcentagem de desconto aplicada |
**Tipos de dados de Currency**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| Código | String | Código ISO da moeda (por exemplo, USD) |
| Nome | String | Nome completo da moeda (por exemplo, dólar americano) |
| Símbolo | String | Símbolo da moeda (por exemplo, \$1) |
**Tipos de dados de Cancellation**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| Motivo | String | Motivo do cancelamento |
| Comment | String | Observações adicionais sobre o cancelamento |
**Tipo de dados docanal**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| CreationChannelId | String | ID do canal pelo qual a reserva foi feita |
| LastUpdatedChannelId | String | ID do canal pelo qual a reserva foi atualizada pela última vez |
| Método | String | Método usado para reserva (por exemplo, web ou aplicativo móvel) |
**RatePlan tipo de dados**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| Código | String | Identificador de código do plano de tarifas da reserva |
| Nome | String | Nome do plano de tarifas da reserva |
| Description | String | Descrição do plano de tarifas |
**Tipos de dados de Service**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| ServiceType | String | Tipo de serviço (por exemplo, spa ou café da manhã) |
| Description | String | Descrição do serviço |
| Custo | String | Custo do serviço |
**Tipos de dados de Guest**
| Campo de hotelReservation padrão | Tipo | Description |
| --- | --- | --- |
| Adults | String | Número de hóspedes adultos |
| Children | String | Número de crianças entre os hóspedes |
# Mapeamento de tipo de objeto para o programa de fidelidade padrão
Os tópicos desta seção fornecem a definição de programa de fidelidade padrão.
**Topics**
+ [
# Campos de objeto de programa de fidelidade padrão do Customer Profiles
](standard-loyalty-object-fields.md)
# Campos de objeto de programa de fidelidade padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de programa de fidelidade padrão do Customer Profiles.
**Loyalty**
| Campo de programa de fidelidade padrão | Tipo | Description |
| --- | --- | --- |
| LoyaltyId | String | Identificador exclusivo do programa de fidelidade padrão |
| ProgramId | String | Identificador do programa de fidelidade |
| MembershipId | String | Identificador alternativo dentro do programa |
| ProgramName | String | Nome do programa de fidelidade. |
| Group (Grupo) | String | Grupo ou categoria do programa de fidelidade |
| Canal | String | Canal pelo qual o programa de fidelidade é acessado |
| CreatedDate | String | Data em que a conta do programa de fidelidade foi criada |
| EnrollmentDate | String | Data em que o cliente se inscreveu no programa |
| CreatedBy | String | Usuário ou sistema que criou a conta do programa de fidelidade |
| UpdatedDate | String | Data da última atualização da conta do programa de fidelidade |
| LastUpdatedBy | String | Usuário ou sistema que atualizou a conta do programa de fidelidade pela última vez |
| UpgradeDate | String | Data em que o nível foi atualizado pela última vez |
| RenewalDate | String | Data de renovação da associação ao programa de fidelidade |
| AdditionalInformation | String | Informações adicionais |
| EmailAddress | String | Endereço de e-mail do cliente |
| EmailAddressVerified | String | Sinalizador que indica se o e-mail foi verificado |
| PhoneNumber | String | Número de telefone do cliente |
| PhoneNumberVerified | String | Sinalizador que indica se o número de telefone foi verificado |
| Status | String | Status atual da conta do programa de fidelidade |
| Tier | Tier | Detalhes do nível |
| Points | Points | Detalhes de pontos |
| PointExpirations | PointExpiration Lista | Detalhes de vencimento de pontos |
| Pagamento | Pagamento | Detalhes do pagamento |
| PaymentInformation | PaymentInformation | Detalhes das informações de pagamento |
| BillingAddress | Endereço associado ao programa de fidelidade | Detalhes do endereço |
| Atributos | Map | Atributos adicionais não cobertos de outra forma |
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1loyaltyId | LoyaltyId |
| \$1loyaltyMembershipId | membershipId |
**Tipos de dados de endereço associado ao programa de fidelidade**
| Campo de airPreference padrão | Tipo de dados | Description |
| --- | --- | --- |
| Address1 | String | A primeira linha do endereço de um cliente. |
| Address2 | String | A segunda linha do endereço de um cliente. |
| Address3 | String | A terceira linha do endereço de um cliente. |
| Address4 | String | A quarta linha do endereço de um cliente. |
| Cidade | String | A cidade em que o cliente mora. |
| País | String | O país em que o cliente mora. |
| Condado | String | O distrito em que o cliente mora. |
| PostalCode | String | O código postal de endereço do cliente. |
| Província | String | A província em que o cliente mora. |
| Estado | String | O estado em que o cliente mora. |
**Tipos de dados de Tier**
| Campo de programa de fidelidade padrão | Tipo | Description |
| --- | --- | --- |
| CurrentTier | String | Nível atual no programa de fidelidade do cliente |
| NextTier | String | Próximo nível possível para o cliente |
| PointsToNextTier | String | Pontos necessários para alcançar o próximo nível |
**Tipos de dados de Points**
| Campo de programa de fidelidade padrão | Tipo | Description |
| --- | --- | --- |
| Points.Unit | String | Unidade de medida dos pontos |
| Points.Lifetime | String | Total de pontos vitalícios obtidos |
| Points.Balance | String | Saldo atual de pontos |
| Points.Redeemed | String | Total de pontos resgatados |
**PointExpiration tipo de dados**
| Campo de programa de fidelidade padrão | Tipo | Description |
| --- | --- | --- |
| Points | String | Pontos a expirar |
| Data | String | Data de validade dos pontos |
**Tipos de dados de Payment**
| Campo de programa de fidelidade padrão | Tipo | Description |
| --- | --- | --- |
| Type | String | Tipo de pagamento |
| CreditCardToken | String | Referência de cartão de crédito com token |
| CreditCardType | String | Tipo de cartão de crédito (por exemplo, Visa) |
| CreditCardExpiration | String | Data de validade do cartão de crédito |
| Cvv | String | Valor de verificação do cartão |
| NameOnCreditCard | String | Nome no cartão |
| RoutingNumber | String | Número de roteamento bancário |
| AccountNumber | String | Número de conta bancária |
| VoucherId | String | Identificador do voucher |
**PaymentInformation tipo de dados**
| Campo de programa de fidelidade padrão | Tipo | Description |
| --- | --- | --- |
| Agendamento | String | Cronograma de pagamentos |
| LastPaymentDate | String | Data do último pagamento |
| NextPaymentDate | String | Data do próximo pagamento |
| NextBillAmount | String | Valor da próxima fatura |
| CurrencyCode | String | Código da moeda (por exemplo, USD) |
| CurrencyName | String | Nome completo da moeda |
| CurrencySymbol | String | Símbolo da moeda (por exemplo, \$1) |
# Mapeamento de tipo de objeto para a transação do programa de fidelidade padrão
Os tópicos desta seção fornecem a definição de transação do programa de fidelidade padrão.
**Topics**
+ [
# Campos de objeto de transação do programa de fidelidade padrão do Customer Profiles
](standard-loyalty-transaction-object-fields.md)
# Campos de objeto de transação do programa de fidelidade padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de transação do programa de fidelidade padrão do Customer Profiles.
**Transação do programa de fidelidade**
| Campo de loyaltyTransaction padrão | Tipo | Description |
| --- | --- | --- |
| TransactionId | String | Identificador exclusivo da transação do programa de fidelidade padrão. |
| TransactionName | String | Nome ou etiqueta da transação. |
| TransactionType | String | Tipo de transação (por exemplo, receber, resgatar ou ajustar). |
| ProgramRef | String | Referência ao programa de fidelidade associado. |
| MembershipRef | String | Referência à associação ao programa de fidelidade usada na transação. |
| PromotionRef | String | Referência a uma promoção que influenciou essa transação. |
| CreatedDate | String | Data em que a transação foi criada. |
| TransactionDate | String | Data em que a transação ocorreu. |
| Industry | String | Setor associado à transação (por exemplo, companhia aérea ou hotel). |
| Local | String | Local em que a transação ocorreu. |
| CreatedBy | String | Identificador de quem criou a transação. |
| UpdatedDate | String | A data em que a transação foi atualizada pela última vez. |
| UpdatedBy | String | Identificador de quem atualizou a transação pela última vez. |
| Status | String | Status atual da transação. |
| AccrualType | String | Método de acúmulo (manual, automatizado etc.). |
| Categoria | String | Categoria da transação (por exemplo, voo ou estadia em hotel). |
| Canal | String | Canal em que a transação foi iniciada (por exemplo, on-line ou loja física). |
| ProductId | String | Identificador do produto ou serviço vinculado à transação. |
| Valor | String | Valor gasto ou movimentado na transação. |
| OriginValue | String | Valor original antes de qualquer conversão ou compensação. |
| OriginValueCurrency | String | Moeda do valor original da transação. |
| OriginValueOffset | String | Ajuste do valor original para promoções, reembolsos etc. |
| PointsEarned | String | Total de pontos obtidos com essa transação. |
| PointOffset | String | Pontos ajustados (por exemplo, bônus ou penalidades). |
| QualifyingPointsEarned | String | Pontos que contam para a qualificação de nível. |
| TierBefore | String | Nível do cliente antes da transação. |
| TierAfter | String | Nível do cliente após a transação. |
| Brand | String | Marca associada à transação. |
| Description | String | Descrição narrativa da transação. |
| AdditionalInformation | String | Informações adicionais de formato livre relacionadas à transação. |
| PaymentMethod | String | Método de pagamento usado (por exemplo, cartão ou voucher). |
| PointTransfer | PointTransfer | Detalhes da transferência de pontos |
| Atributos | Map | Atributos adicionais. |
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1loyaltyTransactionId | TransactionId |
**PointTransfer tipo de dados**
| Campo de loyaltyTransaction padrão | Tipo | Description |
| --- | --- | --- |
| TransferId | String | Identificador da transação de transferência. |
| SourceProgramId | String | ID do programa de fidelidade de origem. |
| DestinationProgrmId | String | ID do programa de fidelidade de destino. |
| SourceMembershipId | String | ID de membro do programa de origem. |
| DestinationMembershipId | String | ID de membro do programa de destino. |
| PointsTransferred | String | Pontos deduzidos do programa de origem. |
| PointsReceived | String | Pontos creditados no programa de destino. |
# Mapeamento de tipo de objeto para a promoção do programa de fidelidade padrão
Os tópicos desta seção fornecem a definição de promoção do programa de fidelidade padrão.
usar
**Topics**
+ [
# Campos de objeto de promoção do programa de fidelidade padrão do Customer Profiles
](standard-loyalty-promotion-object-fields.md)
# Campos de objeto de promoção do programa de fidelidade padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de promoção do programa de fidelidade padrão do Customer Profiles.
**Promoção do programa de fidelidade**
| Campo de loyaltyPromotion padrão | Tipo | Description |
| --- | --- | --- |
| PromotionId | String | Identificador exclusivo da promoção do programa de fidelidade padrão. |
| PromotionName | String | Nome de exibição da promoção. |
| PromotionType | String | O tipo ou a categoria da promoção (por exemplo, bônus, aumento de nível ou voucher). |
| ProgramType | String | Indica o tipo de programa de fidelidade ao qual a promoção está vinculada. |
| ProgramRef | String | ID de referência do programa de fidelidade relacionado. |
| PartnerId | String | ID de referência de uma organização parceira envolvida na promoção. |
| PartnerNumber | String | Um identificador ou número relacionado ao parceiro. |
| Tier | String | Nível visado ou afetado pela promoção. |
| StartDate | String | Data de ativação da promoção. |
| EnrolledDate | String | Data em que o usuário se inscreveu na promoção. |
| EndDate | String | Data de término da promoção. |
| Valor | String | Valor monetário ou em pontos associado à promoção. |
| Período | String | Período da promoção (por exemplo, semanal, mensal ou com base em campanha). |
| Status | String | Status atual da promoção (por exemplo, ativa, expirada ou concluída). |
| CreatedDate | String | Data em que o registro da promoção foi criado. |
| CreatedBy | String | Usuário ou sistema que criou o registro da promoção. |
| UpdatedDate | String | A data em que o registro da promoção foi atualizado pela última vez. |
| UpdatedBy | String | Usuário ou sistema que atualizou a promoção pela última vez. |
| CampaignRef | String | Referência externa a uma campanha mais ampla à qual essa promoção pertence. |
| AdditionalInformation | String | Observações diversas ou texto de marketing sobre a promoção. |
| TriggerLimit | TriggerLimit | Detalhes do limite de acionamento. |
| Usage | Usage | Detalhes de uso. |
| Regras | Regras | Detalhes das regras da promoção. |
| Incentive | Incentive | Detalhes do incentivo da promoção. |
| Atributos | Map | Metadados adicionais ou valores específicos do programa. |
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1loyaltyPromotionId | PromotionId |
**Tipos de dados de Rules**
| Campo de loyaltyPromotion padrão | Tipo | Description |
| --- | --- | --- |
| Nome | String | Nome da regra dentro das regras da promoção. |
| Description | String | Descrição da regra dentro das regras da promoção. |
**Tipos de dados de Incentive**
| Campo de loyaltyPromotion padrão | Tipo | Description |
| --- | --- | --- |
| Type | String | O tipo de incentivo (por exemplo, bonusPoints, voucher ou tierUpgrade). |
| Valor | String | Valor do incentivo, como quantidade de pontos ou valor do voucher. |
| Unidade | String | A unidade do valor do incentivo (por exemplo, pontos, % ou USD). |
**TriggerLimit tipo de dados**
| Campo de loyaltyPromotion padrão | Tipo | Description |
| --- | --- | --- |
| Times | String | Número de vezes que uma promoção pode ser acionada. |
| Intervalo | String | Limite de intervalo de acionamento. |
**Tipos de dados de Usage**
| Campo de loyaltyPromotion padrão | Tipo | Description |
| --- | --- | --- |
| UsageProgressPercent | String | Porcentagem de progresso do uso da promoção. |
| UsageCompleted | String | O número de usos concluídos. |
| UsageTarget | String | Número-alvo de usos. |
# Mapeamento de tipos de objetos para objetos do Web Analytics
**WebAnalytics Esquema de objeto padrão**
| Campo | Tipo | Description |
| --- | --- | --- |
| Atributos do evento |
| EventId | String | Identificador exclusivo para um evento de análise da web. |
| EventType | String | Tipo do evento de análise da web, como - Visualização de página, envio de formulário, cliques em botões, sAbra a linha principal\$1u0000Interação da barra de pesquisa, solicitações de erro do aplicativo, interações com o carrinho, compras, rolagens etc. |
| EventTimestamp | Número | Data e hora do evento em milissegundos. |
| EventDuration | Número | EventDuration representa a quantidade de tempo que um usuário passou durante uma interação específica, medida em segundos. Os casos de uso comuns incluem: tempo gasto visualizando um produto, duração de uma sessão de navegação em uma página específica, tempo gasto em um recurso etc. |
| EventValue | Número | EventValue é um atributo numérico que representa o valor ou a importância de um evento de interação. Os casos de uso comuns incluem: valor da compra para eventos de transação, valores de classificação para avaliações de produtos, porcentagem de conclusão para visualizações de vídeos etc. |
| Atributos da sessão |
| ID da sessão | String | Identificador exclusivo para a sessão. |
| Sessão. StartTimestamp | Número | Milissegundo de época indicando a data e hora de início da sessão. |
| Atributos de página/tela |
| Título da página | String | Título de um App/Screen nome da Web para um aplicativo móvel. |
| Página. Localização | String | URL de uma página da Web. Para dispositivos móveis, pode ser um link direto ou uma rota para a tela. |
| Página. Referenciador | String | Ecrã/página anterior. |
| Página.Categoria | String | Agrupamento lógico de um screen/page. Might be useful to group nested URLs/app local. |
| Elementos HTML/DOM |
| ID do elemento | String | ID do elemento HTML |
| Tipo de elemento | String | Tipo de elemento - botão, links de ancoragem, etc. |
| Classes de elementos | String | Classes de estilo CSS do elemento |
| Element.Texto | String | Texto do elemento (útil para botões, espaços reservados para campos de entrada, etc.). |
| Elemento. AltText | String | AltText de um elemento HTML (geralmente usado para imagens). |
| Element.Fonte | String | Fonte de um vídeo, imagem etc. |
| Formulário |
| ID do formulário | String | Identificador exclusivo para um formulário de entrada |
| Nome do formulário | String | Nome do formulário |
| Comprimento do formulário | String | Número de campos de entrada em um formulário. |
| Formulário. ValidationErrors | Número | Número de erros de validação no formulário. |
| Formulário. FieldsCompleted | Número | Número de campos preenchidos. |
| Formulário. FieldsRequired | Número | Número de campos obrigatórios. |
| Pesquisa |
| Pesquisar. Consultar | String | Cadeia de consulta usada na entrada |
| Pesquisar. TotalMatchingResults | Número | Número total de resultados da pesquisa. |
| Pesquisar. ResultsPerPage | Número | Número de resultados exibidos por página. |
| Pesquisar. CurrentResultsPage | Número | Página de resultados atual que o usuário está visualizando. |
| Pesquisar. FilterExpression | String | Qualquer expressão de filtro adicional usada. |
| Pesquisar. SortCriteria | String | Critérios para classificar o resultado da pesquisa. Por exemplo - relevância, preço, etc. |
| Pesquisar. SortOrder | String | Ordem de classificação dos resultados da pesquisa - Ascendente/Decrescente. |
| Lista de itens/itens |
| Item | Item | Item focado em um evento, indicando o item adicionado ao carrinho, item visualizado, etc. |
| ItemsList | Lista - | Lista focada de itens em um evento, indicando itens comprados, itens em um carrinho, resultados de pesquisa de itens, etc. |
| Impressões do item |
| AdditionalItemImpressions | Lista
- | Lista de impressões de itens adicionais |
| Carrinho |
| ID do carrinho | String | Identificador exclusivo para um carrinho. |
| Carrinho. ItemsCount | Número | Número de itens no carrinho. |
| Carrinho. Moeda | String | Moeda para o valor do carrinho. |
| Valor do carrinho | Número | Valor monetário dos itens no carrinho. |
| Informações do pedido |
| OrderId | String | Identificador exclusivo para um pedido. Somente armazenaremos o identificador do pedido aqui, outras informações relacionadas ao pedido serão armazenadas no objeto padrão do pedido. |
| Dispositivo |
| DeviceId | String | Identificador exclusivo do dispositivo do usuário. |
| Atributos do scroll |
| Rolar. DepthPercentage | String | Porcentagem de profundidade de rolagem vertical. Isso ajuda a entender até que ponto os usuários percorrem uma página da web. |
| scroll.position X | Número | Posição de rolagem horizontal em pixels a partir da esquerda. |
| Scroll.position Y | Número | Posição de rolagem vertical em pixels a partir da parte superior. |
| Erro |
| Descrição do erro | String | Uma breve descrição do erro. |
| Tipo de erro | String | Error/Server Erro de entrada do usuário. |
| Usuário |
| ID do usuário | String | Identificador exclusivo do usuário |
| Usuário. AnonymousId | String | Anônimo UserId. Esse seria um UniqueID atribuído a um usuário quando ele não estivesse logado. |
| Usuário. IsReturning | String | Um valor booleano que indica se um usuário está revisitando. |
| Usuário. IsLoggedIn | String | Um valor booleano que indica se um usuário está logado. |
| Activity Location |
| Location.Country | String | País de atividade do usuário. |
| Localização.Estado | String | Estado da atividade do usuário. |
| Localização.Província | String | Província de atividade do usuário. |
| Localização.Condado | String | Condado de atividade do usuário. |
| Localização.Cidade | String | Cidade de atividade do usuário. |
| Localização.Latitude | String | Coordenadas de localização da atividade do usuário |
| Localização.Longitude | String | Coordenadas de localização da atividade do usuário |
| Atributos do aplicativo |
| Application.Name | String | O nome da aplicação. |
| Application.Version | String | Se o dispositivo for móvel, podemos capturar a versão do aplicativo aqui. O usuário também pode considerar o uso disso para A/B testes populacionais ou atributos de experimentação. |
| Aplicação.Ambiente | String | Ambientes de aplicativos, como - Beta, Gamma, Prod. |
| Atributos personalizados |
| Atributos | Map | Quaisquer atributos ou metadados personalizados para adicionar ao evento. |
**WebAnalytics Esquema do objeto do item**
| Campo | Tipo | Description |
| --- | --- | --- |
| Id | String | Identificador exclusivo para o item. |
| Título | String | Título do item. |
| Categoria | String | Categoria do item. |
| Valor | String | Valor monetário do item. |
| Moeda | String | Moeda do item. |
| Quantidade | Número | Quantidade do item. |
| ImpressionType | String | Cadeia de caracteres que identifica o tipo de impressão de um evento. Por exemplo: em destaque, patrocinado, principais opções, etc. |
| ImpressionId | String | Um identificador de sequência de caracteres para identificar de forma exclusiva uma impressão. |
**Esquema de objeto padrão do dispositivo**
| Campo | Tipo | Description |
| --- | --- | --- |
| DeviceId | String | Um identificador exclusivo para o dispositivo. |
| Tipo | String | Tipo de dispositivo (por exemplo, desktop, celular) |
| Modelo | String | Modelo do dispositivo, como - Macbook Pro/Air, IPhone 16, etc. |
| Fabricante | String | Fabricante do dispositivo. |
| OperatingSystem | String | Indica Windows MacOs, IOS, Android. |
| OperatingSystemVersion | String | Versão do sistema operacional |
| ScreenWidth | Número | Largura da tela ViewPort |
| ScreenHeight | Número | Altura da tela ViewPort |
| Navegador | String | Nome do navegador com o qual o usuário está interagindo. |
| BrowserVersion | String | Versão do navegador |
| Locale | String | Local do dispositivo ou aplicativo. |
| Atributos | Map | Qualquer atributo personalizado para um dispositivo. |
# Mapeamento de tipo de objeto para o catálogo de itens
| Campo | Tipo | Description |
| --- | --- | --- |
| Id | String | Identificador exclusivo para o item no catálogo. |
| Nome | String | Nome do item |
| Código | String | Código do item do catálogo |
| Tipo | String | Tipo de item do catálogo |
| Categoria | String | Categoria do item no Catálogo |
| Description | String | Descrição do item |
| AdditionalInformation | String | Qualquer informação adicional relevante para o item. |
| ImageLink | String | Link para a imagem do item |
| Link | String | URL do item |
| Preço | String | Preço do item |
| CreatedAt | Longo | Carimbo de data e hora da época para a qual o item foi criado |
| UpdatedAt | Longo | Data e hora da época para a qual o item foi atualizado |
| Atributos | Map | Atributos adicionais do item |
**nota**
Você só pode excluir o tipo de objeto de domínio via APIs. Você pode excluir a integração do catálogo de itens depois que todos os recomendadores tiverem sido excluídos primeiro. Isso evita problemas de dependência de dados.
**Etapas para excluir:**
1. Exclua todos os recomendadores existentes em seu domínio
2. Navegue até a integração do catálogo de itens.
3. Selecione a opção de exclusão.
# Mapeamento de tipo de objeto para a receita de estadia em hotel padrão
Os tópicos desta seção fornecem a definição de receita de estadia em hotel padrão.
**Topics**
+ [
# Campos de objeto de receita de estadia em hotel padrão do Customer Profiles
](standard-hotel-stay-revenue-object-fields.md)
# Campos de objeto de receita de estadia em hotel padrão do Customer Profiles
A tabela a seguir lista todos os campos no objeto de receita de estadia em hotel padrão do Customer Profiles.
**Receita de estadia em hotel**
| hotelStayRevenue Campo padrão | Tipo | Description |
| --- | --- | --- |
| StayRevenueId | String | O identificador exclusivo da receita de estadia em hotel padrão. |
| CurrencyCode | String | Código ISO da moeda (por exemplo, USD) |
| CurrencyName | String | Nome completo da moeda (por exemplo, dólar americano) |
| CurrencySymbol | String | Símbolo da moeda (por exemplo, \$1) |
| ReservationId | String | Identificador exclusivo da reserva de hotel. |
| GuestId | String | Identificador exclusivo do hóspede. |
| LastUpdatedOn | String | Carimbo de data/hora da última atualização do registro de estadia. |
| CreatedOn | String | O carimbo de data/hora da criação do registro de estadia. |
| LastUpdatedBy | String | Identificador da última vez user/system que atualizou o registro de estadia |
| CreatedBy | String | Identificador da pessoa user/system que criou o registro de estadia |
| StartDate | String | Data de início da estadia em hotel. |
| HotelCode | String | Código que identifica o hotel específico |
| Tipo | String | Tipo de receita (por exemplo, tarifa do quarto, incidentes ou impostos). |
| Description | String | Descrição do item de receita. |
| Valor | String | Valor do item de receita. |
| ProcessedDate | String | Data em que a receita foi processada. |
| Status | String | Status do item de receita. |
| Atributos | Map | Metadados adicionais ou valores específicos do programa. |
**Campos de índice padrão**
| Nome do índice padrão | Campo de registro de preferência padrão |
| --- | --- |
| \$1 hotelStayRevenue Identificação | StayRevenueId |
# Propriedades adicionais dos tipos de objeto no Customer Profiles
Um tipo de propriedade define qual chave deve ser usada para criptografar quaisquer dados do tipo de objeto.
Há uma opção que define se novos perfis podem ser criados pela ingestão desse objeto. Normalmente, quando é ingerido um objeto que não pode ser comparado com um perfil existente, um novo perfil é criado, desde que essa opção seja verdadeira. Se não for verdadeira, o objeto ingerido será criado e gravado na fila de mensagens não entregues do domínio.
Ele também contém por quanto tempo os dados desse tipo de objeto devem ser mantidos no Customer Profiles.
**nota**
A retenção em objetos individuais é definida no momento da ingestão dos dados. A alteração da retenção de um tipo de objeto específico só se aplica aos novos dados que estão sendo ingeridos. Ela não se aplica aos dados existentes já ingeridos.
**nota**
Se o objeto corresponder a um perfil existente, ele não substituirá os campos preenchidos manualmente por meio de uma chamada de API ou do espaço de trabalho do atendente, para evitar que as ingestões automáticas substituam as manuais.
Por exemplo, suponha que um perfil seja criado manualmente com FirstName “John” por um agente no Espaço de trabalho do agente. Os dados de mapeamento de um objeto para o FirstName campo do Perfil Padrão são ingeridos. Se esse objeto estiver associado ao perfil, ele não substituirá o FirstName “John”.
# Perfis inferidos
Quando um perfil é criado pela ingestão de um objeto que não tem campos, o objeto de perfil padrão desse novo perfil fica vazio. Esse objeto de perfil padrão vazio é um **perfil inferido**.
Ao criar um perfil inferido, os dois campos a seguir são preenchidos no objeto padrão a partir do objeto de perfil, se disponíveis.
+ Se houver algum campo definido com o tipo de conteúdo `EMAIL_ADDRESS` no objeto ingerido, esse valor será preenchido no `EmailAddress` campo do perfil padrão.
+ Se houver algum campo com o tipo de conteúdo `PHONE_NUMBER` no objeto ingerido, esse valor será preenchido no `PhoneNumber` campo do perfil padrão.
Os valores desses campos são preenchidos no perfil padrão, mesmo que os campos não tenham um destino determinado na definição do campo.
Para saber mais sobre os tipos de modelo de Registro de contato e como ajudar o modelo usado no domínio, consulte [Exemplos de uso do modelo de registro de contato](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples).
# Modelos de registro de contato no Amazon Connect Customer Profiles
Um registro de contato serve como um objeto de perfil que captura metadados essenciais de vários eventos de contato, como chamadas telefônicas ou chats. Ela desempenha um papel vital na documentação e na análise das interações com os clientes.
Quando ocorre um evento de contato, há três modelos padrão distintos que podem ser aplicados ao seu domínio. Esses modelos servem como opções de configuração, governando como o evento de contato é tratado no sistema. Cada modelo define regras e ações específicas, permitindo que você personalize o processamento de eventos de contato de acordo com suas necessidades comerciais.
**Topics**
+ [
## Crie perfis inferidos e perfis de associação automática (CTR-) NoInferred
](#ctr-contact-record-template-no-inferred)
+ [
## Somente perfis de associação automática (CTR-) AutoAssociateOnly
](#ctr-contact-record-template-auto-associate)
+ [
## Crie somente perfis inferidos (CTR)
](#ctr-contact-record-template-inferred-only)
+ [
## Exemplos de uso do modelo de registro de contato
](#ctr-contact-record-template-usage-examples)
+ [
## Como atualizar o tipo de Registro de contato no Console da AWS
](#ctr-contact-record-template-usage-examples-console)
+ [
## Adicionar automaticamente nomes de contatos de e-mail a um perfil
](#add-email-names-to-profile)
## Crie perfis inferidos e perfis de associação automática (CTR-) NoInferred
**Descrição**
Quando o NoInferred modelo de CTR é usado e ocorre um evento de contato, como uma chamada telefônica, um processo específico é iniciado para lidar com os dados. Inicialmente, o sistema usa a chave `_ctrContactId` para pesquisar um perfil existente associado ao evento de contato. Se um perfil correspondente for encontrado, o evento de contato será automaticamente associado a esse perfil. No entanto, se nenhum perfil existente for encontrado usando a chave `_ctrContactId`, o sistema continuará pesquisando um perfil usando uma chave secundária chamada `_phone`. Essa chave é usada para localizar um perfil existente com base no número de telefone associado ao evento de contato. Quando um perfil correspondente for encontrado, o evento de contato será automaticamente associado a esse perfil.
Nos casos em que nem a chave `_ctrContactId` nem a chave `_phone` produzem um perfil existente, o sistema cria um novo perfil inferido. Esse perfil inferido acaba sendo preenchido com os metadados do evento de contato, garantindo que as informações sejam capturadas e armazenadas no sistema.
Esse processo garante o tratamento eficiente dos eventos de contato, promovendo a associação automática com perfis existentes e permitindo a criação de perfis inferidos quando necessário. Ao aproveitar esses mecanismos, as organizações podem manter um registro abrangente das interações com os clientes e gerenciar com eficácia seus dados de eventos de contato dentro do sistema.
Recomenda-se usar o NoInferred modelo CTR como comportamento padrão devido às suas vantagens significativas, especialmente na redução de perfis duplicados
![\[O diagrama do NoInferred modelo CTR do Contact Record.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)
## Somente perfis de associação automática (CTR-) AutoAssociateOnly
**Descrição**
O AutoAssociateOnly modelo CTR funciona de forma semelhante ao NoInferred modelo CTR, com uma distinção importante: ele não cria um perfil inferido quando nenhum perfil existente pode ser encontrado para associação automática.
Quando ocorre um evento de contato, como uma chamada telefônica, o AutoAssociateOnly modelo CTR usa a `_ctrContactId` chave para pesquisar um perfil existente correspondente. Se um perfil for encontrado, o evento de contato será automaticamente associado a esse perfil.
No entanto, se nenhum perfil existente for encontrado usando a chave `_ctrContactId`, o modelo empregará um mecanismo de pesquisa secundário usando a chave `_phone`. Ele procura um perfil existente associado ao mesmo número de telefone do evento de contato. Se um perfil correspondente for encontrado, o evento de contato será automaticamente associado a esse perfil.
O objetivo de usar o AutoAssociateOnly modelo CTR é permitir a associação automática com perfis existentes, mantendo um controle estrito sobre a criação do perfil. Ao contrário do NoInferred modelo CTR, esse modelo impede a criação de perfis inferidos quando nenhuma correspondência é encontrada. Ele garante que os perfis sejam criados apenas manualmente, fornecendo às organizações um nível mais alto de controle e precisão no gerenciamento de perfis.
Ao utilizar o AutoAssociateOnly modelo CTR, as organizações podem aproveitar a associação automática e, ao mesmo tempo, seguir regras específicas relacionadas à criação de perfil. Essa abordagem permite um gerenciamento simplificado de eventos de contato e um controle preciso sobre o ecossistema do perfil, garantindo uma representação precisa dos dados e facilitando o gerenciamento eficiente do cliente.
![\[O diagrama do AutoAssociateOnly modelo CTR do Contact Record.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)
## Crie somente perfis inferidos (CTR)
**Descrição**
O modelo de CTR depende exclusivamente da chave `_ctrContactId` para pesquisar um perfil existente e associa automaticamente o evento de contato ao perfil se uma correspondência for encontrada. No entanto, nos casos em que nenhum perfil existente é encontrado, o modelo cria um perfil inferido e o preenche com os metadados do evento de contato.
Embora esse comportamento garanta que os eventos de contato sejam capturados mesmo quando não existe um perfil preexistente, ele pode potencialmente resultar na criação de vários perfis inferidos. Essa abundância de perfis inferidos pode levar ao problema de perfis duplicados no sistema.
Para abordar essa preocupação e promover melhores práticas de gerenciamento de perfil, é altamente recomendável utilizar o NoInferred modelo CTR como opção padrão. Ao usar o NoInferred modelo CTR, o sistema elimina a criação de perfis inferidos, reduzindo assim a ocorrência de perfis duplicados. Esse modelo permite um tratamento mais simplificado e eficiente dos eventos de contato, resultando em maior integridade e precisão dos dados.
Ao adotar o NoInferred modelo de CTR como opção padrão, as organizações podem otimizar seus processos de gerenciamento de perfil, minimizar a duplicação de dados e garantir uma representação mais confiável das interações com os clientes.
![\[O diagrama do modelo CTR de registro de contato.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)
## Exemplos de uso do modelo de registro de contato
**Amazon Connect site de administração**
+ No site Amazon Connect administrativo, ao criar um novo domínio, você tem a opção de selecionar o comportamento de CTR desejado. Isso pode ser feito por meio das opções de botão disponíveis na seção **Criação de perfil e associação automática**. Da mesma forma, ao selecionar um domínio existente, a opção do botão de opção refletirá o comportamento anteriormente associado a esse domínio.
+ Ao editar um domínio atualmente ativado, a página de detalhes do domínio exibirá o comportamento atualmente aplicado na seção **Criação de perfil e associação automática**. Quando você escolher o botão **Editar** no cabeçalho desta seção, haverá o redirecionamento para a página **Editar** **criação de perfil e associação automática**. Aqui, você pode escolher um comportamento diferente de acordo com seus requisitos.
+ Como alternativa, se estiver visualizando o mapeamento da CTR na página **Mapeamento de dados**, você poderá escolher o botão **Alterar modelo**. Essa ação também levará você à página **Editar** **criação de perfil e associação automática**, onde poderá selecionar um comportamento diferente que atenda às suas necessidades.
Essas opções oferecem flexibilidade no gerenciamento do comportamento CTR de seus domínios, permitindo que você personalize e modifique facilmente as configurações com base em suas preferências específicas ou nos requisitos comerciais em evolução.
**AWS CLI**
+ Para usar o NoInferred modelo **CTR-**, execute o seguinte comando na CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred `
+ Para usar o AutoAssociateOnly modelo **CTR-**, execute o seguinte comando na CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly `
+ Para usar o modelo **CTR**, execute o seguinte comando na CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR `
**API**
Para obter informações sobre como usar a API, consulte [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
## Como atualizar o tipo de Registro de contato no Console da AWS
1. No console do Customer Profiles, selecione **Visualizar detalhes** na seção **Domínio do Customer Profiles**.
![\[Escolher Visualizar detalhes na seção de domínio do Customer Profiles\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)
1. Na página **Detalhes do domínio**, escolha **Editar** na seção **Criação de perfil e associação automática**.
![\[Escolha Editar na seção Criação de perfil e associação automática.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)
1. Selecione o comportamento de Registro de contato desejado que você gostaria de aplicar ao domínio e escolha **Salvar**.
![\[Selecione o comportamento de Registro de contato desejado que você gostaria de aplicar ao domínio e escolha Salvar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)
## Adicionar automaticamente nomes de contatos de e-mail a um perfil
É possível configurar um fluxo para preencher o nome de um perfil de cliente com base em um contato de e-mail. Use o bloco [Customer Profiles](customer-profiles-block.md), configurado para usar a ação [Atualizar perfil](customer-profiles-block.md#customer-profiles-block-properties-update-profile).
# Associar o registro de contato a um perfil encontrado usando a chave \$1phone no Customer Profiles
Você pode associar automaticamente o registro de contato a um perfil encontrado usando a chave `_phone`.
**Exemplo**
No domínio, o seguinte perfil é criado pela API `CreateProfile`:
```
{
"FirstName": "John",
"LastName": "Doe",
"PhoneNumber": "+11234567890"
}
```
Quando uma chamada é recebida do `PhoneNumber` \$111234567890 usando o modelo de CTR padrão, o registro de contato não é associado automaticamente ao perfil acima, a menos que um atendente já tenha associado manualmente o registro de contato ao mesmo chamador ao perfil acima. Se o registro de contato não tiver sido associado manual ou automaticamente, o Customer Profiles criará um perfil inferido com as informações do registro de contato.
Para associar automaticamente o perfil acima aos registros de contato sem a intervenção manual do agente, você pode usar o NoInferred modelo CTR. Quando uma chamada é recebida do `PhoneNumber` \$111234567890 usando o NoInferred modelo CTR-, o Registro de contato será automaticamente associado ao perfil acima usando a chave do perfil. `_phone`
Há dois cenários nos quais o Customer Profiles *não* poderá associar automaticamente registros de contato a um perfil:
+ Se mais de um perfil for encontrado usando a chave do perfil `_phone`, o Customer Profiles não poderá associar o registro de contato a um perfil exclusivo e a solicitação será rejeitada.
+ Se nenhum perfil for encontrado para a chave do perfil `_phone`, o Customer Profiles criará um perfil inferido.
Para usar o modelo CTR- para substituir o NoInferred modelo CTR padrão, execute o seguinte comando na CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred`
Para reverter para o comportamento padrão, execute o seguinte comando na CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR`
# Exemplos de mapeamentos de tipo de objeto no Amazon Connect Customer Profiles
## Um mapeamento de tipo de objeto que gera um perfil
O exemplo a seguir mostra dados que preenchem o perfil padrão.
Este é o objeto de entrada:
```
{
"account": 1234,
"email": "john@examplecorp.com",
"address": {
"address1": "Street",
"zip": "Zip",
"city": "City"
},
"firstName": "John",
"lastName": "Doe"
}
```
O código a seguir mostra o mapeamento de objetos de entrada em um objeto de perfil padrão e a indexação `PersonalEmailAddress`, `fullName` e `accountId`, que é uma chave exclusiva.
```
{
"Fields": {
"accountId": {
"Source": "_source.account",
"Target": "_profile.AccountNumber",
"ContentType": "NUMBER"
},
"shippingAddress.address1": {
"Source": "_source.address.address1",
"Target": "_profile.ShippingAddress.Address1"
},
"shippingAddress.postalCode": {
"Source": "_source.address.zip",
"Target": "_profile.ShippingAddress.PostalCode"
},
"shippingAddress.city": {
"Source": "_source.address.city",
"Target": "_profile.ShippingAddress.City"
},
"personalEmailAddress": {
"Source": "_source.email",
"Target": "_profile.PersonalEmailAddress",
"ContentType": "EMAIL_ADDRESS"
},
"fullName": {
"Source": "{{_source.firstName}} {{_source.lastName}}"
},
"firstName": {
"Source": "_source.firstName",
"Target": "_profile.FirstName"
},
"lastName": {
"Source": "_source.lastName",
"Target": "_profile.LastName"
}
},
"Keys": {
"_email": [
{
"FieldNames": ["personalEmailAddress"]
}
],
"_fullName": [
{
"FieldNames": ["fullName"]
}
],
"_account": [
{
"StandardIdentifiers": ["PROFILE","UNIQUE"],
"FieldNames": ["accountId"]
}
]
}
}
```
Observe que `email` e `fullname` estão indexados, mas não são usados para pesquisar o perfil. A conta é a chave exclusiva. É necessário especificar o objeto. Sempre que um objeto com o mesmo ID de conta é ingerido, ele substitui o objeto anterior pelo mesmo ID de conta.
Vários campos são preenchidos no objeto de perfil padrão (veja os campos que têm `Target` definido).
## Um mapeamento de tipo de objeto que não preenche o perfil padrão
Este exemplo mostra um caso de uso mais complicado. Ele ingere dados relacionados a um perfil, mas não necessariamente preenche o objeto de perfil padrão.
Este é o objeto de entrada:
```
{
"email": "john@examplecorp.com",
"timestamp": "2010-01-01T12:34:56Z",
"subject": "Whatever this is about",
"body": "Body of ticket"
}
```
Veja a seguir uma forma de mapear esses dados:
```
{
"Fields": {
"email": {
"Source": "_source.email",
"ContentType": "EMAIL_ADDRESS"
},
"timestamp": {
"Source": "_source.timestamp"
}
},
"Keys": {
"_email": [
{
"StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
"FieldNames": ["email"]
}
],
"ticketEmail": [
{
"StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
"FieldNames": ["email"]
}
],
"uniqueTicket": [
{
"StandardIdentifiers": ["UNIQUE"],
"FieldNames": ["email","timestamp"]
}
]
}
}
```
Esse exemplo ingere os dados e, na primeira consulta, ingere o endereço de e-mail.
+ Se o endereço de e-mail corresponder a um único perfil, ele será usado para anexar os dados a esse perfil específico. O identificador exclusivo do tíquete é composto pelo e-mail e pelo carimbo de data/hora, já que não existe outro identificador exclusivo.
+ Se não existir nenhum perfil com o e-mail especificado, um novo perfil será criado com o único campo `EmailAddress` preenchido. O objeto ingerido é anexado a esse novo **perfil inferido**. As duas teclas pesquisáveis que podem encontrar o perfil são `_email` e `uniqueTicket`.
+ Se mais de um perfil existir com o endereço de e-mail especificado, um novo perfil será criado com o único campo de `EmailAddress` preenchido e o objeto anexado a esse novo perfil. Esse perfil é criado com a chave `ticketEmail` definida, além de `_email` e `uniqueTicket`. Todos os tíquetes subsequentes desse e-mail são atribuídos a esse novo **perfil inferido**. A razão disso é que a chave ` _email` se refere a três perfis e, portanto, é descartada; no entanto, a chave `ticketEmail` se refere apenas a um único perfil (o novo inferido) e ainda é válida.
+ Nos casos em que um novo **perfil inferido** é criado, o `EmailAddress` campo é preenchido a partir do primeiro objeto que o criou.
# Tipos de objetos de perfil implícitos no Amazon Connect Customer Profiles
Você pode usar qualquer tipo de objeto que corresponda ao nome de um ID de modelo (conforme retornado pela [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API) sem defini-lo explicitamente. O tipo de objeto corresponderá exatamente à definição do modelo desse tipo de objeto. Se um tipo de objeto explícito for definido, ele substituirá o implícito.
Os tipos de objetos implícitos são incluídos na [ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html)API ou retornados pelas [GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html)operações, mas ainda podem ser excluídos se você quiser remover todos os dados ingeridos desse tipo de objeto.
# Mapeamento de dados com IA generativa no Amazon Connect
Amazon Connect O Customer Profiles fornece um recurso generativo de mapeamento de dados de clientes baseado em IA que reduz significativamente o tempo necessário para criar perfis unificados, permitindo que você ajude a fornecer experiências de cliente mais personalizadas.
Com esse recurso, quando os administradores do contact center adicionam dados de clientes de qualquer um dos mais de 70 conectores de dados sem código disponíveis, como Adobe Analytics, Salesforce ou Amazon Simple Storage Service (S3) Amazon Connect , os perfis de clientes analisam os dados dessas fontes para determinar automaticamente como organizar e combinar dados que existem em diferentes formatos em fontes diferentes em perfis unificados em. Amazon Connect Os administradores do contact center podem revisar e concluir a configuração dos perfis dos clientes, para que possam fornecer aos agentes informações relevantes sobre os clientes e personalizar dinamicamente os chatbots para melhorar a satisfação do cliente IVRs e a produtividade dos agentes.
O mapeamento de dados de cliente com IA generativa está disponível nas seguintes regiões:
+ Leste dos EUA (N. da Virgínia)
+ Oeste dos EUA (Oregon)
+ África (Cidade do Cabo)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Sydney)
+ Ásia-Pacífico (Tóquio)
+ Ásia-Pacífico (Seul)
+ Canadá (Central)
+ Europa (Frankfurt)
+ Europa (Londres)
## Configurar mapeamento de dados com IA generativa
1. Abra o console Perfis de Amazon Connect clientes.
1. Na guia **Integrações de origens de dados**, escolha **Adicionar integração com origem dos dados**.
1. Configure a conexão. Selecione a fonte de dados no menu suspenso que tem todos os conectores compatíveis disponíveis.
![\[Selecione a fonte de dados no menu suspenso que tem todos os conectores compatíveis disponíveis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)
1. Mapeie os dados. Selecione a opção para gerar automaticamente o mapeamento de dados ou selecione um modelo de mapeamento já existente ou crie um do zero.
![\[Mapeie os dados. Selecione a opção para gerar automaticamente o mapeamento de dados ou selecione um modelo de mapeamento já existente ou crie um do zero.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png)
1. Analise o resumo do mapeamento. Analise o resumo dos resultados do mapeamento gerado automaticamente que mostra todos os atributos do cliente. Faça edições nas chaves de ingestão e confirme antes de iniciar a ingestão de dados. Para obter mais informações sobre mapeamentos de campo e chaves, consulte [Detalhes da definição de mapeamento de tipo de objeto no Amazon Connect Customer Profiles](object-type-mapping-definition-details.md).
![\[Analise o resumo do mapeamento. Analise o resumo dos resultados do mapeamento gerado automaticamente que mostra todos os atributos do cliente. Faça edições nas chaves de ingestão e confirme antes de iniciar a ingestão de dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)
## Como funciona
O sistema funciona em quatro fases. Na primeira fase, o Customer Profiles busca os atributos da fonte e, se disponíveis, faz amostras dos dados da fonte de dados, determinando depois o tipo de objeto mais indicado para o destino. Para uma fonte de dados do Amazon S3, o primeiro arquivo CSV encontrado no bucket e no prefixo do Amazon S3 selecionados será usado como os dados de amostra. Para outras fontes de dados, o Customer Profiles busca atributos de origem por meio de AppFlow. Na segunda fase, um grande modelo de linguagem (LLM) é utilizado para processar ainda mais cada um dos atributos personalizados e mapeá-los de acordo com os atributos padrão do perfil do cliente. O LLM é usado novamente na terceira fase para selecionar os atributos indicados que podem funcionar como chaves, como identificadores de cliente. Por fim, na quarta fase, o detector do formato do carimbo de data/hora analisa os carimbos para manter a ordem cronológica correta dos registros. O sistema é capaz de gerar o mapeamento para até 120 atributos em menos de 20 segundos após combinar os resultados da previsão.
## Solução de problemas do mapeamento de dados com IA generativa
As seções a seguir exibem as possíveis mensagens de erro que você pode encontrar. Ele também fornece a causa e a resolução de cada problema.
### Erro: não foi possível analisar a string do objeto em JSON
A string do objeto na solicitação não é um JSON válido. Analise a string do objeto na solicitação e verifique se ela é um JSON válido.
### Erro: falha no valor de “objects” em atender à restrição: o Membro deve ser menor que ou igual a 5
Há muitos objetos na solicitação. Até cinco objetos são permitidos em uma solicitação. Reduza o número de objetos para cinco ou menos.
### Erro: limite de 120 atributos violado
Até 120 atributos são permitidos em um objeto JSON, incluindo atributos JSON aninhados. Remova alguns atributos que não precisam ser mapeados do objeto JSON.
![\[Até 120 atributos são permitidos em um objeto JSON, incluindo atributos JSON aninhados. Remova alguns atributos que não precisam ser mapeados do objeto JSON.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)
### Aviso: não foi possível encontrar uma **chave exclusiva** que diferencie os dados. Não foi possível encontrar uma **chave de perfil** que identifique os perfis.
O modelo não conseguiu encontrar um tipo de objeto válido em um determinado objeto. Altere a entrada ou use a abordagem de mapeamento manual conforme sugerido.
![\[O modelo não conseguiu encontrar um tipo de objeto válido em um determinado objeto. Altere a entrada ou use a abordagem de mapeamento manual conforme sugerido.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png)
# Limites de dados do Amazon Connect Customer Profiles
O Amazon Connect Customer Profiles permite que você personalize a integração de dados definindo limites de ingestão de dados em vários tipos de dados de clientes que você usa para criar um perfil unificado. Definir limites nos mapeamentos de dados permite que você priorize a quantidade de dados a ser ingerida em todos os mapeamentos. O limite máximo padrão em todos os mapeamentos por perfil é 1.000.
**nota**
Os limites de dados são estimativas e podem variar um pouco, com um possível desvio de algumas unidades em qualquer direção durante períodos de alta ingestão em um único perfil.
## Como configurar os limites de dados do Customer Profiles
1. Abra o console Perfis de Amazon Connect clientes.
1. Escolha a guia **Limites de dados** para configurar limites para objetos de dados.
![\[Navegue até a guia Limites de dados para configurar limites para objetos de dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)
1. Passe o mouse sobre o limite do objeto de dados desejado e escolha o ícone de edição.
![\[Passe o mouse sobre o limite do objeto de dados desejado e escolha o ícone de edição.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)
1. Insira o limite e selecione o ícone de marca de seleção para salvar ou atualizar o limite.
![\[A imagem mostra um novo limite sendo inserido e destaca o ícone de marca de seleção usado para salvar ou atualizar o limite.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)
## Como limpar os limites de dados do Customer Profiles
1. Selecione o botão de opção para o objeto de dados cujo limite você deseja limpar. Em seguida, você poderá escolher **Limpar limite**.
![\[Destaca o botão de opção à esquerda do objeto de dados na página Limites de dados. Selecionar um botão de opção aqui permite que você habilite o botão Limpar para um limite de dados do objeto.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)
1. Digite *confirm* para limpar o valor limite do objeto de dados selecionado.
![\[Uma caixa pop-up que solicita que você confirme que deseja limpar o valor limite do objeto de dados. Você confirma a ação de limpeza digitando “confirm” em letra minúscula.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)
# Criar e ingerir dados de clientes no Customer Profiles
Você pode definir dados de qualquer fonte usando o Amazon S3 e enriqueça perfeitamente um perfil de cliente sem a necessidade de integrações personalizadas ou predefinidas. Por exemplo, digamos que você queira fornecer aos atendentes informações relevantes do histórico de compras. Você pode importar dados de transações de compra de uma aplicação interna para um arquivo de planilha no S3 e depois vinculá-los a um perfil de cliente.
Para configurar isso, você precisa definir um [mapeamento de tipo de objeto](customer-profiles-object-type-mapping.md) que descreve a aparência do objeto de perfil personalizado. Esse mapeamento define como os campos de seus dados podem ser usados para preencher campos no perfil padrão ou como podem ser usados para atribuir os dados a um perfil específico.
Depois de criar o mapeamento do tipo de objeto, você pode usar a [PutProfileObject](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObject.html)API para carregar os dados do perfil personalizado do seu CRM para o objeto de perfil personalizado.
**nota**
O Customer Profiles não dá suporte à ingestão de dados de cabeçalhos CSV que contenham notação de pontos.
Para obter uma lista das permissões do IAM necessárias para que o Customer Profiles acesse dados do bucket do Amazon S3 para mapeamento de dados, consulte a tabela `PutProfileObject` em [Actions defined by Amazon Connect Customer Profiles](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnectcustomerprofiles.html#amazonconnectcustomerprofiles-actions-as-permissions).
## Ingestão de perfis de clientes
**Ingestão de perfis baseados em contas**
1. Faça upload de arquivos de dados no S3. A ingestão dos perfis referenciados em perfis de contas e dos próprios perfis de contas deve ocorrer separadamente.
1. O novo arquivo usado para a ingestão de perfis de contas deve incluir novos atributos: tipo de perfil e preferências de engajamento por e-mail e telefone.
1. Ingestão de arquivos do S3 para o perfil de cliente usando o Console da AWS
**Exemplo de CSV de perfis (referenciados nos seguintes perfis baseados em contas)**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**Exemplo de CSV de perfis baseados em contas**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**Exemplo de preferências de engajamento por e-mail**:
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PersonalEmailAddress"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PersonalEmailAddress"}
]
```
**Exemplo de preferências de engajamento por telefone**:
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PhoneNumber"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PhoneNumber"}
]
```
**nota**
Pois **ProfileType**`PROFILE`, você pode ingerir e adicionar preferências de engajamento usando o mesmo método.
1. Crie dois mapeamentos de dados: um para subperfis e outro para perfis baseados em contas.
![\[Crie duas integrações de fonte de dados, cada uma criando um mapeamento com base na relação descrita. Por exemplo, contas/perfis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-1.png)
1. Em seguida, mapeie os atributos de perfil de cliente. Observe o destino chamado `ProfileType`.
![\[Em seguida, mapeie os atributos de perfil de cliente. Anote o destino chamado ProfileType.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-2.png)
**Exemplo de mapeamento de tipo de objeto para a ingestão de perfis referenciados em perfis baseados em contas**
```
{
"AllowProfileCreation": true,
"Description": "Standard Profile Object Type",
"Fields": {
"FirstName": {
"ContentType": "STRING",
"Source": "_source.FirstName",
"Target": "_profile.FirstName"
},
"LastName": {
"ContentType": "STRING",
"Source": "_source.LastName",
"Target": "_profile.LastName"
},
"PhoneNumber": {
"ContentType": "PHONE_NUMBER",
"Source": "_source.PhoneNumber",
"Target": "_profile.PhoneNumber"
},
"PersonalEmailAddress": {
"ContentType": "EMAIL_ADDRESS",
"Source": "_source.PersonalEmailAddress",
"Target": "_profile.PersonalEmailAddress"
},
"State": {
"ContentType": "STRING",
"Source": "_source.State",
"Target": "_profile.Address.State"
},
"CustomerId": {
"ContentType": "STRING",
"Source": "_source.CustomerId",
"Target": "_profile.Attributes.CustomerId"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
}
},
"Keys": {
"CustomerId": [
{
"FieldNames": [
"CustomerId"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. Repita o processo para fazer a ingestão de perfis baseados em contas. Nota: EngagementPreferences .E-mail e EngagementPreference .Phone.
![\[Repita o processo para fazer a ingestão de perfis baseados em contas. Nota: EngagementPreferences .E-mail e EngagementPreference .Phone.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-3.png)
**Exemplo de mapeamento de tipo de objeto para a ingestão de perfis baseados em contas**
```
{
"AllowProfileCreation": true,
"Description": "Account-based profiles Object Type",
"Fields": {
"AccountNumber": {
"ContentType": "STRING",
"Source": "_source.AccountId",
"Target": "_profile.AccountNumber"
},
"PrimaryOwner": {
"ContentType": "STRING",
"Source": "_source.PrimaryOwner",
"Target": "_profile.Attributes.PrimaryOwner"
},
"SecondaryOwner": {
"ContentType": "STRING",
"Source": "_source.SecondaryOwner",
"Target": "_profile.Attributes.SecondaryOwner"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
},
"EmailEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.EmailEngagementPreferences",
"Target": "_profile.EngagementPreferences.Email"
},
"PhoneEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.PhoneEngagementPreferences",
"Target": "_profile.EngagementPreferences.Phone"
}
},
"Keys": {
"Account": [
{
"FieldNames": [
"AccountNumber"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. Crie duas integrações de fonte de dados, cada uma criando um mapeamento com base na relação descrita. Por exemplo, contas/perfis.
**nota**
A ingestão de perfis baseados em contas só deve ocorrer após a verificação bem-sucedida da ingestão de perfis referenciados em perfis baseados em contas usando a API ou as métricas de [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)perfil no console Amazon Connect Customer Profiles.
O mapeamento de geração automática não funciona para a ingestão de perfis baseados em contas e seus subperfis.
A lista de preferências de contato por e-mail e telefone pode ter `KeyName` e `KeyValue` ou `ProfileId` para fazer referência a perfis filhos. `KeyName` deve ser o identificador exclusivo.
As atualizações nos subperfis não atualizam as preferências de engajamento nos perfis baseados em contas. As atualizações precisam acontecer por meio do caminho de ingestão.
# Criar uma integração do Kinesis com o Amazon Connect Customer Profiles
As etapas a seguir descrevem o processo de streaming de objetos de um fluxo de dados do Amazon Kinesis para o Amazon Connect Customer Profiles. A integração consiste em duas etapas principais:
1. Configure um EventBridge Pipe para transmitir dados do seu Kinesis Data Stream para um EventBridge barramento.
1. Configure uma integração de dados do Customer Profiles com seu Kinesis Data Stream usando o Pipe criado EventBridge
## Etapa 1: Transmita dados do Kinesis para EventBridge
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)
1. No painel de navegação, selecione **Event buses (Barramentos de eventos)**.
1. Selecione **Create event bus (Criar barramento de eventos)**.
1. Na seção **Detalhes de barramento de eventos**, forneça um nome descritivo. Por exemplo, .`kinesis-to-customer-profiles`
1. Escolha **Criar**.
1. Acesse a página de detalhes do seu fluxo de dados do Kinesis.
1. Selecione a guia **EventBridge Pipes** e escolha **Connect Kinesis Data Stream to** Pipe.
1. Crie um nome para seu EventBridge cachimbo.
1. Siga o assistente de configuração até chegar à página **Configuração do destino**.
1. Para o destino, selecione o barramento de eventos criado na etapa 1. Por exemplo, .`kinesis-to-customer-profiles`
1. Após a seção **Destino**, expanda o menu sanfonado **Transformador de entrada de destino**.
1. Defina o transformador de entrada de destino da seguinte forma:
```
{
"data": <$.data>
}
```
1. Escolha **Criar pipe** para concluir a configuração.
Neste ponto, você configurou com sucesso o roteamento dos eventos do Kinesis para o. EventBridge Em seguida, criaremos uma integração com o Customer Profiles.
## Etapa 2: ingerir EventBridge dados em perfis de clientes
1. Acesse o **Customer Profiles** no console do Amazon Connect.
1. Selecione a guia **Integrações de origens de dados** e escolha **Adicionar uma integração com origem de dados**.
1. Selecione **Kinesis** no menu suspenso **Fonte de dados**.
1. **No menu suspenso **do nome do EventBridge canal**, selecione o canal que foi criado na Etapa 1 e escolha Avançar.**
1. Na página **Dados do mapa**, selecione o mapeamento de tipos de objeto apropriado e escolha **Próximo**.
1. Revise a configuração na página **Analisar e integrar** e escolha **Adicionar integração com origem dos dados** para concluir a configuração.
O fluxo de dados do Kinesis agora está integrado ao Amazon Connect Customer Profiles, e você já está com tudo pronto para enviar eventos do Kinesis ao Customer Profiles.
# Exportar dados unificados do perfil de cliente
Amazon Connect O Customer Profiles fornece exportação de dados em tempo real de perfis unificados de clientes para um Amazon Kinesis Data Stream. Você pode habilitar o fluxo de dados e receber automaticamente dados de novos perfis e atualizações de perfis existentes no Amazon Kinesis Data Stream.
Você pode manter seus dados de sistemas de origem, como ferramentas CRMs de automação de marketing, up-to-date com as informações mais recentes dos perfis de Amazon Connect clientes. Por exemplo, quando um cliente liga para sua central de atendimento para atualizar seu endereço, um atendente pode fazer a alteração para adicionar o novo endereço do cliente, e as informações atualizadas do perfil são enviadas para um Kinesis Data Stream em tempo real.
Para configurar isso, você precisa ativar a **exportação de dados** no console do Customer Profiles.
## Habilitar exportação em tempo real
**Para habilitar o fluxo de dados para seu domínio**
1. Abra o console Perfis de Amazon Connect clientes.
1. Selecione a guia **Exportação de dados** e escolha **Ativar streaming de dados**
![\[A exportação de dados em tempo real permite o fluxo de dados do Kinesis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-real-time-export-1.png)
1. Escolha **Ativar streaming de dados** e selecione um fluxo de dados do Kinesis existente no menu suspenso ou escolha **Criar um novo fluxo de dados do Kinesis** para abrir o console do Kinesis e criar o fluxo. Para obter mais informações, consulte [Creating and Managing Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
![\[A exportação de dados em tempo real permite o fluxo de dados do Kinesis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. Escolha o botão **Ativar streaming de dados** para salvar suas configurações.
## Habilitar a exportação em tempo real
**Para desabilitar o fluxo de dados para seu domínio**
1. Abra o console Perfis de Amazon Connect clientes.
1. Selecione a guia **Exportação de dados** e escolha **Desabilitar o streaming de dados**
![\[A exportação de dados em tempo real desabilita o fluxo de dados do Kinesis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/disable-real-time-export-1.png)
## Exportação da carga útil do Kinesis em tempo real
**Exemplo de evento de saída em JSON**
```
{
"SchemaVersion": 0,
"EventId": "eventId",
"EventTimestamp": "2020-01-01T00:00:00Z",
"EventType": "CREATED",
"DomainName": "domainName",
"ObjectTypeName": "objectTypeName",
"AssociatedProfileId": "associatedProfileId",
"ProfileObjectUniqueKey": "profileObjectUniqueKey",
"Object": {
"map": {
"k1": [
"a",
"b",
"c"
]
}
},
"IsMessageRealTime": true
}
```
**SchemaVersion**
A versão atual do esquema.
**EventId**
O ID exclusivo do evento.
**EventTimestamp**
Registro de data e hora do evento usando o ISO8601 padrão.
**EventType**
O tipo de evento exportado.
Valores: CREATED, UPDATED, HEALTH\$1CHECK
+ CRIADO: O evento de exportação foi para CreateProfile.
+ ATUALIZADO: O evento de exportação foi para um UpdateProfile.
+ HEALTH\$1CHECK: O evento de exportação foi para garantir que os perfis de clientes pudessem ser bem-sucedidos no `putEvent` Kinesis Stream. HealthCheck
**DomainName**
O domínio ao qual o evento `/Domain` pertence.
**ObjectTypeName**
Tipo de objeto do evento
Valores: `_profile`, `_asset`, `_order`, `_case`. Você também pode usar um nome de modelo predefinido, como `Salesforce-Account` ou um nome de objeto definido personalizado que você pode criar usando a [ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
**AssociatedProfileId**
ID do perfil padrão ao qual o objeto está associado. Ele só estará presente se o tipo de objeto não for `_profile`
**ProfileObjectUniqueKey**
O identificador exclusivo do ProfileObject gerado pelo serviço.
Tipo: string
**Object**
O perfil padrão ou o próprio objeto de perfil padrão.
**IsMessageRealTime**
Sinalize para informar se a mensagem está em tempo real ou foi redirecionada.
**Exemplo de carga útil em JSON**
```
{
"SchemaVersion": 0,
"EventId": "6049bf39-0000-0000-0000-b75656dd51a8",
"EventTimestamp": "2023-02-24T07:17:05.356Z",
"EventType": "UPDATED",
"DomainName": "SampleDomain",
"ObjectTypeName": "Salesforce-Account",
"AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40",
"ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=",
"Object": {
"Id": "0012v00002kVKVuAAO",
"IsDeleted": false,
"Name": "Company A",
"Phone": "+12065551234",
"PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO",
"OwnerId": "0052v00000fmQ7sAAE",
"CreatedDate": "2019-12-13T07:56:04.000+0000",
"CreatedById": "0052v00000fmQ7sAAE",
"LastModifiedDate": "2023-02-22T20:29:43.000+0000",
"LastModifiedById": "0052v00000fmQ7sAAE",
"SystemModstamp": "2023-02-22T20:29:43.000+0000",
"LastActivityDate": "2020-03-18",
"LastViewedDate": "2023-02-23T00:09:49.000+0000",
"LastReferencedDate": "2023-02-23T00:09:49.000+0000",
"CleanStatus": "Pending"
},
"IsMessageRealTime": true
}
```
# Solucionar problemas de exportação de eventos em tempo real para o fluxo de dados do Kinesis
Pode haver um atraso na primeira exportação de eventos para o fluxo de dados do Kinesis. Isso se deve ao tempo necessário para propagar as permissões do IAM para a função vinculada ao serviço. Quando ocorre um problema real, o status de transmissão pode entrar em um estado de erro.
![\[Eventos incapazes de alcançar o fluxo de dados do Kinesis de destino entrando em um estado de erro.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
As seções a seguir exibem as possíveis mensagens de erro que você pode encontrar. Ele também fornece a causa e a resolução de cada problema.
## Erro: o Kinesis Data Stream não está ativo. Verifique a configuração e recrie o fluxo de eventos mais tarde
O Kinesis Data Stream de destino não está no estado `ACTIVE`. Isso pode acontecer quando seu Kinesis Data Stream está sendo criado ou excluído. Para resolver o erro, verifique se o Kinesis Data Stream está no estado ACTIVE e reative a configuração do streaming de dados.
## Erro: o Kinesis Data Stream não existe. Recrie o fluxo de eventos com um destino do Kinesis Data Stream válido
O Kinesis Data Stream de destino foi excluído. Para resolver o erro, reative o streaming de dados com um Kinesis Data Stream existente como destino.
## Erro: a utilização do Kinesis Data Stream está sendo controlada. Considere provisionar adequadamente uma taxa de transferência maior do Kinesis
A utilização do Kinesis Data Stream de destino está sendo controlada (subprovisionado). Para resolver o erro, certifique-se de que o Kinesis Data Stream de destino tenha contagem de fragmentos suficiente e reative o streaming de dados.
## Erro: a utilização da chave do KMS usada para criptografar o Kinesis Data Streams está sendo controlada. Considere aumentar a cota de solicitações do KMS de forma adequada
A utilização da chave do KMS usada pelo Kinesis Data Streams está sendo controlada. Para resolver o erro, reative o streaming de dados.
## Erro: verifique a configuração da chave do KMS do seu Kinesis Data Streams
O Customer Profiles não pode acessar a chave do KMS usada pelo Kinesis Data Streams. Isso pode acontecer quando sua chave do KMS tem uma política de chave que nega o acesso da função vinculada ao serviço Customer Profiles ou quando a chave não está no status habilitado. Para resolver o erro, a política de chaves do KMS não deve negar o acesso da função vinculada ao serviço Customer Profiles e a chave deve estar no status Habilitado. Reative o streaming de dados para resolver o erro.
# Configurar a exportação em massa para todos os dados unificados do perfil de cliente
**nota**
Para concluir as etapas deste tópico, você precisa ter habilidades de desenvolvedor e ter experiência com o uso AWS KMS do Amazon S3.
Quando o Amazon Connect Customer Profiles cria um perfil de cliente unificado, ele aprimora e refina dados e informações brutos em um perfil mais preciso, combinando dados de fontes primárias e terceirizadas. O Customer Profiles também melhora a qualidade dos conjuntos de dados por meio da adição de novos dados. Você pode usar os conjuntos de dados aprimorados para casos de uso adicionais, como formular estratégias de marketing, vendas e atendimento ao cliente mais informadas e direcionadas. Por exemplo, talvez você queira aproveitar o perfil unificado do cliente para:
+ Auditar os dados do cliente que você tem na totalidade de um domínio.
+ Executar análises internas, por exemplo, para relatórios de vendas e marketing.
+ Exportar os dados para suas próprias ferramentas ou produtos de terceiros para personalizar anúncios e segmentar clientes.
Você pode exportar os dados do perfil do cliente unificados em massa para o Amazon S3 Para aproveitá-los em casos de uso adicionais. Este tópico explica como fazer isso.
**Topics**
+ [
## Etapa 1: Configurar uma chave do KMS e um bucket do S3
](#enable-cpbulk-export)
+ [
## Etapa 2: Criar um trabalho de exportação em massa
](#create-bulk-export-job)
+ [
## Etapa 3: Verificar o status de um trabalho de exportação em massa
](#check-status-bulk-cp-export)
+ [
## Etapa 4: Visualizar os dados exportados no S3
](#view-bulk-cp-export)
+ [
## Atualizar o trabalho de exportação em massa
](#update-bulk-cp-export)
+ [
## Excluir ou cancelar o trabalho de exportação em massa (não compatível)
](#delete-bulk-cp-export)
## Etapa 1: Configurar uma chave do KMS e um bucket do S3
Para habilitar a exportação em massa em domínio, você precisará configurar os seguintes recursos:
+ [Uma chave do KMS com uma política de recursos específica](#cp-kms)
+ [Um bucket do S3 de destino com uma política de recursos específica](#cp-s3-bulk). Não configure [listas de controle de acesso (ACLs)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html) no bucket.
Essas etapas serão explicadas a seguir.
### Criar uma chave do KMS ou reutilizar uma chave do KMS existente
Para configurar uma chave KMS para exportação em massa, você deve criar ou reutilizar uma chave KMS existente que esteja na mesma AWS região do bucket do Amazon S3 que você planeja configurar como seu destino de exportação em massa. Você deve permitir que o AppIntegrations serviço Amazon Connect execute ações do KMS para a chave.
Adicione a seguinte declaração à **política de chave**.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Enable AppIntegrations access to KMS key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:root"
],
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"kms:Encrypt*",
"kms:Describe*",
"kms:Decrypt*",
"kms:GenerateDataKey*"
],
"Resource": "*"
}
]
}
```
------
### Configurar um bucket do S3 de destino
Você deve configurar um bucket novo ou existente na mesma AWS região da chave KMS e configurar uma política de recursos no bucket do S3.
Ao configurar o bucket, selecione **Criptografia com SSE-KMS** e use a mesma chave do KMS do procedimento anterior. Além disso, não habilite ACLs no bucket do S3.
Veja a seguir um exemplo de política de recursos.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow AppIntegrations to write data to destination bucket",
"Effect": "Allow",
"Principal": {
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket1}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{AwsAccountId}}"
},
"ArnEquals": {
"aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*"
}
}
}
]
}
```
------
## Etapa 2: Criar um trabalho de exportação em massa
Para criar um trabalho de exportação em massa, você invoca o seguinte Amazon Connect AppIntegrations APIs:
1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): essa API cria uma integração com a fonte de dados (por exemplo, perfis de clientes).
1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): essa API grava dados no destino (por exemplo, um bucket do S3) usando a fonte de dados.
A seguir estão mais informações sobre como chamá-los APIs.
### Criar uma integração de dados
Uma integração de dados representa a *fonte de dados* dos seus dados. Você pode chamar a [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API ou executar o comando [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI para criar uma integração de dados. Você deve fornecer um *tipo de objeto* e um *domínio* do Customer Profiles.
Se você quiser exportar vários tipos de objetos, precisará criar uma integração de dados separada para cada um. Por exemplo, se você quiser exportar objetos `_profile` e `_asset`, precisará criar duas integrações de dados separadas.
**nota**
Qualquer dado ingerido nos últimos 30 minutos não pode ser incluído na exportação.
O exemplo de código a seguir mostra como executar o comando da [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI.
```
aws appintegrations create-data-integration \
--region "us-west-2" \
--name "bulk-export-job-01" \
--description "Data integration for _profile objects" \
--kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \
--source-uri "AmazonConnect://AppIntegrations" \
--object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}'
```
O exemplo de código a seguir mostra como chamar a [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API.
```
{
"Description": "Data integration for _profile objects",
"KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012",
"Name": "unique-data-integration-name-01",
"SourceURI": "AmazonConnect://AppIntegrations",
"ObjectConfiguration": {
"CustomerProfiles": {
"domainName": [
"my-domain-pdx"
],
"objectType": [
"_profile"
]
}
}
}
```
### Criar uma associação de integração de dados
Uma associação de integração de dados representa o destino para onde você deseja exportar seus dados e um intervalo de tempo para escolher quais dados exportar. Você pode chamar a [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API ou executar o comando [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI para criar uma integração de dados. Use as propriedades `StartTime` e `EndTime` para configurar o intervalo de tempo. Esse intervalo de tempo corresponde a quando os objetos foram atualizados pela última vez no Customer Profiles.
O bucket do S3 de destino que você especificar pode ser apenas o nome do bucket ou pode incluir uma pasta adicional ou um prefixo do S3 para onde você deseja que os dados sejam exportados.
**nota**
Para obter a cota para **trabalhos de exportação simultânea em massa**, consulte [Amazon Connect Cotas de serviço de perfis de clientes](amazon-connect-service-limits.md#customer-profiles-quotas). Depois que um trabalho de exportação em massa é concluído ou falha, ele não conta mais para a cota de simultaneidade.
O exemplo de código a seguir mostra como executar o comando da [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI.
```
aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--destination-uri "s3://amzn-s3-demo-bucket1" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
O exemplo de código a seguir mostra como chamar a [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API.
```
{
"DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
"DestinationURI": "s3://amzn-s3-demo-bucket1",
"ExecutionConfiguration": {
"ExecutionMode": "ON_DEMAND",
"OnDemandConfiguration": {
"StartTime": "1713565000004",
"EndTime": "1713565000005"
}
}
}
```
## Etapa 3: Verificar o status de um trabalho de exportação em massa
Para ver o status do seu trabalho de exportação em massa, você pode chamar a [ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html)API ou executar o comando da [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
O exemplo de código a seguir mostra como executar o comando da [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
```
aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01"
```
## Etapa 4: Visualizar os dados exportados no S3
Quando a associação de integração de dados estiver `IN_PROGRESS`, você começará a ver os dados sendo copiados para o bucket do S3.
Os dados exportados são gravados usando a seguinte estrutura de caminho:
+ \$1BucketNameAndFolderName\$1
+ \$1AwsAccountId\$1
+ \$1DomainName\$1
+ \$1RequestTimestamp\$1
+ \$1lStartTime\$1-\$1EndTime\$1
+ \$1ObjectTypeName\$1
+
Veja a seguir um exemplo de um caminho:
`amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012`
## Atualizar o trabalho de exportação em massa
Depois que o trabalho for concluído, você poderá atualizar a associação de integração de dados com um horário de início e um horário de término de extração de dados diferentes. Isso cria um novo trabalho de exportação em massa. Talvez você queira fazer isso se tiver realizado uma exportação em massa no passado e quiser exportar somente os dados que foram atualizados desde a exportação anterior. Por exemplo, se seu último trabalho de exportação em massa foi há três meses, você pode atualizar a associação de integração de dados com um intervalo de tempo de três meses atrás até hoje.
Você pode chamar a [UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html)API ou executar o comando da [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI para atualizar o trabalho de exportação.
O exemplo de código a seguir mostra como executar o comando da [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI.
```
aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
## Excluir ou cancelar o trabalho de exportação em massa (não compatível)
Não é possível excluir ou cancelar uma exportação em massa. Depois que um trabalho de exportação é concluído, ele não conta mais para a cota de exportação.
# Excluir um domínio do Amazon Connect Customer Profiles
A exclusão de mapeamentos excluirá somente objetos e dados associados a esse mapeamento específico. Se houver vários objetos associados a um perfil, a exclusão de um mapeamento específico poderá não limpar os dados do perfil. Se quisesse excluir dados específicos, você excluiria o mapeamento, mas seus perfis ainda poderão existir se contiverem dados de outros mapeamentos. Isso pode resultar em cobranças adicionais para os perfis existentes. Para evitar que isso ocorra, você pode excluir seu domínio do Customer Profiles usando o console Amazon Connect seguindo estas etapas.
1. Faça login no Amazon Connect console e selecione Perfis de clientes no painel de navegação esquerdo. Escolha seu domínio do Customer Profiles e **Visualizar detalhes**.
![\[A página de exclusão do domínio do Amazon Connect Customer Profiles, o botão Visualizar detalhes.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/delete-customer-profiles-domain-step1.png)
1. Escolha **Delete domain.**
![\[A página de exclusão do domínio do Amazon Connect Customer Profiles, o botão Excluir domínio.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/delete-customer-profiles-domain-step2.png)
1. Para excluir seu domínio, digite *confirmar* na caixa e escolha **Excluir domínio**.
![\[A página de exclusão do domínio do Amazon Connect Customer Profiles, o botão Excluir domínio após a digitação manual de confirmar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/delete-customer-profiles-domain-step3.png)
# Configurar atributos calculados no Amazon Connect Customer Profiles
*Atributos calculados* são valores derivados de outros atributos usando fórmulas. Você pode usá-los para identificar os comportamentos agregados dos usuários.
É possível criar atributos calculados para definir sua própria lógica de negócios a fim de transformar os dados do perfil do cliente em pontos de dados acionáveis. Isso permite que você personalize experiências automatizadas, como respostas de voz interativas.
Ao usar atributos calculados, é possível identificar os principais atributos sobre o comportamento passado do cliente. Por exemplo:
+ O último site visitado ou o último atendente com quem conversou.
+ Padrões de comportamento, como canal preferido e frequência de contato.
+ Valor do cliente, como novo cliente e tamanho médio do tíquete.
Você pode usar a API de atributos calculados para criar um atributo usando operações de agregação comuns, como média, contagem, mínimo, máximo e soma.
Os atributos calculados transformam dados brutos em métricas e pontos de dados acionáveis de forma automática e em tempo real. Os administradores da central de atendimento podem definir e configurar cálculos com base nos dados brutos disponíveis nos perfis dos clientes. Esses atributos calculados facilitam a criação de experiências automatizadas, como Interactive Voice Response (IVR – Resposta de Voz Interativa) ou chatbots. Você pode criar experiências personalizadas e ajudar os atendentes a entender o contexto do cliente com mais rapidez.
Para obter uma lista das AWS regiões em que os atributos calculados APIs estão disponíveis, consulte[Customer Profiles atributos calculados disponibilidade da API por região](regions.md#customerprofiles_calculatedattributesregion).
**Topics**
+ [Conceitos básicos dos atributos calculados](customerprofiles-calculated-attributes-admin-website.md)
+ [Atributos calculados APIs](customerprofiles-calculated-attributes-apis.md)
+ [Criar uma definição personalizada de atributo calculado](customerprofiles-calculated-attributes-creating-definition.md)
+ [Validar valores de atributos calculados](customerprofiles-calculated-attributes-validating-values.md)
+ [Atributos calculados padrão](customerprofiles-default-calculated-attributes.md)
+ [Mensagens de erro e resoluções](customerprofiles-calculated-attributes-troubleshooting.md)
# Introdução aos atributos calculados nos Perfis de Amazon Connect clientes
Use os atributos calculados para definir sua própria lógica de negócios a fim de transformar os dados do perfil do cliente em pontos de dados acionáveis para personalizar experiências automatizadas, como respostas de voz interativas.
Ao usar atributos calculados, é possível identificar os principais atributos sobre o comportamento passado, os padrões de comportamento e o valor do cliente.
Os tópicos desta seção mostram como criar, visualizar, editar e excluir Atributos calculados.
**Topics**
+ [Criar atributos calculados](calculated-attributes-admin-website-create.md)
+ [Configurar filtros de eventos](calculated-attributes-admin-website-event-filters.md)
+ [Visualizar atributos calculados](calculated-attributes-admin-website-view.md)
+ [Editar atributos calculados](calculated-attributes-admin-website-edit.md)
+ [Excluir atributos calculados](calculated-attributes-admin-website-delete.md)
# Criar atributos calculados no Amazon Connect
1. Pré-requisitos: verifique se você tem as permissões de perfil de segurança necessárias. Para obter mais informações, consulte [Atualizar permissões para atributos calculados no Amazon Connect Customer Profiles](security-profile-customer-profile-calc-attribs.md).
1. No site do Amazon Connect administrador, navegue até **Perfis de clientes**, **Atributos calculados** e escolha **Criar atributo** na exibição da tabela de **atributos calculados**.
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-1.png)
1. Para criar um atributo calculado, atribua um nome descritivo, adicione uma descrição (opcional) com detalhes sobre o atributo e configure os campos obrigatórios:
+ **Cálculo:** define como os atributos são computados (average/count/sum/minimum/first occurrence/last occurrence/maxocorrência).
+ **Atributo:** um ponto de dados dos dados dos perfis de cliente.
**nota**
Se você estiver selecionando um atributo de um tipo de objeto padrão (`_asset``_case`,,`_order`), os atributos devem estar dentro PascalCase. Isso significa que a primeira letra de cada palavra no nome do atributo está em letra maiúscula, como `_case.CreatedBy` ou `_order.TotalPrice`.
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-2.png)
1. Além disso, você pode adicionar outro atributo selecionando o ícone de *adição*. Você pode escolher até dois atributos para o cálculo e combiná-los por um operador. Especifique um operador, como *adição* ou *subtração*, para combinar os valores de atributo.
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-3.png)
1. Depois que o cálculo for selecionado, você terá a opção de configurar o Número de eventos, o Período e o Carimbo de data/hora da origem. Por padrão, os atributos calculados são configurados para usar eventos ilimitados, um período ilimitado e um carimbo de data/hora com base na data de ingestão.
Uma saída é retornada quando há pelo menos um evento durante o período especificado.
+ **Número de eventos:** configure um limite ou use de forma ilimitada (padrão).
+ **Período:** defina um prazo específico ou use de forma ilimitada (padrão).
+ **Carimbo de data/hora da origem:** escolha entre um campo específico de carimbo de data/hora ou data de ingestão (padrão).
**nota**
Embora não haja limite de eventos, existe um limite de tamanho de dados em que os dados mais antigos serão substituídos por dados mais novos. O carimbo de data/hora da origem não poderá ser alterado após a criação.
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-4.png)
1. Também é possível definir critérios para incluir somente eventos relevantes nos cálculos. Consulte [Configurar filtros de eventos](calculated-attributes-admin-website-event-filters.md) para obter mais informações.
1. Selecione **Criar** para criar o atributo calculado.
1. Após a criação bem-sucedida de um atributo calculado, um banner é exibido na visualização de tabela para usar o atributo calculado em um segmento ou fluxo. Você também poderá ver o status dos atributos calculados com base na prontidão.
![\[Um banner informando que o atributo calculado foi criado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-5.png)
# Configurar filtros de eventos
Os filtros de eventos permitem filtrar os objetos de perfil a serem usados no atributo calculado. Por exemplo, um filtro de eventos pode filtrar os objetos de ativos padrão do cliente para que somente os ativos com **Status Instalado OU Registrado** sejam incluídos no cálculo.
**nota**
Não é possível editar filtros de eventos depois de criar uma definição de atributo calculado.
Ao criar um atributo calculado, você pode criar um ou mais filtros de eventos. Um filtro de eventos consiste nos seguintes componentes:
![\[Componentes do filtro de eventos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-event-filters-1.png)
+ **Grupos de filtros**: grupo de filtros que você aplica aos objetos de perfil. É possível adicionar vários grupos de filtros conectados por relações OR.
+ **Filtros**: filtra os objetos de perfil incluídos no cálculo do atributo calculado ao especificar atributos, operadores e valores. Você pode escolher tantos filtros quantos forem necessários para o seu caso de uso.
+ **Atributo**: o atributo do objeto pelo qual deseja filtrar. Você pode selecionar atributos de objetos armazenados no domínio do Customer Profiles ou usar os nomes de campo definidos na definição do tipo de objeto. Para obter mais informações sobre mapeamentos de tipos de objeto, consulte [Detalhes da definição de mapeamento de tipo de objeto no Amazon Connect Customer Profiles](object-type-mapping-definition-details.md).
**nota**
No site do Amazon Connect administrador, a lista suspensa de atributos mostra a data e hora da última vez em que qualquer objeto de perfil foi salvo ou atualizado com o atributo.
Se houver um atributo de um objeto de perfil e um campo de um tipo de objeto com o mesmo nome, o filtro de eventos priorizará o nome do campo de tipo de objeto em sua filtragem. Por exemplo, se um objeto de perfil tiver um atributo chamado **Status** e também houver um campo de tipo de objeto chamado **Status**, o filtro usará o campo de tipo de objeto **Status** para filtragem.
+ **Operador**: o operador determina a relação do atributo com um valor que você insere. Para obter mais informações, consulte [Operadores de filtro](#calculated-attributes-admin-website-event-filter-operators)
+ **Valor**: o valor com o qual deseja filtrar objetos. É possível especificar vários valores conectados por relações OR. Por exemplo, *O status do ativo é Instalado ou Registrado*. Observe que os valores diferenciam letras maiúsculas de minúsculas. Por exemplo, *O status do ativo é Instalado* retorna resultados diferentes de *O status do ativo é instalado*. Para visualizar objetos de perfil, use a [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API Amazon Connect Customer Profiles.
Opcionalmente, você pode criar até dois filtros de eventos e criar uma relação (AND/OR/EXCLUDE) entre eles. Para obter mais detalhes sobre o relacionamento, consulte[Relação entre filtros de eventos](#calculated-attributes-admin-website-relationship-between-event-filters).
## Operadores de filtro
Os operadores determinam a relação do atributo com um valor inserido por você. A tabela a seguir descreve os operadores disponíveis.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/calculated-attributes-admin-website-event-filters.html)
**nota**
Os atributos calculados no site do Amazon Connect administrador usam o fuso horário UTC e um horário padrão de 00:00:00 UTC para todos os filtros baseados em horário. Você pode filtrar por datas, mas as horas são registradas com o mesmo valor. Se você inserir uma data de 1/1/2024, o console enviará a hora como 2024-01-01T00:00:00Z.
**nota**
Por padrão, os filtros de eventos são avaliados quando um objeto de perfil é salvo ou atualizado. Por exemplo, se você filtrar objetos de ativo padrão em que `PurchaseDate` está na última semana, o tempo relativo é calculado como *na semana anterior ao momento em que o objeto de ativo é salvo ou atualizado*. Isso significa que os resultados da filtragem podem variar dependendo de quando o objeto é salvo ou atualizado.
## Relação entre filtros de eventos
Você também pode adicionar o segundo filtro de eventos e definir uma relação com o primeiro filtro de eventos. Ao criar um atributo calculado no site de administração do Amazon Connect , você pode ter até dois filtros de eventos por atributo calculado. Se você adicionar o segundo filtro de eventos ao atributo calculado, poderá escolher uma das duas formas de especificar como os dois filtros de eventos se conectam:
+ **Relação AND**: se você usar a relação AND para conectar os dois filtros de eventos, objetos que atendam ao primeiro e ao segundo filtro de eventos serão incluídos no cálculo.
+ **Relação OR**: se você usar a relação OR para conectar os dois filtros de eventos, objetos que atendam ao primeiro ou ao segundo filtro de eventos serão incluídos no cálculo.
+ **Relação EXCLUDE**: se você usar a relação EXCLUDE para conectar dois filtros de eventos, objetos que atendam ao primeiro filtro de eventos, mas não atendam ao segundo filtro de eventos, serão incluídos no cálculo.
## Próximas etapas
+ [Usar um atributo calculado em sua central de atendimento por meio do editor de fluxo](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-block.html#customer-profiles-block-properties-get-calculated-attributes)
+ [Usar um atributo calculado para definir um segmento de clientes](https://docs.aws.amazon.com/connect/latest/adminguide/segmentation-admin-website)
+ [Exibir atributos calculados no Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-view.html)
+ [Editar atributos calculados no Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-edit.html)
+ [Excluir atributos calculados no Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-delete.html)
# Visualizar atributos calculados no Amazon Connect
1. Faça login no site do Amazon Connect administrador em https://*instance name*.my.connect.aws/. Use uma conta de Administrador ou uma conta atribuída a um perfil de segurança que tenha permissão para **Customer Profiles - Atributos calculados**.
1. No Amazon Connect, no painel de navegação esquerdo, escolha **Customer Profiles** e **Atributos calculados**.
1. Na página **Atributos calculados**, escolha um atributo calculado na coluna **Nome** da tabela.
A imagem a seguir mostra um exemplo de atributos calculados listados na coluna **Nome**.
![\[Uma tabela que lista atributos calculados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-view-1.png)
1. Agora você pode visualizar os detalhes do atributo selecionado. A imagem a seguir mostra uma página de detalhes de um atributo calculado.
![\[Visualização detalhada de um atributo calculado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-view-2.png)
# Editar atributos calculados no Amazon Connect
1. Para editar um atributo calculado, escolha um atributo na exibição de tabela selecionando o botão de opção, que habilita o botão **Editar**. Escolha **Editar**.
![\[editar um atributo calculado\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-1.png)
1. Você poderá editar a **Descrição**, o **Número de eventos** e **Período**. Ao concluir, selecione **Salvar**.
![\[Edite um atributo calculado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-2.png)
# Excluir atributos calculados no Amazon Connect
1. Para excluir um atributo calculado, escolha um atributo na tabela selecionando o botão de opção ao lado do atributo que você gostaria de excluir.
1. Depois de selecionado, escolha **Excluir**.
1. No menu pop-up **Excluir atributo**, verifique os detalhes e insira *confirmar* para habilitar o botão **Excluir**.
![\[Exclua um atributo calculado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-delete-1.png)
1. Escolha **Excluir**.
# Atributos calculados dos perfis de clientes do Amazon Connect APIs
Você pode usar o seguinte atributo calculado de Perfis de Cliente APIs
------
#### [ CreateCalculatedAttributeDefinition ]
**CreateCalculatedAttributeDefinition**
Crie um novo atributo calculado. Isso requer um tipo de objeto existente no domínio. Você pode definir os atributos que deseja extrair de um único objeto de origem e as operações matemáticas a serem aplicadas a eles de forma agregada, bem como o intervalo de tempo e a contagem de objetos.
Após a criação, novos dados de objetos ingeridos no Customer Profiles serão incluídos no atributo calculado, que pode ser recuperado para um perfil usando a API `GetCalculatedAttributeForProfile`. Para usar também dados históricos, especifique `UseHistoricalData` como true. Os campos `Readiness` e `Status` na resposta da API fornecerão informações sobre o status da inclusão de dados históricos no atributo calculado.
A definição de um atributo calculado o disponibiliza para todos os perfis em um domínio. Cada atributo calculado só pode referenciar um ObjectType e no máximo dois campos a partir desse campo ObjectType.
**Solicitação**
```
POST /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"Tags": {}
}
```
**Resposta**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Corpo da solicitação**
+ **CalculatedAttributeName**
O nome exclusivo (por domínio) do atributo calculado.
+ Tipo: String
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
+ **DisplayName**
O nome de exibição do atributo calculado.
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ Obrigatório: não
+ **Descrição**
A descrição do atributo calculado.
+ Tipo: String
+ Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.000.
+ Obrigatório: não
+ **UseHistoricalData**
Indica se os dados históricos ingeridos antes da criação do atributo calculado devem ser incluídos nos cálculos.
+ Tipo: booleano
+ Obrigatório: não
+ **AttributeDetails**
Detalhes dos atributos usados na definição e das operações matemáticas envolvidas entre os atributos. Consulte os seguintes componentes:
+ **Atributos.**
Uma lista de itens de atributos especificados na expressão matemática.
+ **AttributeItem**
Os detalhes de um item de atributo especificado na expressão matemática.
+ Nome
+ O nome de um atributo definido em um tipo de objeto de perfil.
+ Tipo: string
+ **Expressão**
Expressão matemática executada em itens de atributos fornecidos na lista de atributos. Cada elemento na expressão deve seguir a estrutura de\$1 "\$1ObjectTypeName. AttributeName\$1\$1”.
+ Exemplo: `{ObjA.AttributeA} - {ObjA.AttributeB}`
+ Tipo: String
+ Só oferecemos suporte às seguintes operações matemáticas: `+ - * /`
+ Você não poderá fazer modificações na expressão depois que uma definição de atributo calculado for criada
+ **Condições**
Define os critérios e o limite calculados da agregação de atributos.
+ Tipo: objeto Conditions
+ Intervalo
+ ObjectCount
+ Limite
+ **Intervalo**
O período de tempo relativo durante o qual os dados são incluídos na agregação.
+ Tipo: objeto Range
+ Valor: o período das unidades especificadas. `ValueRange` substitui Value.
+ Tipo: inteiro
+ Obrigatório: não
+ ValueRange: uma estrutura que permite que os clientes especifiquem uma janela de tempo relativa durante a qual os dados são incluídos no Atributo Calculado. Use números positivos para indicar que o endpoint está no passado e números negativos para indicar que está no futuro. ValueRangesubstitui o valor.
+ Tipo: ValueRange
+ Obrigatório: não
+ Início
+ A hora de início da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
+ Tipo: inteiro
+ Obrigatório: Sim
+ Fim
+ A hora de término da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
+ Tipo: inteiro
+ Obrigatório: Sim
+ TimestampSource: uma expressão que especifica o campo em seu objeto JSON a partir do qual a data deve ser analisada. A expressão deve seguir a estrutura de\$1 "\$1ObjectTypeName. \$1\$1”. Por exemplo, se seu tipo de objeto é MyType e o JSON de origem é`{"generatedAt": {"timestamp": "1737587945945"}}`, então TimestampSource deveria ser`"{MyType.generatedAt.timestamp}"`.
+ Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.
+ Obrigatório: não
+ TimestampFormat: o formato do campo de carimbo de data/hora em seu objeto JSON é especificado. Esse valor deve ser EPOCHMILLI (para timestamps de época Unix com precisão de nível) ou ISO\$18601 (seguindo o formato ISO\$18601 com precisão de second/millisecond nível, com um deslocamento opcional de Z ou no formato HH:MM ou second/millisecond HHMM.). Por exemplo, se seu tipo de objeto é MyType e o JSON de origem é`{"generatedAt": {"timestamp": "2001-07-04T12:08:56.235-0700"}},`, então TimestampFormat deveria ser`"ISO_8601"`.
+ Unidade: unidade de tempo
+ Valores válidos: dias
+ Obrigatório: Sim
+ Obrigatório: Sim
+ Escopo inicial: máximo de 366 dias
+ **ObjectCount**
O número de objetos de perfil usados para o atributo calculado.
+ Tipo: número
+ Alcance: de 1 a 100
+ Obrigatório: não
+ **Limite**
A lógica de comparação para gerar um atributo true/false calculado.
+ Tipo: objeto Threshold
+ Valor
+ O valor do limite.
+ Tipo: string
+ Obrigatório: não
+ Operador
+ O operador do limite
+ Tipo: ENUM
+ Valores válidos:
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ Obrigatório: não
+ **Estatística**
A operação de agregação a ser executada para o atributo calculado.
+ Tipo: ENUM
+ Valores válidos:
+ FIRST\$1OCCURRENCE
+ LAST\$1OCCURRENCE
+ CONTAGEM
+ SUM
+ MINIMUM
+ MAXIMUM
+ AVERAGE
+ MAX\$1OCCURRENCE
------
#### [ UpdateCalculatedAttributeDefinition ]
**UpdateCalculatedAttributeDefinition**
Atualizar uma definição de atributo calculado. As atualizações estão limitadas ao nome de exibição, descrição, intervalo de tempo, contagem de objetos e limite. Essa API oferece suporte a atualizações parciais, portanto, somente os parâmetros que exigem atualização precisam ser incluídos.
**nota**
Ao atualizar as condições:
Aumentar o intervalo de datas de um atributo calculado não acionará a inclusão de dados históricos maiores que o intervalo de datas atual.
TimestampSource e TimestampFormat não pode ser atualizado após a criação de uma definição de atributo calculado.
**Solicitação**
```
PUT /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"DisplayName": "string",
"Description": "string",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
}
}
```
**Resposta**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Corpo da solicitação**
+ **DisplayName**
O nome de exibição do atributo calculado.
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ Obrigatório: não
+ **Descrição**
A descrição do atributo calculado.
+ Tipo: String
+ Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.000.
+ Obrigatório: não
+ **Condições**
Define os critérios e o limite calculados da agregação de atributos.
+ Tipo: objeto Conditions
+ Intervalo
+ ObjectCount
+ Limite
+ **Intervalo**
O período de tempo relativo durante o qual os dados são incluídos na agregação.
+ Tipo: objeto Range
+ Valor: o período das unidades especificadas
+ Tipo: inteiro
+ Obrigatório: não
+ ValueRange: uma estrutura que permite que os clientes especifiquem uma janela de tempo relativa durante a qual os dados são incluídos no Atributo Calculado. Use números positivos para indicar que o endpoint está no passado e números negativos para indicar que está no futuro. ValueRangesubstitui o valor.
+ Tipo: ValueRange
+ Obrigatório: não
+ Início
+ A hora de início da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
+ Tipo: inteiro
+ Obrigatório: Sim
+ Fim
+ A hora de término da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
+ Tipo: inteiro
+ Obrigatório: Sim
+ Unidade: unidade de tempo
+ Valores válidos: dias
+ Obrigatório: Sim
+ Obrigatório: Sim
+ Escopo inicial: máximo de 366 dias
+ **ObjectCount**
O número de objetos de perfil usados para o atributo calculado.
+ Tipo: número
+ Alcance: de 1 a 100
+ Obrigatório: não
+ **Limite**
A lógica de comparação para gerar um atributo true/false calculado.
+ Tipo: objeto Threshold
+ Valor
+ O valor do limite.
+ Tipo: string
+ Obrigatório: não
+ Operador
+ O operador do limite
+ Tipo: ENUM
+ Valores válidos:
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ Obrigatório: não
------
#### [ GetCalculatedAttributeDefinition ]
**GetCalculatedAttributeDefinition**
Recupere uma definição de atributo calculado.
**Solicitação**
```
GET /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**Corpo da solicitação**
```
The request does not have a request body.
```
**Resposta**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Unit": "string",
"Value": number
"ValueRange"
{
"Start": number
"End": number
},
"TimestampFormat": "string",
"TimestampSource": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"UseHistoricalData" boolean,
"Status": "PREPARING" | "IN_PROGRESS" | "COMPLETED" | "FAILED",
"Readiness": {
"ProgressPercentage": number,
"Message": "string",
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Parâmetros de solicitação de URI**
+ **DomainName**
O nome exclusivo do domínio.
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
+ **CalculatedAttributeName**
O nome exclusivo (por domínio) do atributo calculado.
+ Tipo: String
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
------
#### [ DeleteCalculatedAttributeDefinition ]
**DeleteCalculatedAttributeDefinition**
Exclua uma definição de atributo calculado existente. Observe que é possível excluir um atributo calculado padrão. No entanto, uma vez excluído, você não poderá desfazer essa ação e precisará recriá-la sozinho usando a API `CreateCalculatedAttributeDefinition` se quiser recuperá-la.
**Solicitação**
```
DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**Corpo da solicitação**
```
The request does not have a request body.
```
**Resposta**
```
The response does not have a response body.
```
**Parâmetros de solicitação de URI**
+ **DomainName**
O nome exclusivo do domínio.
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
+ **CalculatedAttributeName**
O nome exclusivo (por domínio) do atributo calculado.
+ Tipo: String
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
------
#### [ ListCalculatedAttributeDefinitions ]
**ListCalculatedAttributeDefinitions**
Recupere todas as definições de atributos calculados para um domínio.
**Solicitação**
```
GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**Corpo da solicitação**
```
The request does not have a request body.
```
**Resposta**
```
{
"Items": [
{
"UseHistoricalData": boolean,
"ReadinessStatus": PREPARING | IN_PROGRESS | COMPLETED | FAILED,
"CalculatedAttributeName": "string",
"CreatedAt": number,
"Description": "string",
"DisplayName": "string",
"LastUpdatedAt": number,
"Tags": {
"string" : "string"
}
}
],
"NextToken": "string"
}
```
**Parâmetros de solicitação de URI**
+ **DomainName**
O nome exclusivo do domínio.
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
+ **MaxResults**
O número máximo de objetos retornados por página.
+ Faixa válida: valor mínimo de 1. Valor máximo de 100
+ **NextToken**
O token de paginação da chamada de ListCalculatedAttributeDefinition API anterior.
+ Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.024
------
#### [ GetCalculatedAttributeForProfile ]
**GetCalculatedAttributeForProfile**
Inicia o cálculo e recupera o resultado de um único atributo calculado para um único perfil.
**Solicitação**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName
```
**Corpo da solicitação**
```
The request does not have a request body.
```
**Resposta**
```
{
"Name": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial": "string",
"LastObjectTimestamp" : number
}
```
**Parâmetros de solicitação de URI**
+ **DomainName**
O nome exclusivo do domínio.
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
+ **CalculatedAttributeName**
O nome exclusivo (por domínio) do atributo calculado.
+ Tipo: String
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
------
#### [ ListCalculatedAttributesForProfile ]
**ListCalculatedAttributesForProfile**
Inicia o cálculo e recupera os resultados de um único atributo calculado para um único perfil.
**Solicitação**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**Corpo da solicitação**
```
The request does not have a request body.
```
**Resposta**
```
{
"Items": [
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial" : "string",
"LastObjectTimestamp" : number
},
...
],
"NextToken": "string"
}
```
**Parâmetros de solicitação de URI**
+ **DomainName**
O nome exclusivo do domínio.
+ Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
+ Padrão: `^[a-zA-Z0-9_-]+$`
+ Obrigatório: Sim
+ **ProfileId**
+ Padrão: `[a-f0-9]{32}`
+ Obrigatório: Sim
+ **MaxResults**
O número máximo de objetos retornados por página.
+ Faixa válida: valor mínimo de 1. Valor máximo de 100
+ **NextToken**
O token de paginação da chamada de ListCalculatedAttributeDefinition API anterior.
+ Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.024
------
# Criar uma definição personalizada de atributo calculado do Amazon Connect Customer Profiles
Usando a [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API Customer Profiles, você pode criar programaticamente seu próprio atributo calculado com base em um tipo de objeto personalizado.
Neste tópico, mostramos como criar um atributo calculado usando um arquivo JSON personalizado.
## Etapa 1: Criar um arquivo JSON
Crie um arquivo JSON com o seguinte conteúdo:
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"UseHistoricalData": true,
"DisplayName": "your-display-name",
"Description": "your-description",
"AttributeDetails": {
"Attributes": [
{
"Name": "your-attribute-name"
}
],
"Expression": "{your-object-type.your-attribute-name}"
},
"Statistic": "your-statistic",
"Conditions": {
"Range": {
"ValueRange"
{
"Start": your-range-start
"End": your-range-end
},
"TimestampSource": "{your-object-type.your-timestamp-source}",
"Unit": "days"
},
"ObjectCount": your-object-count,
"Threshold": {
"Value": "your-threshold-value",
"Operator": "your-threshold-operator"
}
}
}
```
Para personalizar o JSON com seus próprios valores, siga estas diretrizes:
+ **Atributos**: deve conter o nome do campo do seu tipo de objeto que você deseja usar para o atributo calculado. Há suporte para dois atributos referenciados nesta lista.
+ **Expressão**: expressões matemáticas básicas para execução entre atributos são compatíveis. Se você tiver apenas um atributo, esse campo deverá ser `{ObjectTypeName.AttributeName}`; caso contrário, se você tiver uma expressão matemática em mente, esse campo deverá conter os dois atributos.
+ **Estatística**: Essa é a operação executada quando você chama um dos cálculos APIs que realmente executa a operação de agregação. A maioria é autoexplicativa, mas adicionamos explicações para outras que não são.
**Estatísticas compatíveis**
+ `FIRST_OCCURRENCE` retorna o atributo especificado na expressão do primeiro objeto ingerido.
+ `LAST_OCCURRENCE` retorna o atributo especificado na expressão do último objeto ingerido.
+ `COUNT` retorna a contagem dos dados selecionados.
+ `SUM` retorna a soma dos dados selecionados.
+ `MINIMUM` retorna o mínimo dos dados selecionados.
+ `MAXIMUM` retorna o máximo dos dados selecionados.
+ `AVERAGE` retorna a média dos dados selecionados.
+ `MAX_OCCURRENCE` retorna o valor mais frequente especificado na expressão.
+ **Alcance**:
+ Units: no momento, só é compatível com DAYS.
+ ValueRange: especifique números positivos nos campos Início ou Fim para indicar de quantos dias começar e números negativos para indicar de quantos dias no futuro começar. ValueRange
+ TimestampSource: uma expressão que especifica o campo em seu objeto JSON a partir do qual a data deve ser analisada. A expressão deve seguir a estrutura de\$1 "\$1ObjectTypeName. \$1\$1”. Por exemplo; se seu tipo de objeto é MyType e o JSON de origem é`{"generatedAt": {"timestamp": "1737587945945"}}`, então TimestampSource deveria ser`"{MyType.generatedAt.timestamp}"`.
+ **ObjectCount**: indica em quantos objetos o cálculo do atributo calculado deve se basear.
+ **Threshold**: se, em vez do valor exato do atributo calculado, você quiser saber se ele é, por exemplo, maior que um determinado valor, você poderá usar um limite.
O valor limite pode ser qualquer string, e os seguintes operadores de limite são compatíveis.
+ `GREATER_THAN`
+ `LESS_THAN`
+ `EQUAL_TO`
+ `NOT_EQUAL_TO`
+ UseHistoricalData: se os dados históricos ingeridos antes da criação do Atributo Calculado devem ser incluídos nos cálculos.
## Etapa 2: chame a CreateCalculatedAttributeDefinition API
Depois de criar e personalizar o arquivo JSON com seus valores, chame a [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API, conforme mostrado no exemplo a seguir:
```
aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name
```
Você também pode usar o seguinte endpoint:
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes
```
# Valide valores de atributos calculados nos perfis de clientes do Amazon Connect usando APIs
Existem dois APIs, `GetCalculatedAttributeForProfile` e`ListCalculatedAttributesForProfile`, que estão no nível do perfil.
+ **GetCalculatedAttributeForProfile**- recupera um único atributo calculado para um único perfil.
+ **ListCalculatedAttributesForProfile**- recupera uma lista de atributos calculados para um único perfil
Com um ID de perfil válido, você deve ver valores para seus atributos calculados:
**Exemplo de resposta**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"IsDataPartial": "true",
"Value": "24144"
}
```
**IsDataPartial**- Esse sinalizador significa que o intervalo de tempo (30 dias) ou a contagem de objetos não foram atingidos e, portanto, o atributo calculado ainda está sendo calculado. Por exemplo, se você quiser uma média de mais de 30 dias, somente depois de decorridos 30 dias o campo `IsDataPartial` será definido como falso.
## Recuperar uma lista de atributos calculados
**Use a AWS CLI**
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --profile-id your-profile-id
```
**Use a AWS CLI com um arquivo JSON personalizado**
Crie um arquivo JSON com o seguinte conteúdo:
```
{
"DomainName": "your-domain-name",
"ProfileId" "some-profile-id"
}
```
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**Endpoint:**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/
```
## Recuperar um único atributo calculado
**Use a AWS CLI**:
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --calculated-attribute-name your-calculated-attribute-name --profile-id your-profile-id
```
**Use a AWS CLI com um arquivo JSON personalizado:**
Crie um arquivo JSON com o seguinte conteúdo:
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"ProfileId" "your-profile-id"
}
```
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**Endpoint:**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/your-calculated-attribute-name
```
# Atributos calculados padrão no Amazon Connect Customer Profiles
## Atributos calculados de CTR padrão
Amazon Connect Os perfis de clientes fornecem atributos padrão de out-of-the caixa com base nos registros de contato. Os atributos são os seguintes:
**Canal mais frequente**
```
{
"CalculatedAttributeName": "_most_frequent_channel",
"DisplayName": "Most frequent channel",
"Description": "Returns customer's frequently used communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**Canal mais recente**
```
{
"CalculatedAttributeName": "_last_channel",
"DisplayName": "Last channel",
"Description": "Returns customer's last communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**Identificador do último atendente**
```
{
"CalculatedAttributeName": "_last_agent_id",
"DisplayName": "Last agent identifier",
"Description": "Returns identifier of the last agent customer connected with.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.id"
}
],
"Expression": "{CTR.agent.id}"
},
"Tags": {
}
}
```
**Chamador frequente**
```
{
"CalculatedAttributeName": "_frequent_caller",
"DisplayName": "Frequent caller",
"Description": "Returns true or false based on the number of times a customer has called.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "COUNT",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": {
"Value": "5",
"Operator": "GREATER_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "contactId"
}
],
"Expression": "{CTR.contactId}"
},
"Tags": {
}
}
```
**Tempo médio de espera**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"Description": "Returns customer's average hold time for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Tags": {
}
}
```
**Duração média da chamada**
```
{
"CalculatedAttributeName": "_average_call_duration",
"DisplayName": "Average call duration",
"Description": "Returns customer's average call duration for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "disconnectTimestamp"
},
{
"Name": "initiationTimestamp"
}
],
"Expression": "{CTR.disconnectTimestamp} - {CTR.initiationTimestamp}"
},
"Tags": {
}
}
```
**Tempo máximo de espera do cliente**
```
{
"CalculatedAttributeName": "_maximum_hold_time",
"DisplayName": "Customer's maximum hold time",
"Description": "Returns customer's maximum hold time for voice calls in the past month.",
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Statistic": "MAXIMUM",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## Atributo calculado de perfil padrão
Amazon Connect Perfis de clientes fornecem um atributo padrão de out-of-the caixa com base em um perfil. Os atributos são os seguintes:
**Novo cliente**
```
{
"CalculatedAttributeName": "_new_customer",
"DisplayName": "New customer",
"Description": "Returns true or false for new customer profiles created.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "TIME_DIFFERENCE_FROM_NOW",
"Conditions": {
"ObjectCount": null,
"Threshold": {
"Value": "30",
"Operator": "LESS_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "createdAt"
}
],
"Expression": "{_profile.createdAt}"
},
"Tags": {
}
}
```
## Atributos calculados de ativos padrão
Amazon Connect O Customer Profiles fornece atributos padrão de out-of-the caixa com base nos ativos. Os atributos são os seguintes:
**Contagem de ativos**
```
{
"CalculatedAttributeName": "_assets_count",
"DisplayName": "Count of assets",
"Description": "Returns the count of assets for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetId"
}
],
"Expression": "{_asset.AssetId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Data da primeira compra de ativo**
```
{
"CalculatedAttributeName": "_asset_first_occurrence",
"DisplayName": "First asset purchased date",
"Description": "Returns purchase date of the customer's first asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Data da última compra de ativo**
```
{
"CalculatedAttributeName": "_asset_last_occurrence",
"DisplayName": "Last asset purchased date",
"Description": "Returns purchase date of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Preço total dos ativos**
```
{
"CalculatedAttributeName": "_assets_price_sum",
"DisplayName": "Total asset price",
"Description": "Returns customer's total asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "SUM",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Preço médio dos ativos**
```
{
"CalculatedAttributeName": "_assets_price_average",
"DisplayName": "Average asset price",
"Description": "Returns customer's average asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Nome do primeiro ativo**
```
{
"CalculatedAttributeName": "_assets_name_first_occurrence",
"DisplayName": "First asset name",
"Description": "Returns name of the customer's first asset",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Nome do último ativo**
```
{
"CalculatedAttributeName": "_assets_name_last_occurrence",
"DisplayName": "Last asset name",
"Description": "Returns name of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## Atributos calculados de chamados padrão
Amazon Connect O Customer Profiles fornece atributos padrão de out-of-the caixa com base nos casos. Os atributos são os seguintes:
**Contagem de chamados**
```
{
"CalculatedAttributeName": "_cases_count",
"DisplayName": "Count of cases",
"Description": "Returns the count of customer's cases for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Data de criação do primeiro chamado**
```
{
"CalculatedAttributeName": "_case_first_occurrence",
"DisplayName": "First case created date",
"Description": "Returns created date of the customer's first case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Data de criação do último chamado**
```
{
"CalculatedAttributeName": "_case_last_occurrence",
"DisplayName": "Last case created date",
"Description": "Returns created date of the customer's last case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Contagem de chamados abertos**
```
{
"CalculatedAttributeName": "_cases_open_status_count",
"DisplayName": "Count of open cases",
"Description": "Returns the count of customer's open cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Contagem de chamados encerrados**
```
{
"CalculatedAttributeName": "_cases_closed_status_count",
"DisplayName": "Count of closed cases",
"Description": "Returns the count of customer's closed cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Closed"]
}
}
}
]
}
]
},
"Launched": false
}
```
## Atributos calculados de registros de comunicação padrão
Amazon Connect Os perfis de clientes fornecem atributos padrão de out-of-the caixa com base nos registros de comunicação. Os atributos são os seguintes:
**Data de abertura do último e-mail**
```
{
"CalculatedAttributeName": "_campaign_email_last_open",
"DisplayName": "Last email open date",
"Description": "Returns the last email open date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.Open.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.Open.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Contagem de e-mails abertos**
```
{
"CalculatedAttributeName": "_campaign_email_open_count",
"DisplayName": "Email open count",
"Description": "Returns the number of times emails were opened by a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Contagem de e-mails entregues**
```
{
"CalculatedAttributeName": "_campaign_email_delivery_count",
"DisplayName": "Email delivery count",
"Description": "Returns the number of times emails were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Delivery.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Delivery"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Contagem de SMS enviados**
```
{
"CalculatedAttributeName": "_campaign_sms_delivery_count",
"DisplayName": "SMS delivered count",
"Description": "Returns the number of times SMS were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_DELIVERED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_DELIVERED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Data do último SMS bloqueado**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop",
"DisplayName": "Last SMS blocked date",
"Description": "Returns the last SMS blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Data do último SMS bloqueado pela operadora**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop_carrier",
"DisplayName": "Last SMS carrier blocked date",
"Description": "Returns the last SMS carrier blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_CARRIER_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_CARRIER_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_CARRIER_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_CARRIER_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
## Atributos calculados de pedidos padrão
Amazon Connect O Customer Profiles fornece atributos padrão de out-of-the caixa com base nos pedidos. Os atributos são os seguintes:
**Contagem de pedidos**
```
{
"CalculatedAttributeName": "_orders_count",
"DisplayName": "Count of orders",
"Description": "Returns the count of orders for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "OrderId"
}
],
"Expression": "{_order.OrderId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Data de criação do primeiro pedido**
```
{
"CalculatedAttributeName": "_order_first_occurrence",
"DisplayName": "First order created date",
"Description": "Returns created date of the customer's first order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Data de criação do último pedido**
```
{
"CalculatedAttributeName": "_order_last_occurrence",
"DisplayName": "Last order created date",
"Description": "Returns created date of the customer's last order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Preço total de todos os pedidos**
```
{
"CalculatedAttributeName": "_orders_total_price_sum",
"DisplayName": "Total price of all orders",
"Description": "Returns sum of total price for all customer's orders.",
"Statistic": "SUM",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Média de preço entre todos os pedidos**
```
{
"CalculatedAttributeName": "_orders_total_price_average",
"DisplayName": "Orders average of total price",
"Description": "Returns average of total price for all customer's orders.",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
# Mensagens de erro e resoluções para atributos calculados do Amazon Connect Customer Profiles
A tabela a seguir mostra as mensagens de erro, a causa e a resolução dos atributos calculados para cada erro.
| Mensagem de erro | Causa | Resolução |
| --- | --- | --- |
| A recuperação de um atributo calculado para um perfil mostra um valor nulo | Isso provavelmente se deve ao fato de o atributo calculado não ter dados. Após a criação de um atributo calculado, novos dados deverão ser ingeridos. | Ingira novos dados ou reingira dados antigos por meio de integrações ou e. CreateProfile PutProfileObject APIs |
# Configurar segmentos de clientes no Amazon Connect Customer Profiles
Um *segmento de clientes* é um grupo de perfis de clientes que compartilham determinados atributos. Por exemplo, um segmento de clientes pode conter todos os seus clientes que moram em uma cidade específica ou todos os clientes que ligam frequentemente e cujo gasto médio é superior a USD 500. Com Amazon Connect as campanhas externas, você pode enviar campanhas para um segmento de clientes.
Os segmentos de clientes são avaliados dinamicamente com base nos atributos que você define e podem mudar com o tempo quando o valor dos atributos muda. Por exemplo, se você adicionar novos perfis ao domínio do Customer Profiles ou se modificar ou excluir perfis existentes, o número de perfis no segmento de clientes poderá aumentar ou diminuir. Para ter mais informações sobre como criar um segmento de clientes, consulte [Criar segmentos de clientes no Amazon Connect](customer-segments-building-segments.md).
Como pré-requisito para criar segmentos Amazon Connect, seu administrador deve configurar seu domínio no AWS Management Console e configurar integrações para trazer dados de perfil, pedido, ativo e and/or caso para os perfis de clientes. Para obter mais informações, consulte [Habilitar o Customer Profiles para a instância do Amazon Connect](enable-customer-profiles.md). Habilitar as integrações de dados permitirá que você continue gerando segmentos dinâmicos com base nos novos dados que chegam ao domínio.
Segmentos de clientes contêm somente perfis de clientes no domínio do Amazon Connect Customer Profiles. Os perfis de clientes podem ser ingeridos do S3 ou de aplicações externas, ou criados por meio da aplicação de atendente, fluxos de contato ou API. Para obter mais informações sobre os perfis de clientes, consulte [O que é um perfil de cliente no Amazon Connect?](customer-profiles-what-data.md).
**Topics**
+ [Criar segmentos de clientes](customer-segments-building-segments.md)
+ [Gerenciar segmentos](customer-segments-managing-segments.md)
+ [Criar segmentos com base em arquivos importados](customer-segments-imported-files.md)
+ [Exportar segmentos para um arquivo CSV](customer-segments-exporting-segments.md)
+ [Usar o assistente de IA para segmentos](customer-segments-ai-assistant.md)
+ [Solução de problemas](customer-segments-troubleshooting.md)
# Criar segmentos de clientes no Amazon Connect
**nota**
**A segmentação baseada em SQL (Beta) exige que o armazenamento de dados esteja ativado. Visite a tela inicial dos Perfis do Cliente e ative o Armazenamento de dados no banner azul superior**
**nota**
Para navegar até a experiência do criador de segmentação no site do Amazon Connect administrador, você precisa de permissões de perfis de segurança para esse recurso. Para obter mais informações, consulte [Atribuir permissões do perfil de segurança para gerenciar segmentos de clientes](security-profile-customer-profile-segmentation.md).
Antes de criar segmentos, recomendamos que seu domínio do Customer Profiles configure integrações de dados para preencher perfis no domínio do Customer Profiles. Para obter mais informações sobre como configurar integrações de dados com o Customer Profiles, consulte [Integrar aplicações externas ao Amazon Connect Customer Profiles](integrate-external-apps-customer-profiles.md).
Os segmentos podem incluir eventos que você capturou usando atributos calculados. Para obter mais informações sobre como configurar atributos calculados personalizados e conferir as ofertas de atributos calculados padrão do Customer Profiles, consulte [Configurar atributos calculados no Amazon Connect Customer Profiles](customerprofiles-calculated-attributes.md).
O Amazon Connect fornece duas maneiras de criar segmentos de clientes: 1/ Definir segmentos por meio do Spark SQL (beta; requer que o armazenamento de dados esteja ativado); 2/ Definir segmentos por meio de grupos de público e filtros (segmentação clássica). Para ambos, você pode usar instruções em linguagem natural por meio do assistente de IA de segmento com inteligência artificial generativa. Se você definir segmentos de uma das formas, moverá esse segmento para a outra e terá que começar de novo.
## Segmentos desenvolvidos pelo Spark SQL
Os segmentos desenvolvidos pelo Spark SQL permitem que você use dados completos do Perfil do Cliente e funcionalidades expandidas para definir segmentos. Você pode usar atributos de objeto de perfil padrão e atributos de objetos personalizados. Você também pode usar funcionalidades baseadas em SQL, como unir objetos padrão e personalizados para usar dados de vários objetos, filtrar segmentos com estatísticas como percentis e padronizar campos de data para fazer comparações.
Você pode começar inserindo um prompt em linguagem natural no Segment Assistant AI. O assistente de IA do segmento definirá o segmento, incluindo sua tradução para o Spark SQL. A IA do Assistente de Segmento fornecerá as etapas necessárias para definir o segmento e você poderá validar se ele corresponde ao que você pretendia criar. Você também pode visualizar o SQL, as etapas do SQL em linguagem natural e um resumo do Spark SQL gerado pela IA para ajudar ainda mais na validação. Se quiser fazer alterações, você pode atualizar seu prompt de linguagem natural ou fazer edições diretamente no Spark SQL.
Você também tem a opção de criar o segmento Spark SQL diretamente.
**Assim como a segmentação clássica, os segmentos desenvolvidos pelo Spark SQL podem ser usados em chamadas de associação de segmentos, blocos de fluxo e campanhas externas.**
**Quando você usa um segmento do Spark SQL em uma chamada de associação de segmento, bloco de fluxo ou campanha externa iniciada por um evento do cliente, ele usa o último segmento exportado (instantâneo do segmento). O instantâneo do segmento usado para associação expira 1 ano após a criação. Se você receber um erro 4XX, certifique-se de ter exportado o segmento (instantâneo do segmento).**
**As campanhas externas iniciadas por um segmento de clientes não exigem que você exporte o segmento (resumo do segmento).**
### Etapa 1: criar um segmento
No assistente de IA do segmento, selecione “Como criar um segmento” para obter mais orientações sobre a criação de segmentos valiosos ou “Quero gerar um segmento” para inserir uma solicitação em linguagem natural para criar o segmento.
Como alternativa, use SQL para definir um novo segmento no editor de consultas.
**Observação: se você quiser criar uma campanha de saída baseada em fuso horário, você deve garantir que o atributo de fuso horário faça parte da saída do segmento**
**Observação: se você quiser usar o segmento em campanhas externas, você deve garantir que o perfil IDs na saída do segmento seja exclusivo**
### Etapa 2: especificar um nome e uma descrição
Em Nome, digite um nome para o segmento de clientes que facilite seu reconhecimento posteriormente.
**Observação:** o site de administração do Amazon Connect usa o nome inserido como o `DisplayName` do segmento e gera um identificador com base nele. O identificador gerado é usado `SegmentDefinitionName` quando você acessa o segmento usando Perfis de clientes APIs.
Em Descrição, insira uma descrição opcional para o segmento de clientes.
### Etapa 3: revisar e validar o segmento
Analise os dados usados pelo assistente de IA do Segmento e as etapas do modelo de IA para gerar seu segmento. Você também pode revisar o SQL que ele criou para definir o segmento no editor de consultas. Se não conseguiu criar o segmento, aborde o feedback fornecido para ajudá-lo a criar um segmento preciso. Depois de gerar um segmento, o Customer Profiles criará automaticamente uma estimativa do segmento para você.
Se quiser fazer edições, você pode fornecer uma nova solicitação clicando em “Nova conversa” ou em create/edit SQL no editor de consultas.
Se você não estiver usando o assistente do Segment AI, poderá validar a consulta e criar a estimativa clicando no botão “Validar e estimar a consulta” abaixo do editor de consultas.
**Observação: os segmentos desenvolvidos pelo Spark SQL levarão tempo, dependendo da quantidade de dados de perfil que você usa no segmento e do SQL usado, da mesma forma que outros mecanismos de consulta (por exemplo, várias junções entre objetos levam tempo).**
### Etapa 4: criar segmento
Depois de criar um segmento e ficar satisfeito, selecione o botão “Criar segmento” no canto superior direito. Depois de criar o segmento, você pode selecionar Ações - exportando para .csv, usando o segmento em Flows e usando o segmento em Outbound Campaigns.
**Observação: se você usar o segmento em campanhas externas ou blocos de fluxo, ele verificará a associação do segmento com base em quando o segmento foi criado pela última vez. Se você precisar de verificações de associação de segmentos em tempo real enquanto o Flow ou a campanha estão sendo executados, use a segmentação clássica.**
## Segmentação clássica com grupos de público e filtros
Ao criar um segmento de clientes, você escolhe públicos iniciais e refina esses públicos escolhendo os filtros que definem o segmento. Por exemplo, você pode criar um grupo de público, depois escolher um filtro de todos os clientes que moram em um país específico e que ligam com frequência. Os segmentos são recalculados sob demanda, como durante a execução da campanha, execução do fluxo de contatos e estimativa ou exportação do segmento. Como resultado, o tamanho e a associação de cada segmento muda com o passar do tempo.
Além disso, você pode criar um segundo grupo de público, depois criar uma relação (AND, OR ou EXCLUDE) entre os dois grupos para restringir, concatenar ou excluir ainda mais os clientes do primeiro grupo de público.
![\[Dois grupos de público.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-building-segments-1.png)
## Grupos de público
Ao criar um segmento de clientes, você cria um ou mais grupos de público. Um grupo de público consiste nos seguintes componentes:
![\[Um diagrama conceitual que mostra os componentes dos grupos de público.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-audience-groups-1.png)
+ **Públicos iniciais**: os segmentos de clientes que definem a população inicial de usuários. É possível especificar até 5 públicos iniciais ou todos os perfis em seu domínio do Customer Profiles.
+ **Grupos de filtros**: categorias de informações de público que você aplica além dos públicos iniciais. É possível adicionar vários grupos de filtros conectados por relações OR.
+ **Filtros**: os filtros reduzem o número de públicos pertencentes ao segmento. Você pode adicionar quantos filtros quiser para adaptar o segmento às suas necessidades.
Um segmento de clientes precisa ter pelo menos um grupo de público, mas você pode, opcionalmente, criar um segundo grupo de público e, em seguida, criar um relacionamento (AND/OR/EXCLUDE) entre os dois grupos de público. Consulte [Etapa 5: adicionar o segundo grupo de público (opcional)](#step-5-add-the-second-audience-group-optional) para obter mais detalhes sobre a relação.
## Criar um segmento de clientes
As etapas a seguir descrevem a criação e a configuração de um segmento de clientes:
+ Etapa 1: criar um segmento
+ Etapa 2: configurar o nome e a descrição
+ Etapa 3: escolher o público inicial a ser incluído no grupo de público 1
+ Etapa 4: escolher e configurar os grupos de filtros (opcional)
+ Etapa 5: adicionar o grupo de público 2 (opcional)
### Etapa 1: criar um segmento
1. Para criar um segmento, verifique se você criou as permissões de perfis de segurança como pré-requisito. Para obter mais informações, consulte [Atribuir permissões do perfil de segurança para gerenciar segmentos de clientes](security-profile-customer-profile-segmentation.md). Além disso, para melhor visualizar a associação do seu segmento, recomendamos a ingestão de dados antes da criação do segmento. Para fazer a ingestão de perfis por meio do S3 ou de aplicações externas, consulte [Criar e ingerir dados de clientes no Customer Profiles](customer-profiles-object-type-mappings.md) ou [Integrar aplicações externas ao Amazon Connect Customer Profiles](integrate-external-apps-customer-profiles.md).
1. Escolha **Criar um segmento** na visualização de tabela Segmento de clientes.
![\[O botão Criar um segmento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-1-build-a-new-segment-1.png)
### Etapa 2: especificar um nome e uma descrição
+ Em **Nome**, digite um nome para o segmento de clientes que facilite seu reconhecimento posteriormente.
**nota**
O site Amazon Connect administrativo usa o nome inserido como o `DisplayName` do segmento e gera um identificador com base nele. O identificador gerado é usado `SegmentDefinitionName` quando você acessa o segmento usando Perfis de clientes APIs.
+ Em **Descrição**, insira uma descrição opcional para o segmento de clientes.
![\[Uma seção de nome do segmento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-2-configure-specify-name-and-description-1.png)
### Etapa 3: escolher o público inicial a ser incluído no grupo de público 1
Primeiro, você escolherá como deseja definir o público inicial para o grupo de público.
1. Em **Grupo de público 1**, na lista suspensa **Público inicial**, selecione um ou mais segmentos para incluir no grupo de público ou escolha **Todos os perfis de Perfis de Clientes**.
**nota**
Quando você escolhe vários segmentos como público inicial, os segmentos são conectados por relações `OR`. Por exemplo, se você escolher os segmentos **Clientes com assinatura premium** e **Clientes com assinatura básica** como público inicial, todos os perfis que estiverem em qualquer um dos segmentos serão incluídos.
![\[Uma lista suspensa de público inicial.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1.png)
1. Para criar um segmento com ProfileType, comece usando **Todas as contas dos perfis de clientes** como seu público inicial. Essa abordagem permite filtrar perfis baseados em contas de forma eficaz. É importante observar que, a menos que você especifique o contrário, o processo de segmentação exportará automaticamente todos os perfis dentro do domínio de perfis de clientes. Esse comportamento padrão garante uma cobertura abrangente, mas pode ser ajustado para atender às necessidades específicas de segmentação.
Veja a seguir um exemplo de como uma definição do segmento pode ser criada (com base em perfis de contas ou perfis padrão):
**Filtra todos os perfis baseados em contas (=ACCOUNT\$1PROFILE) ProfileType**
![\[Filtra todos os perfis baseados em contas (ProfileType=ACCOUNT_PROFILE).\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-5.png)
**nota**
Para criar um segmento somente com subperfis, crie um público que exclua os perfis baseados em contas. Por exemplo, perfis em que `ProfileType` é PROFILE ou `ProfileType` está vazio.
![\[Para criar um segmento somente com subperfis, crie um público que exclua os perfis baseados em contas.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-6.png)
**Exemplo de campanha que segmenta contas a serem acessadas usando `Phone`**
![\[Exemplo de campanha que segmenta contas a serem acessadas usando Phone\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-7.png)
Neste exemplo, a campanha segmenta uma única conta com a seguinte sequência de chamadas:
1. Primeiro, tenta entrar em contato com John (ID: 2).
1. Se John não atender, liga para Sally (ID: 3) como contato alternativo.
1. Depois de escolher um público inicial, a seção **Público estimado** é atualizada para exibir os perfis elegíveis. Depois de editar os grupos de público, você pode clicar no botão **Atualizar** na seção Público estimado para buscar novamente a estimativa.
![\[Uma seção de público estimado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-2.png)
### Etapa 4: escolher e aplicar filtros de público (opcional)
Depois de escolher o público inicial, você pode refinar ainda mais o público aplicando lógica condicional aos atributos. Os segmentos oferecem suporte a atributos de perfil padrão, atributos de perfil personalizado e atributos calculados.
![\[Filtros de público.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-1.png)
**Como escolher e configurar os filtros de público**
1. Em **Atributo**, você pode escolher um atributo entre os seguintes tipos:
1. **Atributos calculados**: filtra o público com base em um dos atributos calculados.
Consulte [Configurar atributos calculados no Amazon Connect Customer Profiles](customerprofiles-calculated-attributes.md) para saber mais sobre os atributos calculados padrão e como configurar atributos calculados personalizados.
1. **Atributos padrão**: filtra o público com base em um dos atributos de perfil padrão.
Consulte [Definição de perfil padrão no Amazon Connect Customer Profiles](standard-profile-definition.md) para obter a lista de atributos de perfil padrão.
1. **Atributos personalizados**: filtra o público com base em um dos atributos de perfil personalizado.
**nota**
Armazenamos até 1.000 dos atributos de perfil mais recentes no domínio. Se o domínio contiver uma grande quantidade de atributos, os atributos mais antigos poderão não ser exibidos nessa lista.
1. Escolha o **Operador**. Os operadores determinam a relação do atributo com um valor inserido por você. O texto a seguir descreve os operadores disponíveis. Os operadores disponíveis são alterados com base no tipo de valor do atributo selecionado.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/customer-segments-building-segments.html)
**nota**
Os segmentos de clientes no site Amazon Connect administrativo usam o fuso horário UTC e um horário padrão de 00:00:00 UTC para todos os filtros baseados em horário. Você pode filtrar por datas, mas as horas são registradas com o mesmo valor. Se você inserir uma data de 1/1/2024, o console enviará a hora como 2024-01-01T00:00:00Z.
**nota**
Ao especificar um filtro para um atributo calculado, você pode substituir o período da definição do atributo calculado. Por exemplo, o filtro `Frequent caller is true for the event time period of 60 days` substituirá os [Atributos calculados padrão no Amazon Connect Customer Profiles](customerprofiles-default-calculated-attributes.md) de *chamador frequente* para avaliar o valor nos últimos 60 dias, em vez do [período configurado na definição do atributo calculado](customerprofiles-calculated-attributes-apis.md). Essa substituição é específica para o segmento e não afeta a definição do atributo calculado em si.
![\[Atributo, operador e valor a ser avaliado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-2.png)
1. Especifique o Valor. É possível especificar vários valores conectados por relações `OR`. Por exemplo, `Address.Country` é `USA` ou `Mexico`. A entrada de valor mostra sugestões na lista suspensa para operadores de string com base nos perfis de clientes armazenados no domínio.
**nota**
Os valores diferenciam maiúsculas de minúsculas. Por exemplo, *Address.Country é EUA* retorna resultados diferentes de *Address.Country é eua*.
1. (Opcional) Para aplicar atributos adicionais a esse grupo de filtros, escolha **\$1 Filtro**. Para criar outro grupo de filtros, escolha **\$1 Grupo**.
**nota**
Quando você tem vários filtros em um grupo de filtros, os filtros são conectados por relações AND. Por exemplo, para um grupo com dois filtros, “*Address.Country* é EUA” e “*Tempo médio de espera do cliente* é maior que 10 segundos”, os perfis cujo *Address.Country* for EUA **e** o *tempo médio de espera* for superior a 10 segundos pertencerão ao segmento.
Quando você tem vários grupos de filtros em um grupo de público, os segmentos de clientes no site Amazon Connect administrativo usam relacionamentos OR para se conectar entre os grupos de filtros.
![\[Dois filtros de público.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-3.png)
1. Quando terminar de configurar o grupo de público, selecione **Criar segmento**.
### Etapa 5: adicionar o segundo grupo de público (opcional)
Também é possível adicionar o segundo grupo de público e definir uma relação com o grupo de público 1. Ao criar um segmento de clientes usando o site de administração do Amazon Connect , você pode ter até dois grupos de público por segmento. Se você adicionar um segundo grupo de público ao segmento, poderá escolher a forma como os dois grupos de público se conectam:
+ **Relação AND**: se você usar a relação AND para conectar dois públicos, seu segmento conterá todos os perfis que atendam aos filtros do grupo de público 1 e do grupo de público 2.
+ **Relação OR**: se você usar a relação OR para conectar dois públicos, seu segmento conterá todos os perfis que atendam aos filtros do grupo de público 1 ou do grupo de público 2.
+ **Relação EXCLUDE**: se você usar a relação EXCLUDE para conectar dois públicos, o segmento conterá os perfis do grupo de público 1, excluindo os perfis do grupo de público 2.
**Como configurar o segundo grupo de público**
1. Escolha a relação **AND**, **OR** ou **EXCLUDE** depois de configurar o Grupo de público 1.
![\[As opções AND, OR ou EXCLUDE.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-1.png)
1. Escolha o público inicial do Grupo de público 2. Para referência, consulte[Etapa 3: escolher o público inicial a ser incluído no grupo de público 1](#step-3-choose-the-starting-audiences-to-include-in-audience-group).
1. (Opcional) Escolha os filtros pelos quais deseja restringir os segmentos. Para referência, consulte [Etapa 4: escolher e aplicar filtros de público (opcional)](#step-4-choose-and-apply-audience-filters-optional)
1. Quando você concluir a configuração do segmento, escolha **Criar segmento**. O segmento foi criado e agora você pode usá-lo em fluxos ou campanhas externas.
![\[Uma mensagem informando que o segmento foi criado com sucesso.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-2.png)
## Criação de segmentos com tecnologia Spark SQL
Os segmentos desenvolvidos pelo Spark SQL permitem que você use dados completos do Perfil do Cliente e funcionalidades expandidas para definir segmentos. Você pode usar atributos de objeto de perfil padrão e atributos de objetos personalizados. Você também pode usar funcionalidades baseadas em SQL, como unir objetos padrão e personalizados para usar dados de vários objetos, filtrar segmentos com estatísticas como percentis e padronizar campos de data para fazer comparações.
Você pode começar inserindo um prompt em linguagem natural no Segment Assistant AI. O assistente de IA do segmento definirá o segmento, incluindo sua tradução para o Spark SQL. A IA do Assistente de Segmento fornecerá as etapas necessárias para definir o segmento e você poderá validar se ele corresponde ao que você pretendia criar. Você também pode visualizar o SQL, as etapas do SQL em linguagem natural e um resumo do Spark SQL gerado pela IA para ajudar ainda mais na validação. Se quiser fazer alterações, você pode atualizar seu prompt de linguagem natural ou fazer edições diretamente no Spark SQL.
Você também tem a opção de criar o segmento Spark SQL diretamente.
Segmentos desenvolvidos pelo Spark SQL podem ser usados em chamadas de associação de segmentos, blocos de fluxo e campanhas externas. Eles verificam o segmento na última vez em que o segmento foi criado (instantâneo do segmento). Se você receber um erro 4XX, deverá executar o instantâneo do segmento.
**nota**
**A segmentação SQL é executada no armazenamento de dados que tem dados de até 10 anos. A segmentação clássica usa os dados mais recentes (dados atualizados nos últimos 3 anos)**
### Etapa 1: criar um segmento
No assistente de IA do segmento, selecione “Como criar um segmento” para obter mais orientações sobre a criação de segmentos valiosos ou “Quero gerar um segmento” para inserir uma solicitação em linguagem natural para criar o segmento.
Como alternativa, use SQL para definir um novo segmento no editor de consultas.
### Etapa 2: especificar um nome e uma descrição
Em Nome, digite um nome para o segmento de clientes que facilite seu reconhecimento posteriormente.
**nota**
O site de administração do Amazon Connect usa o nome inserido como o `DisplayName` do segmento e gera um identificador com base nele. O identificador gerado é usado `SegmentDefinitionName` quando você acessa o segmento usando Perfis de clientes APIs.
Em Descrição, insira uma descrição opcional para o segmento de clientes.
### Etapa 3: revisar e validar o segmento
Analise os dados usados pelo assistente de IA do Segmento e as etapas do modelo de IA para gerar seu segmento. Você também pode revisar o SQL que ele criou para definir o segmento no editor de consultas. Se não conseguiu criar o segmento, aborde o feedback fornecido para ajudá-lo a criar um segmento preciso. Depois de gerar um segmento, o Customer Profiles criará automaticamente uma estimativa do segmento para você.
Se quiser fazer edições, você pode fornecer uma nova solicitação clicando em “Nova conversa” ou em create/edit SQL no editor de consultas.
Se você não estiver usando o assistente do Segment AI, poderá validar a consulta e criar a estimativa clicando no botão “Validar e estimar a consulta” abaixo do editor de consultas.
**nota**
Segmentos desenvolvidos pelo Spark SQL levarão tempo, dependendo da quantidade de dados de perfil que você usa no segmento e do SQL usado, de forma semelhante a outros mecanismos de consulta (por exemplo, várias junções entre objetos geralmente levam mais tempo).
### Etapa 4: criar segmento
Depois de criar um segmento e ficar satisfeito, selecione o botão “Criar segmento” no canto superior direito. Depois de criar o segmento, você pode selecionar Ações - exportando para .csv, usando o segmento em Flows e usando o segmento em Outbound Campaigns.
**nota**
Se você usar o segmento em campanhas externas ou blocos de fluxo, ele verificará a associação do segmento com base em quando o segmento foi criado pela última vez. Se você precisar de verificações de associação de segmentos em tempo real enquanto o Flow ou a campanha estão sendo executados, use a segmentação clássica.
# Gerenciar segmentos de clientes no Amazon Connect.
É possível usar o site de administração do Amazon Connect para criar, visualizar, copiar e executar outras tarefas de gerenciamento para segmentos de clientes. Se você abrir um segmento de clientes para visualizar as configurações, também será possível criar rapidamente uma campanha que use o segmento. Para obter mais informações sobre a criação de segmentos, consulte [Criar segmentos de clientes no Amazon Connect](customer-segments-building-segments.md) no Guia do desenvolvedor do Amazon Connect .
**Como gerenciar segmentos de clientes**
1. Na página **Segmentos de clientes**, navegue até o segmento que deseja gerenciar ou escolha uma ação.
![\[A página Segmentos de clientes com uma lista de segmentos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-managing-segments-1.png)
1. No menu **Ações**, as seguintes opções estão disponíveis:
1. **Exibir detalhes** — Escolha essa opção para mostrar informações sobre o segmento de clientes, incluindo a data e a hora em que o segmento foi criado e a data e a hora em que o segmento foi atualizado pela última vez. O usuário do Amazon Connect precisa da permissão do perfil de segurança **CustomerProfiles.Segments.View** para realizar essa ação.
1. **Duplicar**: escolha essa opção para criar um segmento de clientes que seja uma cópia do segmento selecionado. É possível modificar quaisquer configurações no novo segmento, sem alterar o segmento original. O Amazon Connect usuário precisa da permissão **CustomerProfiles.Segments.Create** de perfil de segurança para realizar essa ação.
1. **Exportar CSV**: escolha essa opção para exportar o segmento de clientes para um arquivo no computador. Para obter mais informações, consulte[Exportar segmentos de clientes para um arquivo CSV no Amazon Connect](customer-segments-exporting-segments.md). O Amazon Connect usuário precisa da permissão do perfil de segurança **CustomerProfiles.Segments.Export** para realizar essa ação.
1. **Excluir**: escolha essa opção para excluir o segmento de clientes permanentemente. Você não pode recuperar um segmento depois de excluí-lo. O Amazon Connect usuário precisa da permissão **CustomerProfiles.Segments.Delete** do perfil de segurança para realizar essa ação.
**Importante**
Se você excluir um segmento, todas as campanhas ativas que usam o segmento falharão. Da mesma forma, qualquer segmento criado com base nesse segmento deixará de funcionar. Antes de excluir um segmento, é uma boa ideia verificar primeiro se o segmento não está sendo usado por nenhuma campanha ativa ou outro segmento.
# Criar segmentos com base em arquivos importados no Amazon Connect
**nota**
Para acessar a experiência do criador de segmentação no site do Amazon Connect administrador, certifique-se de que as permissões apropriadas dos perfis de segurança estejam configuradas. Para obter mais informações, consulte [Atribuir permissões do perfil de segurança para gerenciar segmentos de clientes](security-profile-customer-profile-segmentation.md).
A importação de segmentos de clientes usa um arquivo CSV que contém dados de perfil para criar perfis ou atualizar os existentes, que são então agrupados em um segmento. O arquivo CSV não pode ter mais que 1 GB de tamanho e deve incluir cabeçalhos válidos que fazem o mapeamento em relação aos atributos de perfil padrão.
As etapas a seguir descrevem a criação e a configuração de um segmento de clientes importado:
1. [Criar um segmento](#create-new-segment)
1. [Fazer upload de arquivo CSV](#upload-csv-file)
1. [Configurar os detalhes do segmento](#configure-segment-details)
1. [Mapear os atributos do cliente](#map-customer-attributes)
1. [Definir a expiração do perfil](#set-profile-expiry)
1. [Criar e monitorar a importação de segmentos](#create-monitor-segment-import)
## Criar um segmento
1. Para criar um segmento, verifique se você criou as permissões de perfis de segurança como pré-requisito. Para obter mais informações, consulte [Atribuir permissões do perfil de segurança para gerenciar segmentos de clientes](security-profile-customer-profile-segmentation.md).
1. No site do Amazon Connect administrador, navegue até **Perfis de clientes** **Segmentos de clientes**
1. Escolha **Criar segmento** e selecione **De upload de arquivo** no menu suspenso.
## Fazer upload de arquivo CSV
Escolha um arquivo CSV realizando um dos seguintes procedimentos:
+ Selecione **Escolher arquivo** e escolha um arquivo.
+ Arraste e solte o arquivo na área de upload.
O arquivo deve:
+ Estar em formato CSV.
+ Ter menos de 1 GB de tamanho.
+ Conter cabeçalhos.
+ Codificada em UTF-8
## Configurar os detalhes do segmento
Em **Nome**, especifique um identificador reconhecível para o segmento. Este campo é obrigatório.
+ Use apenas letras (a–z, A–Z), números (0–9), hifens (-) e sublinhados (\$1).
+ Comece com uma letra ou um número (não um sublinhado).
+ Comprimento máximo de 255 caracteres.
**nota**
O site Amazon Connect administrativo usa esse nome como o `DisplayName` do segmento e gera um `SegmentDefinitionName` identificador exclusivo. Esse identificador é usado ao acessar o segmento por meio dos perfis de clientes do Amazon Connect APIs.
Em **Descrição** (opcional), adicione detalhes sobre o segmento:
+ Comprimento máximo de 1.000 caracteres.
## Mapear os atributos do cliente
O mapeamento de tipos de objeto define como o Customer Profiles processa os dados do CSV. Esse mapeamento:
+ Determina como os dados do CSV preenchem objetos de perfil padrão.
+ Especifica quais campos indexar para atribuição de perfis.
Para obter mais informações sobre o mapeamento de tipos de objeto, consulte [Criar e ingerir dados de clientes no Customer Profiles](customer-profiles-object-type-mappings.md).
Escolha uma destas opções para mapear as colunas do CSV em relação aos atributos do Customer Profiles:
### Opção 1: mapeamento baseado em IA (recomendado)
1. Escolha **Gerar atributos de clientes**, depois selecione **Próximo**.
1. O sistema analisa os cabeçalhos do CSV e sugere mapeamentos apropriados para os atributos de perfil padrão.
1. Revise os mapeamentos sugeridos.
1. (Opcional) Personalize os mapeamentos:
+ Modifique os mapeamentos de atributos de perfis padrão.
+ Adicione atributos personalizados usando o seguinte formato: `Attributes.attribute-name`.
+ Atualize o identificador exclusivo.
### Opção 2: mapeamento manual
1. Faça o mapeamento de cada cabeçalho de coluna do CSV em relação a um atributo de perfil:
+ Use os atributos de perfil padrão: Para obter uma lista completa, consulte [Definição de perfil padrão no Amazon Connect Customer Profiles](standard-profile-definition.md).
+ Crie atributos personalizados usando o seguinte formato: `Attributes.attribute-name`.
**nota**
É possível associar até 25 atributos.
1. Escolha um atributo mapeado como identificador do cliente (chave exclusiva).
### Escolher um identificador de cliente
Depois de concluir o mapeamento, escolha um atributo mapeado como identificador do cliente. O Amazon Connect Customer Profiles usa esse identificador para:
+ Criar perfis ou atualizar perfis existentes.
+ Combinar os dados recebidos com os perfis existentes.
**nota**
Os mapeamentos de atributos podem ser modificados a qualquer momento durante a configuração, seja usando mapeamento manual ou baseado em IA.
## Definir a expiração do perfil
Especifique quando os perfis importados expiram:
1. Escolha uma opção de expiração:
+ Padrão: 14 dias a partir da data de importação.
+ Personalizada: selecione uma data usando o seletor de datas.
1. Para datas de expiração personalizadas:
+ Mínimo: 1 dia após a importação.
+ Máximo: 90 dias após a importação.
O Customer Profiles remove os perfis expirados do segmento e do domínio de perfis.
**nota**
Escolha um período de expiração que se alinhe aos seus requisitos de retenção de dados. Considere se o período padrão de 14 dias atende às suas necessidades comerciais antes de selecionar uma data personalizada.
## Criar e monitorar a importação de segmentos
**Criar o segmento**
1. Como analisar a sua configuração do .
1. Selecione **Criar um segmento**.
1. O sistema vai:
+ Fazer upload do arquivo CSV.
+ Criar/atualizar perfis com base nos dados.
+ Agrupar os perfis em um segmento.
+ Mostrar o progresso usando um banner de notificação.
Monitorar o andamento da importação
+ Veja o progresso da importação na página de detalhes do segmento.
+ O banner de notificação mostra que o trabalho de importação está em andamento.
+ A tabela de detalhes do trabalho de importação mostra:
+ Nome do arquivo
+ Data de criação do trabalho de importação
+ Data de conclusão do trabalho de importação
+ Número de perfis processados
+ Número de importações bem-sucedidas
+ Número de importações com falha
+ Você pode cancelar a importação enquanto ela estiver em andamento.
+ O segmento pode ser usado em campanhas enquanto o trabalho de importação ainda está em andamento.
**nota**
Os segmentos importados podem ser usados como qualquer outro segmento para campanhas externas ou exportações após a conclusão da importação. Você pode visualizar os detalhes do segmento, incluindo o status e os resultados da importação, na página de detalhes do segmento.
# Exportar segmentos de clientes para um arquivo CSV no Amazon Connect
Na página **Segmentos de clientes** no site Amazon Connect administrativo, você pode exportar um segmento existente para um arquivo no seu computador. Ao fazer isso, o Customer Profiles exporta todos os atributos do perfil associados aos perfis no segmento de clientes para um arquivo CSV.
**Como exportar um segmento de clientes**
1. Na página Segmentos de clientes, escolha **Exportar CSV** na lista suspensa de ações.
![\[A página Segmentos de clientes com a opção Exportar CSV.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-exporting-segments-1.png)
Você também pode navegar até a página **Visualizar detalhes** e escolher **Próximas ações**, **Download**.
![\[A página de detalhes de um segmento com a opção Próximas ações.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-exporting-segments-2.png)
**nota**
O site Amazon Connect administrativo oferece suporte à exportação de um segmento de clientes que contém até 350.000 perfis. Se você precisar exportar um segmento que contenha um grande número de perfis, use a operação `CreateSegmentSnapshot` na API do Customer Profiles. A operação `CreateSegmentSnapshot` oferece suporte à exportação de segmentos em arquivos ORC, JSONL e CSV para um bucket do S3. Observe que a API gera um arquivo de teste além do segmento exportado no bucket.
1. Depois que o trabalho de exportação começar, mantenha a janela ou guia do download aberta até que o processo seja concluído.
![\[Uma mensagem de que o segmento está sendo exportado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-exporting-segments-3.png)
1. Depois que o trabalho de exportação for concluído, o site Amazon Connect administrativo iniciará automaticamente o download do arquivo.
![\[Uma mensagem informando que o segmento foi baixado com sucesso.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-exporting-segments-4.png)
O arquivo CSV exportado contém todos os [atributos de perfil padrão e de cliente](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html) preenchidos nos perfis exportados.
# Usar o assistente de IA para segmentos no Amazon Connect
O Amazon Connect Customer Profiles oferece suporte à segmentação baseada em IA generativa, permitindo que usuários corporativos não técnicos criem públicos usando consultas em linguagem natural ([assistente de IA para segmentos](#generating-a-segment-by-prompt)) e recebam recomendações com base em tendências nos dados do cliente ([cartões de inspiração para criação de segmentos](#inspiration-cards-for-segment-creation)). Esses recursos utilizam algoritmos avançados de IA do [Amazon Bedrock](https://aws.amazon.com/bedrock/) que ajudam você a melhorar a satisfação do cliente e gerar receita por meio de um atendimento proativo e personalizado. Por exemplo, você pode criar um segmento de clientes que entraram em contato com o serviço de atendimento ao cliente com frequência na semana passada para oferecer serviços personalizados. Também pode identificar clientes cujos gastos totais aumentaram e oferecer descontos personalizados, promovendo a fidelidade e também impulsionando o crescimento.
Os seguintes benefícios são adicionados ao incorporar a IA generativa ao fluxo de trabalho de segmentação:
+ **Criação simplificada de segmentos**: crie segmentos de clientes complexos usando linguagem conversacional, tornando o processo acessível a usuários não técnicos e aumentando a eficiência.
+ Inspirações para a criação de segmentos baseados em dados: receba inspirações para segmentos com tecnologia de IA com base em tendências nos dados dos clientes.
+ **Personalização aprimorada**: identifique e segmente facilmente grupos específicos de clientes para comunicação e ofertas personalizadas.
As seções a seguir explicam cada recurso, como usá-los e os benefícios que eles oferecem para ajudar você a melhorar seus esforços de segmentação de clientes.
**nota**
Para usar o assistente de IA do segmento, os usuários precisarão da permissão para criar o segmento **CustomerProfiles.Segments.Create.**
Embora essas ferramentas baseadas em IA ofereçam sugestões valiosas, é importante revisar e ajustar os segmentos recomendados para garantir que estejam alinhados aos objetivos comerciais específicos da organização e estejam em conformidade com suas políticas de uso de dados.
## Cartões de inspiração para a criação de segmentos
Os cartões de inspiração são um recurso baseado em IA disponível na página **Segmentos de clientes**. Eles simplificam e aprimoram o processo de criação de segmentos. A imagem a seguir mostra um exemplo de três cartões de inspiração.
![\[Um exemplo de cartões de inspiração na página Segmentos de clientes.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/inspiration-cards-for-segment-creation-1.png)
Esses cartões geram até três categorias de ideias de segmentos por vez, com base nos dados do Amazon Connect Customer Profiles para inspirar e agilizar o processo de criação de segmentos.
**nota**
Os dados de tendência são baseados nas datas de ingestão de eventos dos atributos calculados padrão.
**Recursos principais**
+ **Inspirações baseadas em dados**: cada cartão de inspiração apresenta uma ideia de segmento adaptada a dados e tendências específicos de clientes.
+ Os cartões de inspiração oferecem ideias em três temas com foco nos negócios:
+ **Promoção**: ideias para segmentar clientes com estratégias promocionais específicas.
+ **Retenção**: identifica segmentos para esforços de retenção de clientes.
+ **Suporte**: destaca grupos de clientes que podem precisar de atenção especializada no serviço de atendimento ao cliente.
+ **Recomendações baseadas em insights**: aproveite tendências históricas, insights de dados e IA generativa para criar insights significativos e acionáveis.
**Como usar os cartões de inspiração**
1. Navegue até a página **Segmentos de clientes**.
1. Localize a seção de cartões de inspiração. Ela exibe três sugestões de segmentos.
1. Analise cada cartão para entender o segmento proposto e suas possíveis aplicações.
1. Quando você encontrar um cartão que deseja usar, escolha **Comece a usar** no cartão.
1. Escolha **Explore mais** para gerar cartões de inspiração adicionais. Eles podem oferecer novas ideias de segmentos com base em seus dados do Amazon Connect Customer Profiles.
1. Ao escolher **Comece a usar**, é exibida automaticamente a página **Criar segmento**.
1. Sua ideia de segmento selecionada é preenchida no construtor de segmentos, pronta para sua análise e refinamento.
## Gerar um segmento usando prompts em linguagem natural
O assistente de IA para segmentos oferece uma abordagem guiada para criar segmentos usando prompts de linguagem natural, o que simplifica o processo de criação de segmentos complexos, permitindo que você descreva o público em linguagem natural e receba uma definição de segmento estruturada e acionável.
A imagem a seguir mostra um exemplo de prompt do assistente de IA para segmentos.
![\[Um exemplo de prompt do assistente de IA para segmentos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/generating-a-segment-by-prompt-1.png)
**Para acessar esse recurso:**
1. Navegue até a página **Segmento de clientes** e escolha **Criar segmento**.
1. Localize o painel do assistente de IA para segmentos no lado direito da página, conforme mostrado na imagem a seguir.
![\[Um exemplo do painel do assistente de IA para segmentos no lado direito da página.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/generating-a-segment-by-prompt-2.png)
**Usar o assistente de IA para segmentos**
1. O assistente orienta os usuários por meio de uma série de perguntas para entender as necessidades de segmentação. Todos os caminhos de interação com o assistente levam à geração de um prompt.
1. Os usuários podem fornecer uma descrição textual do segmento desejado.
1. A etapa de ação de prompt oferece exemplos de prompts como referência para escrever descrições detalhadas.
1. Com base nas informações fornecidas, o Amazon Connect gera uma definição estruturada de segmento.
1. A definição de segmento gerada é aplicada automaticamente ao construtor de segmentos.
1. Você pode refinar ainda mais o segmento gerado usando as ferramentas padrão do construtor de segmentos. A modificação dos filtros no construtor de segmentos substitui as condições existentes geradas anteriormente.
1. Depois de analisar o segmento gerado e fazer os ajustes necessários, você pode finalizar o processo escolhendo **Criar segmento**. Essa ação salva o segmento e o disponibiliza para uso em suas campanhas.
**Práticas recomendadas**
Ao usar o assistente de IA para segmentos, tenha em mente as seguintes práticas recomendadas:
+ Escreva descrições específicas. O assistente de IA para segmentos gera condições mais precisas quando você usa os nomes dos atributos existentes.
+ Garanta que todos os atributos referenciados existam no domínio.
+ Comece com prompts simples e experimente prompts diferentes. Se você não receber o que deseja na primeira tentativa, reescreva o prompt. Ao enviar um novo prompt, ou ao selecionar **Nova conversa**, as condições existentes são substituídas.
+ Aloque tempo para refinamento e validação de segmentos no construtor de segmentos a fim de garantir que os segmentos reflitam com precisão os valores reais dos dados.
**nota**
O assistente de IA para segmentos foi projetado para trabalhar com descritores e critérios gerais. Sempre siga os regulamentos de proteção de dados e as políticas da empresa ao descrever os segmentos. Garanta que os prompts e as descrições não contenham informações confidenciais ou pessoais.
## Fornecer feedback sobre segmentos gerados
Depois que um segmento é gerado, os usuários são incentivados a avaliar o desempenho do recurso e fornecer feedback. Esse mecanismo de feedback ajuda a melhorar o processo de geração de segmentos e garante que ele atenda às necessidades de negócios de forma eficaz. A imagem a seguir mostra uma página de feedback.
![\[Um exemplo de mensagem informando que o feedback foi registrado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/providing-feedback-on-generated-segments-1.png)
O processo de feedback consiste em duas etapas:
1. **Reação inicial**: no canto inferior direito da seção de alerta, você encontrará ícones de polegar para cima e polegar para baixo. Clique em qualquer um deles para indicar sua satisfação geral com o segmento gerado.
1. **Feedback adicional**: depois de selecionar o ícone de polegar para cima ou para baixo, você terá a opção de fornecer um feedback mais detalhado. Isso assume a forma de um campo de entrada de texto no qual você pode deixar comentários de formato livre.
Recomendamos que use a reação rápida (polegar para cima/para baixo) e a entrada de texto para uma avaliação abrangente, forneça exemplos específicos ou casos de uso quando aplicável, concentre-se em como o segmento gerado se alinha aos objetivos de negócios e sugira melhorias ou recursos adicionais que aprimorariam o processo de geração de segmentos.
Sugira melhorias ou recursos adicionais que aprimorariam o processo de geração de segmentos.
Ao participar ativamente do processo de feedback, os usuários contribuem para a melhoria contínua do recurso de geração de segmentos, levando a uma segmentação de clientes mais eficaz e estratégias de marketing direcionadas.
## Tratamento de erros
Ao usar o assistente de IA para segmentos a fim de gerar segmentos de clientes, é possível que você receba ocasionalmente uma mensagem de erro informando o seguinte: **We can't process your request right now.** Esse erro pode ocorrer mesmo depois de fornecer um prompt válido para a criação do segmento.
A imagem a seguir mostra um exemplo dessa mensagem de erro.
![\[Um exemplo de mensagem de erro informando que o Amazon Connect não pode processar sua solicitação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-segments-ai-error-handling-1.png)
Use as etapas a seguir para ajudar você a entender e solucionar esse erro.
**Causas possíveis:**
+ **Alta carga do sistema**: o assistente de IA para segmentos pode estar enfrentando alta demanda ou processando várias solicitações simultaneamente.
+ **Interrupção temporária do serviço**: pode haver uma breve interrupção na capacidade do serviço de processar novas solicitações de segmentos.
+ **Consulta complexa**: o sistema pode precisar de mais tempo para processar consultas de segmentos particularmente complexas ou que consomem muitos recursos.
**O que fazer:**
+ **Aguarde e tente novamente**: a mensagem de erro sugere que você espere alguns minutos antes de tentar novamente. Isso permite que o sistema resolva quaisquer problemas temporários.
+ **Crie um segmento manualmente**: se precisar do segmento imediatamente, você pode optar por criá-lo manualmente usando o construtor de segmentos
**Como tentar novamente:**
1. Aguarde alguns minutos.
1. Escolha **Nova conversa** na parte inferior da interface de chat.
1. Inicie uma nova conversa e insira novamente o prompt de criação de segmento.
**Práticas recomendadas**
+ Se o erro persistir após várias tentativas, considere simplificar os critérios do segmento ou dividi-los em solicitações menores e mais gerenciáveis.
+ Tente evitar fazer solicitações repetidas em rápida sucessão, pois isso pode contribuir para a sobrecarga do sistema.
+ Se o problema persistir, entre em contato com o serviço de atendimento ao cliente para obter mais ajuda.
Lembre-se de que esse erro geralmente é temporário e seguir as instruções fornecidas deve possibilitar que você crie o segmento desejado com sucesso.
## Limitações conhecidas
Compreender o ciclo de vida do processamento de dados é crucial para o uso eficaz do assistente de IA para segmentos. Esta seção descreve o que os usuários corporativos podem esperar durante as diferentes fases da integração de dados e como isso afeta as sugestões de segmentos.
**Processamento de dados e impacto na qualidade:** o assistente de IA para segmentos evolui em duas fases principais: ingestão de dados inicial e pós-processamento. Durante a ingestão inicial, o sistema pode não utilizar totalmente os valores reais dos atributos, confiando mais na interpretação do prompt. Por exemplo, um prompt para *Clientes VIP* pode sugerir um segmento *VIP* em vez de usar o nível *Ouro* existente dos seus dados. Após o processamento completo, o sistema aproveita os valores reais dos atributos, resultando em uma criação de segmento mais precisa, reduz a dependência da interpretação do prompt e melhora a qualidade geral da segmentação.
**nota**
Reserve tempo suficiente para concluir o processamento dos dados antes de confiar em recursos avançados. Atualize regularmente os dados dos perfis de cliente. A precisão do segmento depende da integridade e da atualização dos dados de clientes no Amazon Connect Customer Profiles. O sistema sinaliza quaisquer atributos ausentes em suas respostas.
**Desempenho do sistema:** durante períodos de alto volume, espere possíveis atrasos na geração do segmento. O sistema é otimizado para workloads típicas, mas empresas com grandes necessidades de segmentação podem precisar ajustar seus processos adequadamente.
**Disponibilidade de atributos**: a qualidade dos segmentos gerados depende dos dados de clientes disponíveis no Amazon Connect Customer Profiles. Quanto mais abrangentes up-to-date os dados do perfil do cliente, mais preciso o sistema pode ser na interpretação de solicitações e na definição de segmentos relevantes. Se houver um atributo que não exista, retornaremos uma mensagem com o atributo ausente.
**Complexidade do prompt**: para definições de segmentos muito complexas ou diferenciadas, o processamento de linguagem natural pode ter limitações. Os clientes devem começar com prompts relativamente diretos e aumentar gradualmente a complexidade à medida que ganham experiência com o recurso.
**Refinamento do segmento**: embora os segmentos gerados pelo sistema sejam um excelente ponto de partida, os clientes ainda podem querer revisar e refinar os detalhes para garantir que o segmento esteja perfeitamente alinhado aos objetivos comerciais. A interface de segmentação permite a personalização completa após a geração inicial.
**Desempenho e escalabilidade**: sob alta simultaneidade, pode haver alguma latência no processo de geração de segmentos, pois o modelo de linguagem precisa processar cada prompt. O sistema foi projetado para lidar com workloads de segmentação típicas, mas clientes com demandas de segmentação extremamente altas podem precisar ajustar seus fluxos de trabalho adequadamente.
# Solução de problemas de segmentos de clientes no Amazon Connect
## A opção Segmentos de clientes não aparece no painel de navegação esquerdo
Se a opção **Segmentos de clientes** não existir no painel de navegação esquerdo do site Amazon Connect administrativo, verifique se os perfis de segurança do usuário têm a permissão **Segmento Cliente - Visualizar**. Para obter mais informações, consulte[Atribuir permissões do perfil de segurança para gerenciar segmentos de clientes](security-profile-customer-profile-segmentation.md). Depois que a permissão for atualizada, atualize a página do site de administração do Amazon Connect para refletir a alteração.
## O botão Exportar CSV não está disponível ou o trabalho de exportação atingiu o tempo limite
A exportação de um segmento que contém mais de 350.000 perfis não é suportada no site do Amazon Connect administrador. Como alternativa, recomendamos exportar esse tipo de segmento para um bucket do Amazon S3 usando a API `CreateSegmentSnapshot` por meio da interface de linha de comandos (CLI) ou do SDK.
## Erro: You reached the limit of 60 unique attributes
Esse erro ocorre quando o número de atributos exclusivos na definição do segmento excede a cota. O número de atributos exclusivos é contado de forma recursiva e inclui os públicos iniciais.
**Soluções**
+ Reduza o número de atributos exclusivos removendo filtros de público na definição do segmento ou removendo públicos iniciais que contêm filtros de público.
+ [Solicite um aumento de cota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) para as cotas de serviço: número máximo de atributos exclusivos no segmento.
Para saber mais sobre a cota de serviço padrão, consulte [Cotas de serviço do Amazon Connect Customer Profiles](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
## Erro: You reached the limit of 10 unique calculated attributes
Esse erro ocorre quando o número de atributos calculados exclusivos na definição do segmento excede a cota. O número de atributos calculados exclusivos é contado de forma recursiva e inclui os públicos iniciais.
**Soluções**
+ Reduza o número de atributos calculados exclusivos removendo filtros de público nos atributos calculados na definição do segmento ou removendo públicos iniciais que contêm filtros de público nos atributos calculados.
+ [Solicite um aumento de cota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) para as cotas de serviço: número máximo de atributos calculados exclusivos no segmento.
Para saber mais sobre a cota de serviço padrão, consulte [Cotas de serviço do Amazon Connect Customer Profiles](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
## Erro: You reached the limit of 5 depth of starting audiences
Esse erro ocorre quando a profundidade dos públicos iniciais excede a cota. A profundidade é contada de forma recursiva para todos os públicos iniciais no grupo de público. Por exemplo, se você selecionar um segmento “Elegível para upgrade de aluguel” como público inicial e o segmento “Elegível para upgrade de aluguel” tiver outro segmento como público inicial, a profundidade será 2.
**Solução**
+ Remova um ou mais públicos iniciais do grupo de público que contenha públicos iniciais profundamente aninhados.
Para saber mais sobre as cotas de serviço padrão, consulte [Cotas de serviço do Amazon Connect Customer Profiles](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
# Configurar o Explorador de perfis no Amazon Connect Customer Profiles
O Amazon Connect Customer Profiles Explorer é um all-in-one painel dinâmico que fornece uma visão abrangente de 360° de seus clientes. Ele unifica os dados fragmentados dos clientes e permite que as organizações personalizem as exibições de dados, rastreiem as interações e transformem as informações dos clientes em insights acionáveis que geram valor comercial e fidelização dos clientes. Organizações em setores como viagens e hospitalidade podem usar o Explorador de perfis para entender e interagir melhor com seus clientes por meio dessa interface intuitiva.
+ **Encontre clientes num piscar de olhos** usando vários identificadores simultaneamente (e-mail, telefone, referência de reserva etc.) com resultados de pesquisa em tempo real.
+ **Personalize as visualizações** a fim de priorizar as informações mais relevantes para necessidades comerciais específicas e crie um layout específico do domínio que destaque os dados de clientes mais relevantes definidos por você.
+ **Acesse o contexto completo dos clientes**, incluindo dados demográficos, histórico de comunicação, interações comportamentais e associação ao segmento com visualizações interativas e exibições de dados.
+ **Aproveite os insights baseados em IA** com resumos de clientes que destacam os principais padrões e inferências comportamentais personalizadas.
![\[O painel do Explorador de perfis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-profile-explorer-1.png)
**Topics**
+ [
# Habilitar o Explorador de perfis
](enabling-profile-explorer.md)
+ [Conceitos básicos](getting-started-profile-explorer.md)
+ [
# Definição de layout
](layout-definition.md)
+ [
# Adicionar o Explorador de perfis ao espaço de trabalho de atendente
](add-profileexplorer-to-agentworkspace.md)
# Habilitar o Explorador de perfis
As etapas a seguir permitirão que você habilite o Explorador de perfis para administradores e usuários. Esse processo envolve a definição de permissões tanto para a configuração do layout quanto para o acesso de visualização.
**Topics**
+ [
## Permitir que administradores definam um layout
](#enable-administrators-define-layout)
+ [
## Permitir que os usuários visualizem o Explorador de perfis
](#enable-users-view-profile-explorer)
+ [
## Verificar a configuração
](#verify-setup)
## Permitir que administradores definam um layout
Os administradores precisam de permissões específicas para criar e editar os layouts do Explorador de perfis:
+ Atribua as seguintes permissões no perfil de segurança do Explorador de perfis:
+ **Explorador de perfis - Editar**: permite a modificação do layout existente do Explorador de perfis.
+ **Explorador de perfis - Criar**: permite a criação do layout do Explorador de perfis.
+ **Explorador de perfis - Visualizar**: concede acesso para visualizar o layout configurado do Explorador de perfis.
![\[Adicione permissões para autorizar os usuários a criar, editar e visualizar os layouts do Explorador de perfis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-administrators-define-layout-1.png)
## Permitir que os usuários visualizem o Explorador de perfis
Os usuários precisam de permissões apropriadas para acessar e interagir com o layout do Explorador de perfis:
+ Atribua as seguintes permissões no perfil de segurança do Explorador de perfis:
+ **Explorador de perfis - Visualizar**: concede acesso para visualizar o layout configurado do Explorador de perfis.
![\[Adicione permissões para autorizar os usuários a visualizar os layouts do Explorador de perfis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-users-view-profile-explorer-1.png)
## Verificar a configuração
Para confirmar se o Explorador de perfis pode ser habilitado com sucesso:
Faça login como administrador para verificar se você consegue:
+ Acessar a página Explorador de perfis.
+ Criar e modificar o layout do Explorador de perfis.
Faça login como usuário comum para verificar se você consegue:
+ Acessar o Explorador de perfis.
+ Visualizar o layout do Explorador de perfis.
+ Interagir com os recursos habilitados.
# Começar a usar o Explorador de perfis do Amazon Connect Customer Profiles
Comece a usar o Explorador de perfis e aprenda os conceitos básicos da interface.
**Topics**
+ [
# Controles de layout
](layout-controls.md)
+ [
# Editar o layout do explorador
](editing-explorer-layout.md)
+ [
# Salvar o layout do explorador
](saving-explorer-layout.md)
# Controles de layout
![\[Adicione permissões para autorizar os usuários a visualizar os layouts do Explorador de perfis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/layout-controls-1.png)
Console de boas-vindas do Explorador de perfis.
1. Editar guias
1. Adicionar widgets
1. Ações de layout
## Editar guias
Organize seu painel em seções lógicas usando os controles de guia:
+ **1a. Adicionar guia**: crie guias para separar diferentes aspectos dos dados de clientes.
+ **1b. Remover guia**: exclua guias desnecessárias do seu layout.
+ **1c. Renomear guia**: personalize os nomes das guias para refletir o conteúdo delas.
+ **1d. Reordenar guias**: arraste e solte as guias para organizá-las na ordem de sua preferência.
![\[Janela pop-up Editar guias.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/layout-controls-2.png)
## Adicione widgets
Melhore sua guia ativa com vários widgets de visualização de dados:
### Widgets disponíveis
+ Widgets padrão
+ [Resumo por IA generativa](default-widgets.md#generative-ai-summary)
+ [Informações do cliente](default-widgets.md#customer-information)
+ [Atributo calculado](default-widgets.md#calculated-attribute)
+ [Contatos](default-widgets.md#contacts)
+ [Casos](default-widgets.md#cases-cp)
+ [Pedidos](default-widgets.md#orders-cp)
+ [Ativos](default-widgets.md#assets-cp)
+ Widgets personalizados
+ [Tabela](custom-widgets.md#table-widget)
+ [Par de chave/valor](custom-widgets.md#key-value-pair)
+ [Métrica de chave](custom-widgets.md#key-metric)
+ [Gráfico de rosca](custom-widgets.md#donut-chart)
Basta selecionar um widget que você deseja usar e começar a explorar.
## Ações de layout
Gerencie a configuração geral do painel:
+ **Salvar layout**: preserva a configuração atual do painel.
![\[Janela pop-up Salve seu layout.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/layout-controls-3.png)
**nota**
Todas as alterações ficam em um rascunho até serem salvas.
# Editar o layout do explorador
Personalize o layout do Explorador de perfis por meio de controles simples e intuitivos para gerenciar widgets e seu posicionamento.
## Controles de widgets
Cada widget apresenta um menu de três pontos no canto superior direito, oferecendo duas opções principais:
+ **1A Editar**: abre o painel de configuração desse widget específico.
+ **1B Remover**: exclui o widget do seu layout.
![\[Janela pop-up de edição ou remoção no layout do explorador.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/widget-controls-1.png)
## Personalização de widgets
+ **Arrastar e soltar**: reposicione os widgets em qualquer lugar do seu painel.
+ **Redimensionar**: escolha e arraste as bordas do widget para ajustar as dimensões.
+ **Configuração**: acesse configurações detalhadas por meio do painel de edição específico para cada tipo de widget.
![\[Personalize e reordene os widgets no layout do explorador.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/widget-customization-1.png)
**nota**
Cada tipo de widget tem opções de configuração exclusivas. Para obter informações detalhadas sobre configurações específicas dos widgets, consulte a documentação dos widgets.
## Adicionar novos widgets
Para adicionar novos componentes ao seu layout, use o botão **Adicionar widgets** no painel de controle.
# Salvar o layout do explorador
Como salvar e gerenciar as configurações de layout do Explorador de perfis.
## Persistência do layout
As alterações feitas no layout do Explorador de perfis devem ser salvas para que persistam. As alterações não salvas serão perdidas ao sair da página ou atualizar o navegador.
## Layout padrão
Cada implementação do Explorador de perfis inclui um layout padrão. Isso serve como configuração básica para sua organização e pode ser modificado conforme necessário.
## Salve as alterações.
Para salvar as modificações do layout:
1. Escolha **Salvar** no menu Ações de layout.
1. Confirme as alterações na caixa de diálogo de salvamento.
1. O layout será atualizado para todos os usuários após a conclusão do salvamento.
![\[Caixa de diálogo Salve seu layout no layout do explorador.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/saving-changes-1.png)
**nota**
As permissões apropriadas são necessárias para salvar as alterações de layout. Para obter informações sobre as permissões necessárias, consulte [Habilitar o Explorador de perfis](enabling-profile-explorer.md).
# Definição de layout
Noções básicas da estrutura e dos componentes dos layouts do Explorador de perfis.
**Topics**
+ [
# Como funcionam
](how-it-works.md)
+ [
# Widgets
](widgets.md)
# Como funcionam
O Explorador de perfis oferece vários widgets para exibir informações dos clientes. Os layouts são armazenados como definições JSON, representando a estrutura e a configuração completas do seu painel. Cada widget e componente no layout visual corresponde a um bloco JSON específico dentro dessa definição.
## Componentes principais
Cada componente na definição do layout é composto por cinco elementos comuns:
+ **Tipo**
+ Define a categoria do componente.
+ Determina como o componente é renderizado.
+ Exemplos: BoardItem, Tabela, KeyValuePair
+ **Id**
+ Identificador exclusivo para cada componente.
+ Usado para rastreamento e atualizações de componentes.
+ Gerado automaticamente quando os componentes são criados no construtor.
+ **Adereços**
+ Propriedades específicas do componente.
+ Controla a aparência e o comportamento.
+ Contém definições de configuração.
+ **Crianças**
+ Componentes ou conteúdo aninhados.
+ Define relações hierárquicas.
+ Pode conter vários subcomponentes.
+ **DataSource**
+ Especifica a origem dos dados.
+ Define parâmetros de recuperação de dados.
+ Controla a vinculação de dados para os componentes.
## Exemplo de definição de componente do layout
Veja a seguir um exemplo de estrutura JSON para um componente de tabela do painel:
```
{
"Id": "unique-identifier",
"Type": "BoardItem",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "Table",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "TextContent",
"Props": {},
"Children": ["string"]
}
]
}
],
"DataSource": [
{
"Type": "source-type",
"Params": {}
}
]
}
```
## Configuração dinâmica de dados
O Explorador de perfis usa expressões de modelo para acessar e exibir dados do Customer Profiles de forma dinâmica nos componentes.
### Suporte a valor único
Para componentes como Par de chave/valor e Métrica de chave, você pode acessar:
#### Informações de perfil padrão
```
{{Customer.}}
```
Exemplo de uso:
+ `{{Customer.FirstName}}`
+ `{{Customer.LastName}}`
+ `{{Customer.PhoneNumber}}`
#### Atributos calculados
```
{{Customer.CalculatedAttributes.}}
```
Exemplo de uso:
+ `{{Customer.CalculatedAttributes._cases_count}}`
+ `{{Customer.CalculatedAttributes._new_customer}}`
### Sintaxe de suporte a dados tabulares
#### Atributos calculados
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}}
```
#### Segmentos
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.SegmentDefinitionName}}
```
#### Objetos de perfil
```
{{Customer.ObjectAttributes..}}
```
**Exemplo de uso**:
+ `{{Customer.ObjectAttributes.CTR.contactId}}`
+ `{{Customer.ObjectAttributes.Order.orderId}}`
### Exemplos de implementação
#### Componente de valor único
```
{
"Type": "KeyValuePair",
"Props": {
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Children": ["Customer Name"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.FirstName}}"]
}
}
}
]
}
}
```
#### Componente tabular
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Cell": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"]
}
},
"Header": "Contact ID"
}
]
}
}
```
**nota**
Garanta que os atributos, objetos e segmentos referenciados existam na configuração do Customer Profiles antes de usá-los no layout.
# Widgets
Explore os diferentes tipos de widgets disponíveis no Explorador de perfis.
## Visão geral do
Os widgets no Explorador de perfis são elementos compostos baseados em componentes JSON dentro da sua definição de layout. Embora esses widgets representem estruturas JSON complexas, nosso construtor de interface de usuário lida com a composição técnica automaticamente, tornando o gerenciamento de painéis simples e acessível.
**Topics**
+ [
## Visão geral do
](#widgets-overview)
+ [
## Widgets disponíveis
](#available-widgets)
+ [
# Widgets padrão
](default-widgets.md)
+ [
# Widgets personalizados
](custom-widgets.md)
## Widgets disponíveis
+ Widgets padrão
+ [Resumo por IA generativa](default-widgets.md#generative-ai-summary)
+ [Informações do cliente](default-widgets.md#customer-information)
+ [Atributo calculado](default-widgets.md#calculated-attribute)
+ [Contatos](default-widgets.md#contacts)
+ [Casos](default-widgets.md#cases-cp)
+ [Pedidos](default-widgets.md#orders-cp)
+ [Ativos](default-widgets.md#assets-cp)
+ Widgets personalizados
+ [Tabela](custom-widgets.md#table-widget)
+ [Par de chave/valor](custom-widgets.md#key-value-pair)
+ [Métrica de chave](custom-widgets.md#key-metric)
+ [Gráfico de rosca](custom-widgets.md#donut-chart)
# Widgets padrão
O Explorador de perfis vem com uma coleção de widgets pré-configurados e projetados para funcionar perfeitamente com os dados do Customer Profiles. Esses widgets padrão oferecem valor imediato com configuração mínima, permitindo que você crie painéis sofisticados com apenas alguns cliques.
![\[Adicione widgets padrão no layout do explorador.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/default-widgets-1.png)
## Ready-to-use widgets
+ [Resumo por IA generativa](#generative-ai-summary)
+ [Informações do cliente](#customer-information)
+ [Atributo calculado](#calculated-attribute)
+ [Contatos](#contacts)
+ [Casos](#cases-cp)
+ [Pedidos](#orders-cp)
+ [Ativos](#assets-cp)
**nota**
Embora esses widgets venham pré-configurados, você ainda pode personalizá-los para melhor atender às suas necessidades específicas. Eles servem como ponto de partida para facilitar a integração.
## Resumo por IA generativa
O Explorador de perfis fornece insights de clientes padrão baseados em IA para a geração de resumos concisos que destacam os principais padrões comportamentais, fornece insights de clientes personalizados com base no histórico de interações e apresentam recomendações acionáveis com base em dados completos dos clientes. Os resumos gerados por IA ajudam as organizações a tomar decisões baseadas em dados, identificando padrões em vários pontos de contato com o cliente, fornecendo insights comportamentais personalizados específicos para cada cliente e oferecendo suporte à melhoria das experiências do cliente e ao aumento da fidelidade.
![\[Widget Resumo por IA generativa.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/generative-ai-summary-1.png)
## Informações do cliente
O widget Informações do cliente fornece uma visão clara e organizada dos dados padrão de perfis de cliente usando componentes de pares de chave/valor. Esse widget padrão exibe automaticamente as informações essenciais dos clientes em um formato facilmente verificável.
### Visão geral do
Esse widget utiliza o componente Par de chave/valor para exibir os atributos de clientes em um layout estruturado.
+ Nome
+ Sobrenome
+ Endereço de e-mail
+ Número de telefone
+ Endereço
+ Número da conta
+ ID do perfil
### Dados
O widget se conecta automaticamente ao seu domínio do Customer Profiles e extrai informações dos atributos de perfil padrão. Nenhuma configuração adicional é necessária para a funcionalidade básica.
**Observação**: embora esse widget venha pré-configurado com atributos de perfil padrão, é possível personalizar quais atributos do perfil padrão são exibidos com base em suas necessidades específicas.
#### Saiba mais
+ [Definição de perfil padrão](standard-profile-definition.md)
+ Par de chave/valor
## Atributo calculado
O widget Atributo calculado permite que você exiba um componente Métrica de chave utilizando dados dos atributos calculados de seus perfis de cliente.
### Visão geral do
O widget Atributo calculado permite que você exiba um componente Métrica de chave utilizando dados dos atributos calculados de seus perfis de cliente.
### Recursos do componente
+ Exibe métricas calculadas na forma de indicadores de valor único.
### Exemplos de casos de uso
+ Campanhas entregues
+ Chamados abertos
+ Tempo médio de chamada
+ Preferência de canal
### Configuração
Basta selecionar o atributo calculado e escolher o formato de exibição preferido.
**nota**
Os atributos calculados devem ser configurados em seu domínio do Customer Profiles antes de serem usados nesse widget.
**Saiba mais**
+ Métrica de chave
+ [Configurar atributos calculados](customerprofiles-calculated-attributes-admin-website.md)
## Contatos
Baseado no componente JSON de tabela, o widget Contatos exibe os dados de objetos de contato do Customer Profiles em um formato tabular organizado. Esse widget se conecta automaticamente aos dados de CTR do Customer Profiles, mostrando as principais informações de contato e o histórico de interações.
### Recursos
+ Visualizar todos os eventos de contato de clientes.
+ Classificar e filtrar registros de contato.
+ Personalizar os campos de contato exibidos.
+ Acessar informações de contato detalhadas.
Para obter mais informações sobre os objetos de CTR do Customer Profiles, consulte [Modelos de registro de contato no Amazon Connect Customer Profiles](ctr-contact-record-template.md).
## Casos
Baseado no componente JSON de tabela, o widget Chamados exibe os dados de objetos de chamado do Customer Profiles em um formato tabular organizado. Esse widget se conecta automaticamente aos dados de chamados do Customer Profiles, mostrando as interações de suporte e os detalhes do gerenciamento de chamados.
### Recursos
+ Visualizar todos os chamados de clientes.
+ Classificar e filtrar registros de chamados.
+ Personalizar os campos de chamado exibidos.
+ Acessar informações de chamado detalhadas.
Para obter mais informações sobre os objetos de chamado do Customer Profiles, consulte [Mapeamento de tipo de objeto para o caso padrão no Customer Profiles](object-type-mapping-standard-case.md).
## Pedidos
Baseado no componente JSON de tabela, o widget Pedidos exibe os dados de objetos de pedido do Customer Profiles em um formato tabular organizado. Esse widget se conecta automaticamente aos dados de pedidos do Customer Profiles, mostrando o histórico de compras e os detalhes das transações.
### Recursos
+ Visualizar todos os eventos de pedidos de clientes.
+ Classificar e filtrar registros de pedidos.
+ Personalizar os campos de pedido exibidos.
+ Acessar informações de pedido detalhadas.
Para obter mais informações sobre os objetos de pedido do Customer Profiles, consulte [Mapeamento de tipo de objeto para o pedido padrão no Amazon Connect Customer Profiles](object-type-mapping-standard-order.md).
## Ativos
Baseado no componente JSON de tabela, o widget Ativos exibe os dados de objetos de ativo do Customer Profiles em um formato tabular organizado. Esse widget se conecta automaticamente aos dados de ativos do Customer Profiles, mostrando produtos e serviços de propriedade do cliente.
### Recursos
+ Visualizar todos os registros de ativos de clientes.
+ Classificar e filtrar dados de ativos.
+ Personalizar os campos de ativo exibidos.
+ Acessar informações de ativo detalhadas.
Para obter mais informações sobre os objetos de ativo do Customer Profiles, consulte [Mapeamento de tipo de objeto para o ativo padrão no Customer Profiles](object-type-mapping-standard-asset.md).
# Widgets personalizados
Crie componentes de painel personalizados do zero para atender às suas necessidades comerciais específicas. Os widgets personalizados permitem que você crie visualizações exclusivas sem dados predefinidos.
![\[Adicione widgets de clientes no layout do Explorador de perfis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/custom-widgets-1.png)
## Componentes personalizados disponíveis
+ [Tabela](#table-widget)
+ [Par de chave/valor](#key-value-pair)
+ [Métrica de chave](#key-metric)
+ [Gráfico de rosca](#donut-chart)
## Criar widgets personalizados
**Cada widget personalizado pode ser configurado com:**
+ Fontes de dados personalizadas
+ Exibições personalizadas
+ Campos personalizados
+ Interações personalizadas com itens
## Tabela
O componente de tabela personalizada fornece opções de configuração flexíveis para exibição de dados em formato tabular, com recursos avançados para interação e organização.
### Recursos
1. **Configurações de coluna**
+ Defina cabeçalhos de colunas personalizados.
+ Especifique os dados para cada coluna.
+ Defina opções de formatação de dados.
+ Defina o posicionamento das colunas.
1. **Filtrando**
+ Filtre rapidamente os itens na tabela.
1. **Vinculando**
+ Links de recursos do Connect
+ Navegação perfeita para:
+ Segmentos
+ Atributos calculados
+ Abertura em uma nova guia.
+ **Links para URLs externos**
+ Converta o valor do item da linha no URLs que você pode escolher
+ Abertura em uma nova guia.
+ Gere links de forma dinâmica com base em dados de linha.
+ Links de visualização de gaveta
+ Abra informações detalhadas na gaveta lateral.
+ Visualize os detalhes completos do registro sem sair da página.
1. Organização de dados
+ Agrupamento
+ Agrupe linhas por nomes de campo específicos.
+ Configurações de grupo persistentes.
+ Classificação
+ Classifique por qualquer campo de coluna.
+ Organização em ordem crescente.
+ Configurações de classificação persistentes.
**Figura 1**
![\[Exemplo de edição de widget de tabela personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/table-features-1.png)
**Figura 2**
![\[Outro exemplo de edição de widget de tabela personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/table-features-2.png)
### Exemplo de configuração
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Header": "Table column header"
"Cell": {
"Content": {
"Props": {
"Variant": "Link",
"LinkOptions": {
"LinkType": "Drawer"
}
},
"Type": "TextContent",
"Children": ["string"]
}
},
}
]
}
}
```
## Par de chave/valor
O componente Par de chave/valor permite criar exibições organizadas de pontos de dados relacionados em um formato flexível e legível.
### Visão geral do
Crie exibições dinâmicas de dados ao definir relações personalizadas de chave/valor. Esse componente é particularmente útil para mostrar pares de atributos, como:
+ Detalhes de clientes
+ Informações da conta
### Recursos
1. **Opções de links interativos**
+ Links de recursos do Connect
+ Vinculação direta com recursos relacionados.
+ Navegação perfeita para:
+ Atributos calculados
+ Segmentos
+ Abertura em uma nova guia.
+ Links para URLs externos
+ Converta o valor do item no URLs que você pode escolher
+ Abertura em uma nova guia.
+ Links de visualização de gaveta
+ Abra informações detalhadas na gaveta lateral.
+ Visualize os detalhes completos sem sair da página.
1. Configuração de colunas.
+ Defina de 1 a 4 colunas de pares de chave/valor.
1. Organize os pares em agrupamentos lógicos.
**Figura 1**
![\[Exemplo de edição de widget de Par de chave/valor personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/key-value-pair-features-1.png)
**Figura 2**
![\[Outro exemplo de edição de widget de Par de chave/valor personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/key-value-pair-features-2.png)
### Exemplo de configuração
```
{
"Type": "KeyValuePair",
"Id": "UniqueId",
"Props": {
"Columns": 2,
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {
"FontWeight": "bold"
},
"Children": ["Profile id"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {},
"Children": ["[string]"]
}
}
}
]
}
}
```
**nota**
Esse componente ainda não é compatível com `ProfileObjects` no construtor de interface de usuário.
## Métrica de chave
O componente Key Metric permite que você exiba com destaque métricas comerciais críticas e estatísticas vitais em um formato de fácil digestão. KPIs
### Visão geral do
Crie exibições de métricas de alta visibilidade que destacam pontos de dados, tendências ou indicadores de status importantes. Esse componente é ideal para mostrar:
+ Indicadores de desempenho
+ Medições críticas
+ Resumos de status
+ Indicadores de tendência
### Recursos
1. **Exibição de texto grande**
1. **Formato de métricas**
1. **Opções de links interativos**
+ Links de recursos do Connect
+ Vinculação direta com recursos relacionados.
+ Navegação perfeita para:
+ Atributos calculados
+ Segmentos
+ Abertura em uma nova guia.
+ Links para URLs externos
+ Converta o valor do item no URLs que você pode escolher
+ Abertura em uma nova guia.
+ Links de visualização de gaveta
+ Abra informações detalhadas na gaveta lateral.
+ Visualize os detalhes completos sem sair da página.
1. **Organização do layout das métricas**
**Figura 1**
![\[Exemplo de edição de widget de Métrica de chave personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/key-metric-features-1.png)
**Figura 2**
![\[Outro exemplo de edição de widget de Métrica de chave personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/key-metric-features-2.png)
### Exemplo de configuração
```
{
"Type": "KeyMetrics",
"Props": {
"MetricDefinitions": [
{
"MetricLabel": "Total Revenue",
"MetricValue": {
"Content": {
"Type": "TextContent",
"Props": {
"Format": "USD",
"FontSize": "large",
"FontWeight": "bold"
},
"Children": ["[string]"]
}
},
"Columns": 1
}
]
}
}
```
**nota**
Esse componente ainda não é compatível com `ProfileObjects` no construtor de interface de usuário.
## Gráfico de rosca
O componente de gráfico de rosca permite a visualização da pontuação de sentimentos por meio de um gráfico circular.
### Visão geral do
Crie visualizações dinâmicas de sentimentos ao definir critérios de pontuação personalizados. Esse componente é particularmente útil para mostrar:
+ Métricas de sucesso
+ Taxas de sucesso
+ Avaliações de riscos
+ Indicadores de desempenho
### Recursos
1. Opções de análise de sentimentos
+ Sentimento positivo
+ Começa do zero
+ Monitora o sucesso com base em critérios:
+ Valores de pontos personalizados
+ Segmentos codificados por cores
+ Cinza para condições não atendidas
+ Mostra a porcentagem da taxa de sucesso
+ Sentimento negativo
+ Começa com o valor máximo
+ Rastreia as deduções:
+ Segmentos codificados por cores
+ Sistema de redução de pontos
+ Verde para o valor restante
+ Mostra a pontuação final
1. Nome do atributo calculado
1. Opções de operador
+ Igual a
+ Não é igual a
+ Maior que
+ Menor que
1. Condição de valor
1. Pontos atribuídos por condição
**Figura 1: exemplo de sentimento positivo**
![\[Exemplo de edição de widget de sentimento positivo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/donut-chart-features-1.png)
**Figura 2: exemplo de sentimento negativo**
![\[Exemplo de edição de widget de sentimento negativo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/donut-chart-features-2.png)
### Exemplo de configuração
```
{
"Type": "DonutChart",
"Props": {
"Variant": "PositiveSentiment",
"ConditionDefinitions": [
{
"Title": "Customer Satisfaction",
"Color": "#4CAF50",
"CalculatedAttribute": "satisfaction_score",
"Operator": "GREATER_THAN",
"ValueCondition": 8,
"Points": 10
}
]
}
}
```
**nota**
**No momento, os gráficos de rosca só oferecem suporte a atributos calculados como fonte de dados.**
**Todas as definições de condição devem incluir título, cor, atributo calculado, operador, condição de valor e valor de pontos.**
# Adicionar o Explorador de perfis ao espaço de trabalho de atendente
Por padrão, os usuários que têm as [permissões apropriadas do perfil de segurança](enabling-profile-explorer.md) podem visualizar o Profile Explorer no site do Amazon Connect administrador. Você também pode querer que os atendentes tenham acesso ao Explorador de perfis em seu respectivo espaço de trabalho de atendente. Este tópico explica como fazer isso.
A imagem a seguir mostra um exemplo do Explorador de perfis no espaço de trabalho de atendente.
![\[O espaço de trabalho de atendente e a guia Explorador de perfis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/profile-explorer-agent-workspace.png)
## Criar o layout do Explorador de perfis que você deseja compartilhar com os atendentes
Aqui está uma visão geral de alto nível:
1. Garanta que você tem as [permissões de perfil de segurança](enabling-profile-explorer.md) para criar um layout do Explorador de perfis.
1. Siga as instruções em [Começar a usar o Explorador de perfis do Amazon Connect Customer Profiles](getting-started-profile-explorer.md) para criar e salvar o layout que deseja compartilhar com os atendentes.
## Adicione o Profile Explorer ao Amazon Connect como uma integração
1. No console do Amazon Connect, no painel de navegação à esquerda, escolha **Integrações**, conforme mostrado na imagem a seguir.
![\[O console do Amazon Connect, o item do menu Integrações.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/integrations.png)
1. Na página **Integrações**, escolha **Adicionar integração**.
1. Na página **Adicionar integração**, preencha os seguintes campos na seção **Informações básicas**:
1. **Nome de exibição**: um nome fácil para a aplicação. **Esse nome é exibido para os atendentes na guia do espaço de trabalho de atendente**. Também é exibido nos perfis de segurança. Você pode voltar e alterar esse nome.
1. **Identificador de integração**: o nome oficial exclusivo da sua integração. Se você tiver apenas uma integração por URL de acesso, recomendamos usar a origem da URL de acesso. Não é possível alterar esse nome.
1. **Descrição (opcional)**: opcionalmente, você pode fornecer qualquer descrição para essa aplicação. Essa descrição não é exibida aos atendentes.
1. **Tipo de integração**: Escolha o **aplicativo padrão**.
1. **Escopo de contato**: escolha **Por contato**. Essa é uma configuração obrigatória para o suporte a chamadas recebidas.
1. **Tempo limite de inicialização**: o tempo máximo permitido, em milissegundos, para estabelecer uma conexão com o espaço de trabalho.
A imagem a seguir mostra a configuração desses campos. O tempo limite de inicialização é definido para 5 segundos.
![\[A seção Informações básicas, configurada para o Explorador de perfis no espaço de trabalho de atendente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/add-integration.png)
1. Na seção **Acessar**, preencha os seguintes campos:
1. **URL de acesso**: é o URL em que a aplicação está hospedada. O URL deve ser seguro, começando com https, a menos que seja um host local.
**Importante**
O URL deve conter `?_appLayoutMode=embedded`. Por exemplo:
`https://{CONNECT_INSTANCE}/customer-profiles/profile-explorer?_appLayoutMode=embedded`
Se você não incluir`?_appLayoutMode=embedded`, a navegação à esquerda do site do Amazon Connect administrador aparecerá no espaço de trabalho do agente.
Para obter mais detalhes sobre o que é permitido nesse campo, consulte [Integrações](3p-apps.md#onboard-3p-apps-how-to-integrate).
1. **Origens aprovadas - opcional**: lista de permissões URLs que deve ser permitida, se for diferente da URL de acesso. O URL deve ser seguro, começando com https, a menos que seja um host local.
1. A conclusão das próximas duas seções (**Permissões** e **Configuração de iframe**) é opcional e não é necessária para adicionar o Explorador de perfis ao espaço de trabalho de atendente. Para obter informações sobre essas seções, consulte [Integrações](3p-apps.md#onboard-3p-apps-how-to-integrate).
1. **Associação de instâncias**: escolha a instância que os atendentes estão usando.
Você pode conceder acesso a essa integração a qualquer instância dentro dessa região da conta.
1. Escolha **Adicionar integração**.
## Atribuir aos atendentes permissão para o novo perfil de segurança
Nesta etapa, você precisa atribuir permissões aos agentes para acessar a nova integração E visualizar a permissão para o Profile Explorer.
1. No site do Amazon Connect administrador, navegue até o perfil de segurança do **Agente**.
1. Na página **Editar perfil de segurança**, atribua as seguintes permissões:
+ **Customer Profiles** - **Explorador de perfis** - **Visualizar**
+ **Aplicativos do agente** - **nome da sua integração** - **Access**
A imagem a seguir mostra um exemplo de permissões adicionadas para uma nova integração chamada **Profile explorer**.
![\[Permissões do perfil de segurança para a nova integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/profile-explorer-securityperms.png)
## Pedir que os atendentes fixem a nova aplicação
Usando seu método de comunicação normal, peça aos atendentes que fixem a nova aplicação no espaço de trabalho de atendente. Isso permitirá que eles acessem o Explorador de perfis em todas as instâncias do espaço de trabalho.
+ No espaço de trabalho de atendente, escolha o ícone Mais e selecione **Fixar guia**, conforme mostrado na imagem a seguir.
![\[O espaço de trabalho de atendente com a opção Fixar guia.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/pin-tab.png)
## Funções compatíveis
Depois de concluir as etapas acima, o Explorador de perfis oferecerá suporte a pesquisas nos contatos recebidos. As seguintes são compatíveis:
+ Telefone e chat: suporte completo
+ Atributos de contato personalizados: suporte total a atributos definidos pelo usuário que o Explorador de perfis lê. Você pode configurar atributos definidos pelo usuário em um fluxo para oferecer suporte a qualquer caso de uso do cliente. Por exemplo:
```
{
"profileSearchKey": "_phone",
"profileSearchValue": "" }
```
Para obter mais informações, consulte [Preencher automaticamente os perfis de clientes](auto-pop-customer-profile.md).
# Insights preditivos (versão prévia)
O *Predictive Insights* (Preview) é um recurso do Amazon Connect Customer Profiles que usa inteligência artificial para gerar recomendações personalizadas de produtos e conteúdos para seus clientes. Ao analisar os dados de interação com o cliente, o Predictive Insights ajuda você a fornecer experiências mais relevantes em todos os pontos de contato com o cliente.
## Como funciona o Predictive Insights
O Predictive Insights (versão prévia) usa modelos de IA para analisar os padrões de comportamento do cliente e gerar recomendações em tempo real. O serviço processa seus dados de interação com o cliente, como histórico de compras e atividade de navegação, para identificar padrões e preferências.
+ **Etapa 1:** adicione dados de interação aos perfis usando conectores de dados existentes para treinar modelos de IA com seus dados de interação com o cliente
+ **Etapa 2:** Adicione o catálogo de itens ao S3 para permitir que os perfis de clientes acessem seus dados de itens por meio do Console de gerenciamento da AWS
+ **Etapa 3:** Crie recomendações definindo tipos de recomendação (itens semelhantes, itens frequentemente emparelhados, itens populares)
+ **Etapa 4:** aplicar recomendações em todo o ecossistema Amazon Connect, incluindo agentes Agent Workspace, Flows e Connect AI
## Pré-requisitos
+ **Ativar armazenamento de dados em perfis de clientes**
Para treinar modelos de IA usando seus perfis de cliente, você precisa ativar o armazenamento de dados. Veja os detalhes em Armazenamento de dados do perfil do cliente para saber mais.
+ **KMS**
Você configurou os Perfis de Cliente para criptografar seus dados sob um AWS KMS key.
+ **Perfis de segurança**
Você configurou os Perfis de Segurança para suportar as permissões Exibir (listar e visualizar insights preditivos), Criar (criar recomendações), Excluir (excluir recomendações) e Editar (atualizar recomendações) com os Insights preditivos ativados.
## Benefícios do uso do Predictive Insights
O uso do Predictive Insights oferece vários benefícios importantes:
+ Melhore a experiência do cliente com recomendações personalizadas
+ Aumente as oportunidades de vendas por meio de sugestões de produtos relevantes
+ Economize tempo do agente exibindo automaticamente recomendações relevantes
+ Forneça recomendações consistentes em todos os pontos de contato com o cliente
+ Atualize as sugestões em tempo real à medida que o comportamento do cliente muda
# Comece a usar o Predictive Insights
Para começar a usar o Predictive Insights, siga estas etapas:
**Topics**
+ [
## Etapa 1: Adicionar dados de interação aos perfis de clientes
](#add-interaction-data)
+ [
## Etapa 2: Adicionar dados do catálogo de itens
](#add-item-catalog-data)
+ [
## Etapa 3: Criação de insights preditivos
](#create-predictive-insights)
+ [
## Etapa 4: Usando insights preditivos em todos os canais de engajamento do cliente
](#use-across-customer-engagement-channels)
## Etapa 1: Adicionar dados de interação aos perfis de clientes
Você pode aproveitar os conectores de dados existentes nos Perfis de clientes para mapear dados de interações em um objeto padrão do Web Analytics.
Para obter mais informações, consulte [Mapeamento de tipos de objetos para objetos do Web Analytics](standard-loyalty-promotion-object-mapping-web-analytics.md).
## Etapa 2: Adicionar dados do catálogo de itens
Você pode representar produtos individuais em seu catálogo dentro do domínio usando dados do Catálogo Padrão. Esses dados do catálogo existem no nível do domínio e não estão vinculados a nenhum perfil de cliente específico. Ele serve como uma representação estruturada de seus produtos que pode ser aproveitada para recursos de personalização. Você pode importar as informações do seu produto ou item como objetos de domínio nos Perfis de clientes usando conectores de dados que fornecem opções flexíveis para ingerir e manter as informações do catálogo, garantindo que os dados do produto permaneçam atualizados e acessíveis no sistema.
Para obter mais informações, consulte [Mapeamento de tipo de objeto para o catálogo de itens](standard-loyalty-promotion-object-mapping-item-catalog.md).
## Etapa 3: Criação de insights preditivos
O Amazon Connect permite que você crie e implante modelos especializados de IA adaptados às suas necessidades específicas de recomendação de produtos. Esses modelos podem ser configurados por meio da interface do usuário do Connect Web ou programaticamente APIs para corresponder aos seus cenários comerciais exclusivos. O Predictive Insights oferece vários tipos de recomendações:
1. **Recomendado para você** - fornece recomendações personalizadas para um usuário específico. As recomendações são baseadas no comportamento anterior do usuário, como eventos de sequência de cliques, eventos de compra, conteúdo consumido e assim por diante.
1. **Itens semelhantes** - usa IA generativa para encontrar itens que são tematicamente semelhantes a um item existente no catálogo. É ideal para casos de uso de venda adicional ou substituição em que os clientes desejam fornecer recomendações alternativas de itens para seus usuários.
1. **Itens frequentemente emparelhados** - recomenda itens que frequentemente interagem com um item existente no catálogo. É ideal para casos de uso de venda cruzada ou recomendação de itens complementares.
1. **Itens populares** - projetados para recomendar os itens com os quais os usuários mais interagem.
1. **Tendências atuais** - recomenda itens com o maior aumento na velocidade de engajamento em um período recente. Ele foi projetado para revelar itens que estão experimentando viralidade nas interações do usuário.
**nota**
A ativação de modelos de IA com o Predictive Insights está disponível em versão prévia. Preços adicionais podem ser aplicados no futuro.
**Limites de itens por tipo de recomendação**
A tabela a seguir descreve o número máximo de itens considerados para geração de recomendações, dependendo do tipo de recomendação usado.
| **Tipo de recomendação** | **Descrição** | **Limite** |
| --- | --- | --- |
| Recomendados para você | Número máximo de itens considerados para insights preditivos | 40 milhões |
| Itens similares | Número máximo de itens considerados para insights preditivos | 10 milhões |
| Todos os outros cenários de negócios | Número máximo de itens considerados para insights preditivos | 750.000 |
## Etapa 4: Usando insights preditivos em todos os canais de engajamento do cliente
### Usando recomendações de perfil de cliente no Connect Flows
Esta seção descreve como você pode usar o bloco de fluxo Customer Profiles Get profile recommendations para enriquecer a experiência do usuário durante um contato, gerando recomendações baseadas em IA para um perfil em tempo real.
**Propriedades do bloco de fluxo**
O bloco de fluxo **Obter recomendações de perfil** tem as seguintes propriedades para configurar:
1. **ID do perfil (obrigatório):**
É necessário um ID de perfil para que esse bloco funcione. O bloco de fluxo **Obter recomendações de perfil** gera recomendações para o ID do perfil fornecido aqui. Você tem a opção de inserir manualmente o ID do perfil ou usar um valor predefinido armazenado em um atributo. Se estiver usando um valor predefinido, certifique-se de fornecer o ID do perfil usando um bloco anterior **Obter perfil**. Use o bloco **Obter perfil** para identificar o perfil específico antes de prosseguir para gerar recomendações no bloco subsequente.
1. **Nome do recomendador (obrigatório):**
É necessário um nome de recomendação para que esse bloco funcione. Esse é o nome do recomendador que você deseja usar para gerar recomendações para o ID de perfil fornecido. Você só pode usar recomendadores ativos para gerar recomendações.
1. **Máximo de resultados (obrigatório):**
O número máximo de recomendações a serem geradas para o ID de perfil fornecido. Isso pode variar de 1 a 3 recomendações.
1. **Atributos de recomendação (obrigatório):**
Defina quais atributos da resposta das recomendações devem persistir no atributo de contato.
1. **ID do item:**
Essa é a ID do item fornecida como contexto adicional para gerar recomendações para a ID de perfil fornecida. A ID do item só é necessária ao usar um tipo de recomendador “*Itens semelhantes”* ou “*Itens frequentemente emparelhados”.* Você tem a opção de inserir manualmente o ID do perfil ou usar um valor predefinido armazenado em um atributo. Se estiver usando um valor predefinido, certifique-se de fornecer a ID do item usando um bloco anterior **Obter atributos calculados**. Use o bloco **Obter atributos calculados** para identificar a ID específica do item antes de prosseguir para gerar recomendações no bloco subsequente.
**Ramificações do bloco de fluxo**
O bloco de fluxo **Obter recomendações de perfil** pode rotear contatos pelas seguintes ramificações:
1. **Sucesso:**
As recomendações foram geradas com sucesso para o ID de perfil fornecido. Os atributos de recomendação selecionados persistiram até o atributo de contato \$1.Customer.Recommendations.
1. Erro:
Foi encontrado um erro ao tentar gerar recomendações. Isso pode ser devido a um erro do sistema ou à configuração do bloco **Obter recomendações de perfil**.
1. **Nenhum encontrado:**
Nenhuma recomendação pôde ser gerada.
**Usando as recomendações do bloco**
A resposta das recomendações persiste no atributo de contato \$1.Customer.Recommendations JSONPath como uma lista JSON de objetos de recomendação. Cada objeto de recomendação conterá os **atributos de recomendação** selecionados.
O exemplo de trecho de código Python a seguir de uma função Lambda mostra como ele pode ser usado para transformar recomendações do bloco **Obter recomendações de perfil e persistir em outros atributos de contato, de forma que as recomendações** possam ser usadas em blocos subsequentes.
```
import boto3
import json
# Handle lambda request
def lambda_handler(event, context):
print("Contact flow data: ", event)
# Transform recommendations
recommendations = event['Details']['Parameters']['Recommendations']
contact_attributes = {}
for i, rec in enumerate(recommendations):
contact_attributes.update(flatten(rec, i))
# Set contact attributes using each recommendation attribute value
print("Setting contact attributes: ", contact_attributes)
try:
client = boto3.client('connect', region_name="us-west-2")
client.update_contact_attributes(
InstanceId=event['Details']['ContactData']['InstanceARN'].rsplit('/', 1)[1],
InitialContactId=event['Details']['ContactData']['InitialContactId'],
Attributes=contact_attributes
)
print("Contact attributes set successfully.")
except Exception as e:
print("Error setting contact attributes: ", e)
# Success response
return {
'statusCode': 200,
'body': json.dumps('Success')
}
# Flatten a nested object into a simple string:string object
def flatten(recommendation, index):
flat = {}
for key, value in recommendation.items():
if isinstance(value, dict):
flat.update(flatten(value, index))
else:
flat[f"Rec{index}_{key}"] = str(value)
return flat
```
Depois de configurar seu fluxo com o bloco **Obter recomendações de perfil**, você pode começar a usá-lo para gerar recomendações para seus clientes durante seus contatos.
### Usando recomendações de perfil de cliente em campanhas externas
Você pode integrar o Predictive Insights às campanhas externas do Amazon Connect para oferecer recomendações personalizadas por meio de canais de e-mail e SMS. Ao criar uma campanha acionada por eventos, você pode configurar a seção Recomendações para gerar automaticamente recomendações baseadas em IA para perfis de clientes associados à campanha.
Essa integração usa o mapeamento de objetos do Web Analytics como a categoria do evento para capturar dados de interação com o cliente, o que permite que o mecanismo de recomendação forneça sugestões relevantes e direcionadas com base no comportamento do cliente.
Para step-by-step obter instruções sobre como configurar recomendações em campanhas acionadas por eventos, consulte. [Criar uma campanha externa usando gatilhos de eventos](how-to-create-campaigns-using-event-triggers.md)
### Configurando os agentes Connect AI para recomendações de vendas
O Amazon Q in Connect aprimora os recursos dos agentes por meio de seu novo tipo de agente de “orquestração”. Essa funcionalidade é particularmente valiosa para criar um agente de IA de vendas que possa fornecer recomendações de itens, especialmente útil em cenários de vendas adicionais e cruzadas.
**Conceitos Básicos**
Para começar a implementação, acesse Console de gerenciamento da AWS e navegue até o Amazon Connect. Depois de fazer login na sua instância do Connect por meio do URL de acesso, localize o Amazon Q no menu do lado esquerdo e selecione agentes de IA. Você encontrará um agente de IA pré-configurado do tipo orquestração (SalesAgent) em status de rascunho na página QiC em Agentes de IA. Este modelo vem equipado com todas as configurações necessárias para ferramentas 1P e exemplos de instruções para recomendações.
**Criando seu agente personalizado**
Para criar um agente de vendas personalizado, comece criando um novo agente de IA do tipo orquestração e copie do modelo existente SalesAgent . Esse processo transfere todas as ferramentas e configurações do modelo para seu novo agente.
**Personalizando o agente**
Quando se trata de atualizar o prompt do agente, os administradores têm duas opções principais. Eles podem anexar sua solicitação de agente existente à solicitação do agente de vendas e adicionar instruções de identificação de venda adicional, ou podem começar do zero removendo a SalesAgent solicitação e criando uma nova solicitação de orquestração com base no agente publicado atualmente e adicionando a solicitação do agente de vendas a ela. Essa flexibilidade permite soluções personalizadas que atendem às necessidades específicas dos negócios e aos requisitos do domínio.
**Configuração e integração de fluxo**
Depois de finalizar a configuração do agente e publicá-la, a próxima etapa envolve a criação de um bot Amazon Lex em Flows. O fluxo de entrada precisa ser atualizado para incluir o GetCustomerInput bloco com o bot Lex criado, e o novo SalesAgent deve ser selecionado em opções adicionais. Você precisará adicionar o bloco de fluxo do Perfil do Cliente para recuperação da ID do perfil e o bloco de fluxo Set-Contact Attributes, configurado CustomerId como chave para o ID do perfil e o valor como \$1Customer. ProfileId.
A implementação suporta contatos de bate-papo e chamadas de voz, com a entrada do cliente passando perfeitamente para o agente QIC no bot Lex. Essa configuração abrangente permite recomendações de vendas orientadas por IA e oportunidades de vendas adicionais em seu ambiente Amazon Connect. A flexibilidade do sistema permite a personalização com base nas necessidades específicas do setor, mantendo a funcionalidade principal da assistência inteligente de vendas. Essa solução fornece uma estrutura para aprimorar as interações com os clientes com recomendações baseadas em IA, apoiando, em última análise, operações de vendas e atendimento ao cliente mais eficazes. Os administradores podem refinar ainda mais a implementação adicionando instruções específicas do domínio e personalizando os tipos de recomendação para atender às necessidades de seus negócios.
### Configuração SalesAgent para ser usada para assistência ao agente
Você pode configurar o SalesAgent para ser usado no widget de bate-papo Q in connect no Agent Workspace. Para fazer isso, você precisa modificar duas coisas principais.
1. Atualize o AIAgent prompt com instruções para acessar a transcrição do contato.
1. Abra o prompt associado ao SalesAgent editor de Prompt e atualize o prompt para adicionar instruções para acessar a transcrição do contato, acessível por ` {{$.transcript}} `
1. Abaixo está um exemplo de solicitação que você pode anexar à SalesAgent solicitação.
```
**IMPORTANT**
**Guide on how to process requests and information:**
- The messages section contains YOUR conversation with the customer service agent
- Respond to the agent's questions/requests in the messages section
- The transcript below is background information about the agent's conversation with their customer
- Do not respond directly to the customer - you are helping the AGENT
Background context from agent-customer conversation.
The following transcript is for your information ONLY. Do not directly respond to messages in this conversation, but instead look at the messages section for what the agent requests you to do.
IF YOU REFERENCE ANY INFORMATION FROM THIS SECTION: You should indicate so by saying "According to your conversation with the customer ..."
{{$.transcript}}
```
1. Atualize o AIAgent com a nova versão do prompt e atualize o caso de uso da Configuração padrão → Assistência do agente com este agente.
**nota**
É recomendável ter dois casos de uso diferentes de Sales AIAGent for Self Service e Agent Assistance, pois ambos exigem pequenas modificações na solicitação. E isso pode ser feito clonando o agente e simplesmente alterando a versão do prompt e atualizando a configuração padrão para apontar para os agentes de IA corretos para o respectivo caso de uso.
1. Atualize o fluxo de entrada do contato.
1. Remova o GetCustomerInput bloco e, em vez disso, adicione o bloco de fluxo do Connect Assistant
1. Preencha a configuração do bloco de fluxo com o AIAssistant ARN e selecione o apropriado. AIAGent
Agora você pode usar esse fluxo como sua entrada normal e o widget de bate-papo Q in connect deve ser capaz de fornecer recomendações para ajudar na solicitação do usuário.
## Considerações sobre dados
As seções a seguir fornecem orientação sobre como combinar casos de uso e avaliar a prontidão dos dados para o Predictive Insights.
### Você combinou seus casos de uso com o Predictive Insights?
Os tipos de personalização do Predictive Insights podem abordar os seguintes casos de uso:
+ Como gerar recomendações personalizadas para um usuário
+ Recomendação de itens similares ou relacionados
+ Recomendação de itens populares ou com tendência alta
+ Reordenando itens por relevância
### Você tem dados de interações com itens suficientes?
Para todos os casos de uso e tipos de personalização, você deve ter no mínimo 1.000 interações de itens para 25 usuários exclusivos com pelo menos duas interações cada. Para obter recomendações de qualidade, o ideal é que você tenha, no mínimo, cinquenta mil interações com itens de, pelo menos, mil usuários com duas ou mais interações com itens cada.
### Você tem uma arquitetura de streaming de eventos em tempo real?
Se você puder transmitir eventos em tempo real para o Connect Customer Profiles, poderá aproveitar a personalização em tempo real. Com alguns tipos de personalização, o Predictive Insights pode aprender com a atividade mais recente do usuário e atualizar as recomendações à medida que ele usa seu aplicativo.
### Seus dados estão otimizados para o Predictive Insights?
Recomendamos que você verifique o seguinte nos seus dados:
+ Verifique se algo está faltando. Recomendamos que no mínimo 70% dos seus registros tenham dados de cada atributo. Recomendamos que as colunas que aceitem valores nulos estejam pelo menos 70% completas.
+ Corrija quaisquer imprecisões ou problemas em seus dados, como convenções de nomenclatura inconsistentes, categorias duplicadas para um item, incompatibilidade IDs entre conjuntos de dados ou duplicação. IDs Esses problemas podem afetar negativamente as recomendações ou causar um comportamento inesperado. Por exemplo, você pode ter os dois “N/A” and “Not Applicable” in your data, but filter out recommendations based on only “N/A”. Os itens marcados como “Não aplicável” não seriam barrados pelo filtro.
+ Se um item ou uma ação puder ter várias categorias, como um filme com vários gêneros, combine os valores de categoria em um único atributo e separe cada valor com o operador \$1. Por exemplo, os dados de GÊNEROS de um filme podem ser Ação \$1 Aventura \$1 Suspense.
+ Evite ter mais de 1.000 categorias possíveis para uma coluna (a menos que a coluna contenha dados apenas para filtragem).
# Usar a API do Amazon Connect Customer Profiles
Para obter informações sobre como gerenciar programaticamente domínios e perfis, consulte a [Referência de API do Amazon Connect Customer Profiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ListObjectTypeAttributeValues API
A ListObjectTypeAttributeValues API fornece acesso aos valores distintos mais recentes para qualquer atributo especificado, tornando-a valiosa para validação de dados em tempo real e verificações de consistência em seus tipos de objetos. Essa API funciona em vários domínios, oferecendo suporte a tipos de objetos personalizados e padrão. A API aceita o nome do tipo de objeto, o nome do atributo e o nome do domínio como parâmetros de entrada e retorna valores até o limite de armazenamento de aproximadamente 350 KB.
**Observação:**
+ Armazenamos até 350 KB de valores de atributos por campo, priorizando primeiro os valores mais recentes. Quando esse limite for atingido, os valores mais antigos serão removidos automaticamente para abrir espaço para novas entradas.
## GetObjectTypeAttributeValues API
A GetObjectTypeAttributeValues API fornece informações estatísticas sobre atributos dentro de um tipo de objeto específico, mas está disponível exclusivamente para domínios com armazenamento de dados ativado. Essa API realiza cálculos diários para fornecer informações estatísticas sobre seus valores de atributos, ajudando você a entender padrões e tendências em seus dados. Os cálculos estatísticos são realizados uma vez por dia, fornecendo uma visão geral consistente das características dos seus dados de atributos.
**Observação:**
+ Você receberá valores nulos em dois cenários:
+ Durante o primeiro período após a ativação do data vault (a menos que ocorra um ciclo de cálculo, que acontece uma vez por dia).
+ Para atributos que não contêm valores numéricos.
Recomendamos usar a biblioteca de código aberto CustomerProfile JS ao integrar perfis de clientes em seu próprio aplicativo de agente. Para obter mais informações, consulte o repositório CustomerProfiles JS no [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles).
Para obter mais informações sobre como integrar as aplicações existentes com o Amazon Connect, use o [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams). Você pode incorporar os componentes do Painel de controle do contato (CCP) em seu aplicativo.
# Entendendo IPv6 o suporte nos perfis de clientes do Amazon Connect
## Conectividade pública
Todos os perfis de clientes do Amazon Connect oferecem suporte APIs total IPv4 e IPv6 ligações.
```
profile.Region.api.aws
```
**Por exemplo**:
```
profile.us-east-1.api.aws
```
Para a AWS CLI, você precisará usar esses endpoints explicitamente:
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
Os antigos ainda APIs estão disponíveis como compatibilidade com versões anteriores. Eles só suportam IPv4 chamadas.
```
profile.Region.amazonaws.com
```
**Por exemplo**:
```
profile.us-east-1.amazonaws.com
```
## Conectividade privada
É possível criar um endpoint da VPC para o Amazon Connect Customer Profiles usando o console do Amazon VPC ou a AWS Command Line Interface (AWS CLI). Para obter mais informações, consulte [Criação de um endpoint de interface](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) no PrivateLink Guia da AWS.
Crie um endpoint da VPC para o Amazon Connect Customer Profiles usando o seguinte nome de serviço:
```
com.amazonaws.Region.profile
```
**Por exemplo**:
```
com.amazonaws.us-east-1.profile
```
Se você habilitar o DNS privado para o endpoint, poderá fazer solicitações de API aos perfis de clientes do Amazon Connect usando seu nome DNS IPv4 e o nome DNS IPv6 suportado para a região, por exemplo, profile.us-east-1.api.aws.
Como alternativa, o nome DNS antigo da região também é suportado IPv4 apenas como.
**Por exemplo**:
```
profile.us-east-1.amazonaws.com
```
# Exemplo: Integrar programaticamente o S3 ao Amazon Connect Customer Profiles
Usando a [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API Customer Profiles, você pode criar programaticamente integrações para S3, Salesforce, Marketo e muito mais.
Neste tópico, mostramos como criar uma integração do S3 com um intervalo de sincronização de 15 minutos, o valor mínimo atualmente compatível.
## Etapa 1: Criar um arquivo JSON
Crie um arquivo JSON com o seguinte conteúdo:
```
{
"DomainName": "your-domain",
"ObjectTypeName": "your-object-name",
"FlowDefinition": {
"FlowName": "your-flow-name",
"KmsArn": "the key ARN is the same as your domain's key",
"Description": "Created by Customer Profiles",
"TriggerConfig": {
"TriggerType": "Scheduled",
"TriggerProperties": {
"Scheduled": {
"ScheduleExpression": "rate(15minutes)",
"DataPullMode": "Incremental",
"ScheduleStartTime": 1634244800.435,
"FirstExecutionFrom": 1594166400
}
}
},
"SourceFlowConfig": {
"ConnectorType":"S3",
"SourceConnectorProperties": {
"S3": {
"BucketName": "your-bucket",
"BucketPrefix": "your-prefix"
}
}
},
"Tasks": [
{"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
]
}
}
```
Para personalizar o JSON com seus próprios valores, siga estas diretrizes:
+ `FlowName`: pode ser STRING [a-zA-Z0-9][\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime`: defina como `DateTime` atual \$1 5 minutos no horário da época.
+ `FirstExecutionFrom`: vá para o S3, veja a data do arquivo e use uma data anterior à data mais antiga.
+ `Tasks`: defina `TaskType`. No campo `Sourcefields`, você deve fornecer TODAS as colunas que tem em seu CSV nessa matriz. Em seguida, para cada um dos itens dessa matriz, você precisa especificar `ConnectorOperator`. Este exemplo é para um documento CSV com duas colunas: `colA` e `colB`.
## Etapa 2: chame a PutIntegration API
Depois de criar e personalizar o arquivo JSON com seus valores, chame a [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API, conforme mostrado no exemplo a seguir:
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
A resposta de `PutIntegration` retorna um URI de fluxo. Por exemplo:
```
{
"DomainName": "testDomain",
"Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
"ObjectTypeName": "your objec type",
"CreatedAt": "2021-10-14T13:51:57.748000-07:00",
"LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
"Tags": {}
}
```
## Etapa 3: chame a AppFlow StartFlow API da Amazon
Use o URI de fluxo para chamar a AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)API da Amazon. Por exemplo:
```
aws appflow start-flow —flow-name uri --region us-west-2
```