

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

# Integrar aplicações externas ao Amazon Connect Customer Profiles
<a name="integrate-external-apps-customer-profiles"></a>

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
<a name="setup-integrations-title-menu"></a>

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
<a name="integrate-customer-profiles-appflow"></a>

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
<a name="before-you-begin-cp-integration"></a>

### Ingestão de dados em massa
<a name="bulk-ingestion"></a>

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?
<a name="why-create-iam-role"></a>

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
<a name="grant-least-privilege-cp"></a>

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
<a name="monitor-customer-profile-connection"></a>

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
<a name="fix-customer-profile-connection"></a>

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
<a name="set-up-integration-for-amazon-connect-cases"></a>

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
<a name="stream-data-from-connect-cases-to-event-bridge"></a>

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 <YOUR_CASES_DOMAIN_ID> --region <YOUR_AWS_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
<a name="ingest-event-bridge-case-data-to-customer-profiles-via-appintegrations"></a>

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
    <YOUR_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
    <YOUR_REGION> --domain-name <YOUR_CP_DOMAIN_NAME> 
    --uri <YOUR_EVENT_INTEGRATION_ARN> --object-type-name Connect-case
```

## Verificar a integração dos Chamados
<a name="verify-your-cases-integration"></a>

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
    <YOUR_CP_DOMAIN_NAME> --region <YOUR_REGION> 
    --object-type-name Connect-case --profile-id <YOUR_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
<a name="steps-integrate-cp-salesforce-servicenow"></a>

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
<a name="setup-connection-segment"></a>

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
<a name="integrate-customer-profiles-segment"></a>

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
<a name="setup-connection-segment"></a>

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
<a name="verify-customer-profile-segment-connection"></a>

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
<a name="monitor-customer-profile-connection-segment"></a>

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
<a name="fix-customer-profile-connection-segment"></a>

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
<a name="integrate-customer-profiles-shopify"></a>

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
<a name="setup-connection-shopify"></a>

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
<a name="shopify-webhook-subscriptions"></a>

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}&timestamp=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
<a name="verify-customer-profile-shopify-connection"></a>

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
<a name="monitor-customer-profile-connection-shopify"></a>

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
<a name="fix-customer-profile-connection-shopify"></a>

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
<a name="integrate-external-applications-appflow"></a>

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
<a name="integrate-ea-appflow-pre-req"></a>

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
<a name="integrate-ea-appflow-data-source"></a>

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
<a name="integrate-ea-appflow-mappings"></a>

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
<a name="integrate-ea-appflow-integ"></a>

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
<a name="integrate-ea-appflow-view"></a>

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
<a name="delete-customer-profile-connection"></a>

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