Ótimo passo a passo, principalmente o detalhe do express.raw() antes do parser global. Duas coisas que costumam aparecer depois que o webhook já está em produção:
-
A assinatura não tem timestamp. Um POST válido capturado continua válido para sempre, e a própria Meta reenvia a entrega quando não recebe o 200 a tempo. O HMAC garante a origem, mas não garante "uma vez só". Antes de disparar a ação, deduplique pelo
messages[].id(o wamid) e pelos ids destatuses: uma chave única no banco já resolve. -
200 +
setImmediateperde evento em deploy ou crash. Se o processo reinicia entre a resposta e o processamento, a Meta considera entregue e você nunca viu a mensagem. Gravar o corpo cru numa tabela ou fila antes do 200 e processar de lá resolve, e ainda deixa um histórico para reprocessar quando algo der errado.
Vocês fazem essa deduplicação no OmniPlug ou deixam para o sistema do cliente?