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