Como conecto o Shopify para que os pedidos cheguem ao Decisa?
Abra Menu lateral → Integrações → Shopify, cole o domínio da sua loja e um token de acesso da Admin API do Shopify e clique em Conectar Shopify — o Decisa passa a puxar os pedidos toda noite e recupera qualquer checkout que nunca chegou por webhook.
Antes de começar
- Um workspace com o módulo de Atribuição ativo.
- A função de Admin no workspace — só administradores podem gerenciar a recuperação de pedidos.
- Acesso ao admin do Shopify, para criar um token de acesso da Admin API.
Passo a passo
Abra a integração do Shopify
Vá em Menu lateral → Integrações → Shopify. A página mostra um card chamado "Recuperar pedidos perdidos (Shopify)" com o formulário de conexão.
Crie um token de acesso no Shopify
No admin do Shopify, acesse Configurações → Apps e canais de venda → Desenvolver apps, crie um app com o escopo
read_orderse copie o token de acesso da Admin API (ele começa comshpat_).Conecte o Shopify
De volta ao Decisa, preencha "Domínio da loja" (por exemplo,
acme.myshopify.com) e "Token de acesso da Admin API", depois clique em "Conectar Shopify".Confirme a conexão
Você verá a confirmação "Shopify conectado. O Decisa vai recuperar os pedidos perdidos toda noite." O card então mostra "Ainda não sincronizado — a primeira coleta acontece hoje à noite."
O que acontece depois
- Toda noite, o Decisa puxa os pedidos recentes da sua loja e recupera qualquer checkout que nunca chegou até nós por webhook. Pedidos já rastreados nunca são contados em dobro.
- Depois da primeira coleta, o card mostra "Última sincronização" com o tempo decorrido, ao lado do domínio da loja.
- O card "Cobertura de webhooks", na mesma página, mostra se os webhooks de checkout recebidos nos últimos 14 dias viraram conversões, dividido por provedor — assim você enxerga o rastreamento ao vivo e a recuperação noturna lado a lado.
- Os pedidos recuperados aparecem junto com as suas conversões e entram no relatório de ROAS como qualquer outro pedido.
Armadilhas
O Shopify exibe o token de acesso da Admin API uma única vez, e o Decisa o armazena criptografado, sem exibi-lo novamente. Se você perdê-lo, não procure o valor antigo — gere um novo token no Shopify e use "Atualizar credenciais" no card da conexão para substituí-lo.
- O token precisa incluir o escopo
read_orders. Sem ele, a conexão é salva, mas a coleta noturna não consegue ler seus pedidos — recrie o token do app com o escopo correto e atualize as credenciais. - Uma taxa de 100% em "Cobertura de webhooks" não significa que todos os pedidos foram capturados — ela só conta os webhooks que de fato chegaram ao Decisa. Pedidos que nunca chegaram são exatamente o que a coleta noturna do Shopify recupera, então mantenha os dois conectados.
- A coleta acontece toda noite, não na hora. Se um pedido perdido não aparecer logo após conectar, verifique de novo na manhã seguinte.
- Clicar em "Desconectar" interrompe a coleta noturna. As conversões já capturadas permanecem, mas pedidos futuros que nunca chegarem não serão recuperados até você reconectar.