1. Criar o webhook de encomenda
- Admin Shopify: Settings > Notifications > Webhooks.
- Crie um webhook Order payment, formato JSON, para:
https://serverside.datafirefly.com/v1/shopify/O-SEU-SITE-ID
substituindoO-SEU-SITE-IDpelo Site ID exato da página do seu site. - Recomendado: adicione também Refund creation para fazer chegar os reembolsos. Checkout creation e Cart creation só são úteis enquanto o pixel storefront não estiver colocado.
Escolha bem Order payment, nunca Order creation: este último dispara também para encomendas não pagas e provoca uma contagem em duplicado.
2. Colar o signing secret
- No fundo da página Webhooks, o Shopify mostra o signing secret: copie-o.
- Cole-o no campo « Shopify webhook signing secret » da página do seu site DataFirefly e guarde.
3. Colocar o pixel storefront
- Admin Shopify: Settings > Customer events > Add custom pixel.
- Cole o snippet fornecido no guia Shopify da sua área de cliente (página Modules).
- Com o pixel colocado, elimine os webhooks Checkout creation e Cart creation: o pixel substitui-os.
Verificar
- Faça uma encomenda de teste paga: deve aparecer como Delivered no Monitoring.
- O botão « Diagnose my connection » confirma a receção dos últimos eventos.
Em caso de problema
- Um webhook que falha durante cerca de 48 horas é eliminado automaticamente pelo Shopify. Se o webhook tiver desaparecido, verifique o Site ID no URL, recrie-o e vigie o Monitoring.
- Encomendas em duplicado? Verifique se não resta nenhum webhook Order creation.
- As restantes causas frequentes estão listadas no guia de resolução de problemas.
Atualizado: 1 de setembro de 2026