Webhook
Um webhook é uma chamada HTTP automatizada que envia dados para outro sistema no exato momento em que um evento específico ocorre.
O que é um webhook?
Um webhook é uma chamada HTTP automatizada — normalmente um POST — que um sistema envia para uma URL acordada no exato momento em que um evento específico ocorre. O receptor nunca precisa ficar solicitando dados; a fonte envia (pushes) a informação por si mesma sempre que algo novo acontece. Essa é a principal diferença entre um webhook e uma REST API: uma API exige que você busque dados repetidamente (polling), enquanto um webhook entrega os dados por conta própria assim que o evento é disparado.
Por que um webhook é importante?
Em uma loja online, acontecem coisas constantemente às quais outros sistemas precisam reagir imediatamente: um pedido é criado, um pagamento é compensado, o estoque muda. Com os webhooks, você evita fazer varreduras (polling) na Shopify a cada minuto para notar isso — o próprio evento aciona a ação em tempo real. Isso torna as integrações com seu ERP, sistema de estoque, contabilidade ou e-mails transacionais mais rápidas e confiáveis, além de reduzir chamadas de API e atrasos desnecessários.
Casos de uso comuns
- Processamento de pedidos: envia novos pedidos para um ERP ou sistema de envio via
orders/create. - Estoque e produtos: sincroniza alterações com
products/updateouinventory_levels/update. - Limpeza de aplicativos: exclui dados de clientes quando um aplicativo é desinstalado via
app/uninstalled. - Notificações: dispara um e-mail, uma mensagem no Slack ou uma fatura quando um pagamento é concluído.
Perspectiva da Shopify
Na Shopify, você pode criar webhooks no painel de administração em Configurações → Notificações ou por meio da Admin API a partir de um aplicativo. O envio é um POST para o seu endpoint HTTPS — JSON por padrão, embora XML e canais como EventBridge e Pub/Sub também sejam suportados. Sempre verifique o cabeçalho X-Shopify-Hmac-Sha256 com a chave secreta do seu aplicativo (app secret) para saber se a chamada realmente veio da Shopify. Seu endpoint deve responder rapidamente com um status 2xx (normalmente 200); caso contrário, a Shopify tentará novamente por até 48 horas e depois removerá a assinatura.