{> MARKSVB.DEV_}
Contato→
Falar no WhatsApp
> MARKSVB.DEV // FAST DELIVERY
Automação n8n

Webhooks no n8n: idempotência e reprocessamento

MB
Marcos Barbosa
Dev Fullstack & Especialista em Automação
Publicado ·Atualizado ·5 min de leitura
XinWA
HOOKn8nWA_APILATENCY < 8.0s
n8n // WORKFLOW_ENGINE1200×630 // ULTRA_PERF
WEBHOOKS & AUTOMATIONSYS_OK
# NESTE ARTIGO▼

Toda integração com webhooks deve presumir que eventos serão entregues pelo menos uma vez ('at-least-once delivery'). Se seu sistema não tratar isso, o cliente receberá notificações repetidas e o CRM ficará sujo.

Por que webhooks duplicam?

Serviços como Stripe, Typeform ou formulários web realizam retentativas automáticas quando a resposta HTTP 200 demora mais de alguns segundos. Se a rede do cliente oscilar no 4G, ele mesmo pode clicar várias vezes no botão de submit.

A Chave de Idempotência

Gere uma assinatura canônica com os dados determinísticos do evento: SHA256(email + telefone + timestamp_dia). Antes de executar qualquer ação externa (enviar WhatsApp ou criar contato), teste se a chave já existe no Redis ou PostgreSQL.

Implementação no n8n

Use um nó 'If' logo após o nó de banco. Se o registro inserido retornar uma linha com ID, continue o fluxo. Se retornar vazio (conflito detectado), responda HTTP 200 imediatamente para o emissor e termine a execução silenciosamente.

MB
Marcos Barbosa

Desenvolvedor Fullstack e especialista em automação. Constrói sites em Next.js e fluxos com n8n, CRM e IA. Credenciais verificadas por Google, NVIDIA, Microsoft, Atlassian e Meta.

Next.jsn8nPostgreSQL