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.