Webhooks: como automatizar ações a cada pedido da loja

Toda loja virtual tem um momento mágico: o pedido entra. E, logo depois, começa uma série de pequenas tarefas manuais. Alguém copia o pedido para a planilha da produção, outra pessoa avisa no grupo da equipe, o financeiro anota o recebimento, o sistema de etiquetas precisa saber do envio. Os webhooks existem para que tudo isso aconteça sozinho, no instante em que o pedido chega ou muda de situação.

Se a API é o balcão onde um sistema pergunta e a loja responde, o webhook é o contrário: é a loja tocando a campainha do seu sistema para dizer que algo aconteceu. Essa inversão parece detalhe, mas muda tudo em velocidade, em economia de recursos e em quantas tarefas você consegue tirar das mãos da equipe.

Neste artigo você vai entender como os webhooks funcionam, quais eventos importam para uma loja, ver receitas práticas de automação, conhecer os cuidados de segurança e confiabilidade e descobrir como configurar tudo isso no Hotel das Lojas.

Webhook em uma frase: a loja avisa, o seu sistema reage

Pense no interfone de um prédio. Em vez de você descer a cada cinco minutos para ver se a encomenda chegou, o porteiro interfona quando ela chega. Você economiza viagens e fica sabendo na hora.

Na loja virtual acontece igual. Sem webhook, o seu sistema precisa perguntar à API, de tempos em tempos, se existem pedidos novos. Com webhook, você cadastra um endereço na loja e, quando um evento acontece, a loja envia para esse endereço uma mensagem com os dados do evento. O seu sistema recebe, entende e age.

Os três elementos de qualquer webhook são:

• Evento: o que aconteceu, por exemplo um pedido criado, um pedido pago ou um pedido enviado.
• Endereço de destino: a URL do seu sistema que vai receber o aviso.
• Conteúdo: os dados enviados, normalmente em JSON, com a identificação do pedido e as informações relevantes.

Webhooks ou consultas periódicas pela API?

Os dois caminhos funcionam, mas têm usos diferentes. Veja a comparação:

Na prática, as melhores integrações usam os dois juntos: o webhook dispara a ação na hora, e uma consulta periódica pela API, por exemplo uma vez por dia, confere se nenhum evento se perdeu no caminho.

Um exemplo concreto: uma loja que recebe 60 pedidos por dia e consulta a API a cada cinco minutos faz quase 300 consultas diárias, e a maioria volta vazia. Com webhooks, são cerca de 60 avisos, cada um com um pedido de verdade, mais uma consulta de conferência no fim do dia. Menos tráfego, resposta mais rápida e uma integração bem mais fácil de acompanhar.

Os eventos que mais importam para uma loja

Cada plataforma tem a sua lista de eventos, e vale consultar a documentação para ver os nomes exatos. Para o lojista, eles se agrupam em quatro famílias.

Eventos de pedido

São os mais usados: pedido criado, pagamento aprovado, pedido cancelado, pedido enviado, pedido entregue. Quase toda automação começa aqui.

Eventos de produto e estoque

Produto criado ou alterado, estoque atualizado. Úteis para manter catálogos externos, comparadores ou o sistema da loja física em dia.

Eventos de cliente

Novo cadastro, dados alterados. Interessantes para alimentar ferramentas de relacionamento, sempre respeitando a LGPD e enviando só o necessário.

Eventos de pagamento

Mudanças de situação do pagamento, como aprovação ou estorno. Ajudam o financeiro a conciliar recebimentos sem conferir pedido por pedido.

Receitas de automação a cada pedido

Agora a parte prática. Estas receitas mostram como os webhooks resolvem tarefas reais de lojas brasileiras. Use como inspiração e adapte à sua operação.

Receita 1: produção sob encomenda

Uma confeitaria que vende bolos e kits de doces pela loja quer que a cozinha saiba de cada encomenda paga. O evento de pagamento aprovado dispara um aviso para um sistema simples, que grava o pedido em uma planilha de produção com data de entrega, sabores e observações. A confeiteira abre a planilha de manhã e já sabe o que produzir, sem ninguém copiar nada.

Receita 2: aviso para a equipe

Uma loja de acessórios com três pessoas quer saber na hora quando entra um pedido acima de um valor, por exemplo R$ 500, para dar prioridade na separação. O webhook de pedido pago passa por uma regra: se o valor passa do limite, uma mensagem vai para o canal interno da equipe.

Receita 3: integração com o sistema da loja física

Uma loja com ponto físico e loja virtual usa um sistema de caixa próprio. O evento de pedido pago dispara a baixa do mesmo item no estoque do sistema da loja física, evitando que o vendedor do balcão venda a peça que acabou de sair online.

Receita 4: financeiro sem digitação

O evento de pagamento aprovado lança a receita no sistema financeiro com data, valor, forma de pagamento e número do pedido. O evento de cancelamento estorna o lançamento. No fim do mês, a conciliação vira conferência, não digitação.

Receita 5: pós-venda personalizado

O evento de pedido entregue agenda, alguns dias depois, um contato pedindo a avaliação do produto ou oferecendo um item complementar. Aqui vale lembrar que o Hotel das Lojas já avisa o cliente por e-mail nas etapas do pedido; o webhook entra quando você quer algo além do padrão.

Receita 6: reposição com o fornecedor

Uma loja de cosméticos trabalha com um distribuidor que aceita pedidos de reposição por planilha compartilhada. O evento de estoque atualizado passa por uma regra simples: quando o saldo de um produto cai abaixo do estoque mínimo, por exemplo 5 unidades, a linha do item é marcada na planilha de reposição com a quantidade sugerida. Toda segunda-feira, a compradora só revisa a lista e envia ao fornecedor. Nada de descobrir que o batom mais vendido acabou porque alguém olhou o estoque tarde demais.

