Webhook

Webhook é o mecanismo pelo qual um sistema envia automaticamente uma notificação a outro quando determinado evento acontece, dispensando que o segundo fique consultando periodicamente.

Diferença para consulta periódica

Na consulta, um sistema pergunta ao outro de tempos em tempos se algo mudou. No webhook, o sistema de origem avisa no momento em que o evento ocorre.

É mais rápido e consome menos recursos dos dois lados.

Aplicações em oficina

Pagamento confirmado pelo meio de pagamento notifica o sistema de gestão, que baixa a conta automaticamente. Nota fiscal autorizada notifica o sistema, que anexa o documento à ordem de serviço.

Ganho prático

Elimina a conferência manual de recebimentos e a digitação de informações que já existem em outro sistema. É onde o tempo administrativo é efetivamente reduzido.

Confiabilidade

Notificação pode falhar se o sistema de destino estiver indisponível. Implementações bem feitas repetem o envio e mantêm registro do que foi entregue.

Segurança

Como o webhook é um endereço que recebe dados de fora, precisa validar a origem da notificação. Sem essa validação, qualquer um poderia enviar informação falsa.

Não é algo a configurar sozinho

Para o dono de oficina, o que importa é saber que a integração existe e funciona. A implementação é responsabilidade do fornecedor do sistema.

Direção da notificação

O webhook pode funcionar nos dois sentidos: o sistema de gestão também pode notificar outros serviços quando algo acontece na oficina — serviço concluído, orçamento aprovado.

Registro de entrega

Sistemas bem construídos mantêm histórico das notificações enviadas e recebidas. É esse registro que permite descobrir por que um pagamento não baixou automaticamente.

Pergunta útil na contratação

Se o sistema recebe confirmação automática dos meios de pagamento e do emissor de nota. A resposta indica quanto trabalho manual continuará existindo.