Webhook x consulta periódica (polling): qual escolher para NFS-e
· 6 min de leitura
Polling e webhook resolvem o mesmo problema (saber quando uma nota nova chegou) por caminhos opostos: no polling, você pergunta em intervalos; no webhook, o sistema monitorado avisa sozinho quando há algo novo.
Como funciona o polling
Polling é consultar em intervalos fixos (a cada minuto, a cada hora) perguntando se há algo novo, mesmo quando a resposta é “nada mudou” na maioria das vezes. Veja mais sobre essa mecânica de consulta em consulta em lote x consulta individual via API de NFS-e.
Como funciona o webhook
No modelo de webhook, não existe pergunta repetida: o sistema monitorado envia uma chamada exatamente quando há uma nota nova, e só nesse momento. Não há chamadas “em vão” perguntando por nada.
Custo e latência de cada um
Polling frequente reduz a latência (o atraso entre a nota chegar e você saber) às custas de mais chamadas desnecessárias; polling espaçado economiza chamadas mas aumenta a latência. O webhook resolve essa tensão: a notificação chega assim que o evento acontece, sem exigir escolher entre custo e velocidade.
Perguntas frequentes
É possível combinar webhook e polling na mesma rotina?
Sim, e é uma prática comum: webhook como canal principal para notificação em tempo real, e uma consulta periódica (bem mais espaçada) como rede de segurança, caso algum evento eventualmente não seja entregue.
O webhook é sempre melhor que o polling?
Para o caso de uso de “saber quando uma nota nova chegou”, sim, na maioria das situações. Polling ainda faz sentido quando não há capacidade de manter um endpoint disponível para receber chamadas, ou para reconciliações pontuais.
A IntegroBR NFS-e Recebidas oferece os dois caminhos (consulta via painel/API e webhook automático) para o período que você escolher monitorar, sem que você precise escolher um só de antemão.