Webhook ou polling: as duas formas de saber que tem venda nova na consolidadora

Duas formas de descobrir que algo mudou

Quando um sistema precisa saber que uma venda nova foi emitida do outro lado, numa consolidadora, existem basicamente dois caminhos: polling, que é perguntar de tempos em tempos "tem novidade?", e webhook, que é a consolidadora avisar sozinha, no momento em que a venda acontece, sem precisar ser perguntada.

Como o polling funciona na prática

No polling, o sistema consulta a API da consolidadora em intervalos regulares — a cada 15 minutos, por exemplo — e verifica se existe algo novo desde a última consulta. É simples de implementar e não depende de nenhuma configuração do lado da consolidadora, mas tem um custo: entre uma consulta e outra, a venda já existe do lado de lá, mas ainda não chegou do lado de cá.

Como o webhook muda essa equação

Com webhook, a consolidadora envia uma notificação automática assim que a venda é confirmada, sem esperar ser perguntada. Isso reduz drasticamente o atraso entre a venda acontecer e ela aparecer no sistema — mas exige que a consolidadora ofereça esse recurso, o que nem todo protocolo do mercado disponibiliza.

Nem sempre a escolha é só uma das duas

Na prática, muitas integrações combinam os dois: webhook como caminho principal, pra reagir rápido quando disponível, e polling como rede de segurança, rodando com intervalo maior, pra capturar qualquer notificação que eventualmente falhe ou não chegue.

O que considerar antes de escolher

Se a agência depende de saber da venda quase em tempo real — por exemplo, pra conferir disponibilidade de estoque compartilhado — webhook é praticamente obrigatório. Se a urgência é menor, e o volume de vendas não é tão alto, polling com um intervalo razoável costuma ser suficiente e mais simples de manter.

O risco de depender só de um dos dois

Confiar cegamente em webhook sem nenhum mecanismo de verificação por trás significa que uma notificação perdida — por instabilidade de rede, por exemplo — pode nunca ser recuperada. Depender só de polling, por outro lado, sempre vai carregar um atraso inerente ao intervalo escolhido, por menor que seja.