Webhook

Definição

Webhook é um mecanismo de notificação no qual um sistema faz uma chamada a um endereço configurado quando ocorre um evento. O emissor identifica a ocorrência e entrega a mensagem ao endereço que o receptor preparou. A chamada acontece no momento do evento, e por isso a notificação chega sem exigir que o fluxo pergunte.

Emissor, evento e endereço

O webhook junta três partes que se conectam. O emissor reconhece o evento e envia a chamada, e o evento é a ocorrência comunicada com as informações que a descrevem. No fim, o endereço configurado recebe a mensagem e dá início ao processamento no fluxo, e cada uma das partes tem um papel próprio no mecanismo.

{
"evento": "payment.updated",
"pedidoId": "ped-1042",
"situacao": "aprovado"
}

Repetição e validação

Receber um webhook não garante processamento único. O emissor pode reenviar a mesma chamada, e a repetição precisa ser tratada. A validação da origem, com assinatura ou segredo, impede que chamadas falsas sejam aceitas, e a deduplicação evita que o reenvio gere um segundo efeito.

Chamada repetida e verificação

A falha comum é processar o reenvio como um evento novo: o emissor repete a chamada por instabilidade, e o fluxo executa o efeito duas vezes. Para verificar, confira o identificador do evento e a validade da assinatura em cada chamada recebida. Quando duas chamadas com o mesmo identificador geram dois efeitos, falta a deduplicação, e a comparação entre o conteúdo do payload e o histórico de chamadas mostra se a repetição foi reconhecida.

Aplicação na formação

n8n Experts

Na formação n8n Experts, webhooks entregam eventos ao fluxo e exigem validação de origem e tratamento de repetição.

Conhecer a formação →