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