Repare que nenhuma dessas receitas exige um sistema gigante. Em quase todas, o destino do webhook é um serviço pequeno que recebe o aviso, aplica uma regra e grava ou envia uma informação. A complexidade está na regra de negócio, e é você quem melhor conhece essa regra.

Passo a passo para criar o seu primeiro webhook

1. Escolha uma única automação para começar, a que mais economiza tempo hoje.
2. Identifique o evento que deve disparar essa automação na lista de eventos da documentação.
3. Prepare o endereço de destino: um pequeno serviço do seu desenvolvedor ou uma ferramenta de automação que aceite webhooks, sempre com https.
4. Cadastre o webhook no painel, informando o evento e o endereço.
5. Implemente a verificação de assinatura, para ter certeza de que o aviso veio mesmo da sua loja.
6. Responda rápido: o destino deve confirmar o recebimento logo e processar a tarefa em seguida, sem deixar a loja esperando.
7. Teste com pedidos de teste e confira cada etapa.
8. Monitore por alguns dias, olhando os registros de recebimento e de erro.

Dica de especialista: trate cada webhook como se ele pudesse chegar duas vezes. Guarde a identificação dos eventos já processados e ignore repetições. Assim, um reenvio nunca gera nota em dobro nem baixa o estoque duas vezes.

Segurança e confiabilidade: o que não pode faltar

Webhook mal feito é porta aberta para problema. Estes cuidados são obrigatórios:

• Assinatura: a loja assina cada aviso com uma chave secreta; o seu sistema confere antes de agir. Sem isso, qualquer pessoa que descubra o endereço pode enviar pedidos falsos.
• Https sempre: os dados trafegam criptografados.
• Idempotência: processar o mesmo evento duas vezes não pode gerar efeito duplicado.
• Confirmação pela API: para ações sensíveis, como liberar um produto digital, consulte o pedido pela API antes de agir.
• Reconciliação diária: uma rotina que compara os pedidos do dia com o que foi processado e corrige diferenças.
• Dados mínimos: envie para ferramentas externas só o que elas precisam, especialmente dados pessoais de clientes.

Erros comuns com webhooks em lojas virtuais

Mesmo integrações simples tropeçam nos mesmos pontos:

• Destino que demora para responder e acaba recebendo reenvios.
• Endereço que muda e ninguém atualiza no painel.
• Automação que depende da ordem dos eventos, quando eles podem chegar fora de ordem.
• Nenhum alerta quando o destino sai do ar.
• Webhooks de teste esquecidos, apontando para endereços que não existem mais.

Uma revisão a cada trimestre, olhando todos os webhooks cadastrados, evita a maior parte desses problemas.

Como medir se as automações com webhooks estão valendo a pena

Automação sem medição vira enfeite. Antes de criar o primeiro webhook, anote como a tarefa é feita hoje e quanto tempo leva. Depois de duas ou três semanas, compare. Alguns indicadores simples ajudam:

• Tempo entre o pagamento e o início da separação: se o aviso para a equipe é imediato, esse tempo tende a cair.
• Horas de digitação por semana: quanto tempo a equipe deixou de gastar copiando pedidos para planilhas ou sistemas.
• Erros de digitação corrigidos: pedidos com endereço, quantidade ou valor errados no sistema interno.
• Falhas da integração: quantos eventos precisaram ser reprocessados pela reconciliação.

Um exemplo de conta: se a equipe gastava 40 minutos por dia copiando pedidos para a planilha da produção, são cerca de 15 horas por mês devolvidas para atendimento, fotos de produto ou prospecção de clientes. Esse número ajuda a decidir qual será a próxima automação e quanto vale investir nela.

Como o Hotel das Lojas trabalha com webhooks

O Hotel das Lojas oferece API REST e webhooks para que a sua loja converse com qualquer sistema. A documentação foi organizada para o desenvolvedor encontrar tudo rápido:

• A visão geral dos webhooks, com o funcionamento e as boas práticas.
• A lista de eventos disponíveis, com o conteúdo de cada um.
• A verificação da assinatura dos avisos, para garantir a origem.
• Scripts de teste para webhooks, que ajudam a validar o recebimento antes de ir para produção.

No painel, o tutorial de API e webhooks no Hotel das Lojas mostra onde cadastrar os endereços. E muita coisa já funciona sem integração nenhuma: os avisos de pagamento automáticos atualizam o pedido sozinho, o cliente recebe e-mails a cada etapa e a impressão automática dos pedidos coloca a comanda na mesa da produção.

Para quem trabalha com encomendas, como confeitarias e docerias, o tema Doceria deixa a vitrine com cara de confeitaria fina, e o aplicativo de delivery, balcão e mesa organiza as formas de entrega. Tudo com plano único de R$ 59,90 por mês, sem comissão sobre as vendas.

Conclusão: deixe o pedido trabalhar por você

Webhooks transformam cada pedido em um gatilho de ações automáticas: produção, financeiro, estoque da loja física, pós-venda. Comece com uma automação, cuide da assinatura e da idempotência, faça a reconciliação diária e amplie aos poucos.

Se você quer uma loja preparada para crescer com automação, crie sua loja no Hotel das Lojas com teste grátis de 7 dias, sem cartão de crédito. Configure os primeiros pedidos, chame o seu desenvolvedor para conhecer a documentação e veja a operação andar sozinha a cada venda.