Webhook
Webhook é o sistema avisar quando algo acontece, em vez de alguém perguntar de tempos em tempos. Inverte a direção da integração: o fornecedor chama o seu endereço no momento do evento, e não o contrário.
A alternativa ao webhook é a consulta periódica: um processo que pergunta ao sistema, de cinco em cinco minutos, se algo mudou. Funciona, e desperdiça. A maioria das perguntas recebe "nada novo" como resposta, e mesmo assim o dado chega com até cinco minutos de atraso.
Com webhook o evento chega no instante em que acontece, e só quando acontece. O custo operacional cai e o dado fica atual.
A contrapartida é que o seu lado precisa estar de pé para receber. Se o endereço estiver fora do ar no momento do envio, a notificação se perde, a menos que o fornecedor tenha política de reenvio. Verificar isso antes é o que separa integração confiável de integração que perde evento em silêncio.
Também exige validar quem está chamando. O endereço fica aberto na internet, então precisa de assinatura ou segredo compartilhado, senão qualquer um pode enviar eventos falsos para o seu sistema.
Quando se aplica
- O dado precisa chegar no momento do evento, e não com minutos de atraso.
- A consulta periódica hoje devolve "nada novo" na maior parte das vezes.
- O fornecedor oferece reenvio automático quando a entrega falha.
- Existe onde registrar o que chegou, para reprocessar o que der errado.
Quando não se aplica
- O fornecedor não reenvia em caso de falha, e perder um evento tem custo alto.
- O volume é baixo e a latência não importa. Consulta periódica é mais simples de operar.
- Não há como expor um endereço público de forma segura.
Recebimento de evento com registro, validação de origem e reprocessamento.
Termos relacionados
Integração que perde evento em silêncio é pior que integração nenhuma.
O diagnóstico verifica o que os seus fornecedores oferecem e o que falta para a entrega ser confiável.
Agendar diagnóstico