Passar para o conteúdo principal
Todas as coleçõesConfigurações
Configurando a integração Shopify
Configurando a integração Shopify

Esse artigo descreve o passo a passo para realizar a configuração da sua loja Shopify dentro da plataforma da OmniChat

Michel Ferreira avatar
Escrito por Michel Ferreira
Atualizado há mais de uma semana

Introdução

Integrar a OmniChat com a Shopify permite que sua equipe de atendimento acesse e compartilhe o catálogo de produtos diretamente nas conversas com os clientes. Esta integração possibilita a consulta em tempo real de informações como preço, estoque, imagens dos produtos e suas variantes, sem a necessidade de sincronização de dados. Com essa funcionalidade, você pode consultar produtos, compartilhá-los durante o atendimento, criar pedidos com esses itens e finalizá-los utilizando o checkout da própria loja.

Adicionando uma nova integração

  • Acessar o Menu de Configuração

    • Na plataforma OmniChat, acesse o menu de configuração localizado na lateral esquerda da tela.

  • Selecionar Integrações

    • Dentro do menu de configurações, clique em "Integrações", e em seguida em "E-Commerce / ERP".

  • Adicionar Nova Integração

    • Na tela de integrações, selecione a opção "Nova Integração" e escolha Shopify para iniciar a configuração específica.

Configuração da Integração Shopify

Preencher os Campos de Configuração:

  • Nome

    • Insira o nome de exibição da integração. Este nome será utilizado internamente para identificar a integração na plataforma.

  • Times

    • Especifique se a integração será restrita a determinados times. Se nenhum time for especificado, a integração ficará disponível para todos os usuários. Se um ou mais times forem especificados, apenas os membros desses times terão acesso.

  • API Token

    • Este é o token de acesso obtido no app criado em sua loja Shopify, essencial para acessar as informações da sua loja por meio das APIs.

  • Storefront API token

    • Este é o token de acesso obtido no app criado em sua loja Shopify, essencial para acessar as informações da sua loja por meio das APIs.

  • Nome da Conta

    • Insira o nome de sua loja Shopify, conforme aparece no topo do menu de configurações em sua loja.

Salvar Configurações

Após preencher todos os campos necessários, clique em "Salvar". Isso permitirá a consulta em tempo real dos produtos de sua loja.

Criação e Configuração do App Shopify para API Token e Storefront

Criar um App no Shopify

  • Acesse o menu "Configurações" no Shopify e selecione "Apps e canais de vendas".

  • Clique em "Desenvolver apps" e em seguida "Criar um App".

  • Dê um nome ao app, por exemplo, "OmniChat", e clique em "Criar App".

Configurar Escopos da API Admin

  • Este token é necessário para podermos obter os pedidos para a funcionalidade de status de pedido, carrinhos abandonados, catalogo de produtos

  • Este token precisa possuir as permissões:

    • read_product_listings,

    • read_orders,

    • read_products

    • read_fulfillments

  • Na tela de detalhes do app, selecione "Configurar escopos da API Admin".
    Marque as permissões necessárias, salve as configurações.

Storefront API Token

  • Este token é utilizado para toda a operação desde a criação do carrinho até a geração do link de checkout.

  • Este token deve possuir as seguintes permissões:

    • unauthenticated_read_product_listings

    • unauthenticated_read_product_inventory

    • unauthenticated_read_product_pickup_locations

    • unauthenticated_read_product_tags

    • unauthenticated_read_bundles

    • unauthenticated_write_customers

    • unauthenticated_read_customers

    • unauthenticated_read_checkouts

    • unauthenticated_write_checkouts

    • unauthenticated_read_metaobjects

    • unauthenticated_read_selling_plans

    • unauthenticated_read_customer_tags

  • Na tela de detalhes do app, clique na aba configuração , na seção Integração de API Storefront, clique em "Configurar".

  • Marque as permissões necessárias, salve as configurações e instale o app.

Webhooks

Antes de configurar é necessário criar um usuário de api na OmniChat, pois a url de configuração do webhook precisamos passar o token de autorização da loja OmniChat.

  • Para criar acesse a aplicação OmniChat (OmniChat),

  • acesse o menu configurações → integrações → API, crie um usuário.

  • Ao criar o usuário, copie a chave secreta (Chave secreta (x-api-secret) algo parecido com isto: r:1234fjabcdasd7686686788dsadas, está chave precisará ser fornecida na url do webook logo abaixo.

Precisamos configurar o envio das notificações de atualizações de pedido para poder sincronizar o pedido entre OmniChat e Shopify.

Acesse o admin da sua loja Shopify e em configurações → notificações → webhooks , você verá uma tela parecida com está, clique em criar webhook.

No modal, preencha com as seguintes informações:
Evento: atualização de pedido
Formato: JSON
URL: https://shopify-api.omni.chat/v1/webhooks?Authorization={{sessionToken}}
Versão da api webhook: 2025-01

Obter o Token de Acesso

  • Após a instalação do app, vá para a aba "Credenciais da API" e clique em "Revelar token uma vez".

  • Copie o token exibido e insira-o no campo "Access Token" e "storefront" na configuração da Shopify dentro da plataforma OmniChat. Lembre-se, o token é exibido apenas uma vez.

Conclusão

Com estes passos concluídos, a integração entre OmniChat e Shopify estará pronta para ser utilizada. Você poderá consultar produtos diretamente nas conversas, compartilhar detalhes com clientes e criar pedidos diretamente na plataforma OmniChat. Aproveite para maximizar as vendas e a eficiência de seus vendedores.

Respondeu à sua pergunta?