Evento de cerca virtual no seu sistema: consulta à API ou webhook, e como não perder nenhum
Há 2 caminhos para o evento de cerca virtual chegar ao seu sistema: o sistema consulta a API da plataforma em intervalo curto (30 a 60 segundos) ou a plataforma avisa o sistema por webhook. A consulta à API é o caminho padrão e funciona com qualquer sistema; o webhook entra como projeto de integração quando o volume ou a urgência pedem.
Para que serve levar o evento de cerca ao meu sistema?
A cerca virtual dentro da plataforma já avisa quem está olhando a plataforma. Levar o evento para o seu sistema serve para disparar uma ação automática: marcar a entrega como “chegando”, registrar a chegada do técnico, abrir uma ordem de serviço, avisar o cliente pelo WhatsApp.
Se o objetivo é só ser avisado, a plataforma resolve sozinha — veja como criar cerca virtual. A integração faz sentido quando o evento precisa mudar algo em outro sistema.
Como funciona o caminho por consulta à API?
O seu sistema pergunta à API, a cada 30 a 60 segundos, quais eventos aconteceram desde a última consulta. Ele guarda o horário do último evento lido e, na próxima vez, pede só o que veio depois.
- Vantagem: funciona com qualquer sistema que faça uma chamada HTTP, inclusive ferramentas de automação.
- Vantagem: se o seu sistema cair, ele recupera o que perdeu na volta, porque pergunta pelo período.
- Limite: o evento chega com até um intervalo de atraso — 30 a 60 segundos.
E o caminho por webhook?
No webhook, a plataforma chama um endereço do seu sistema no instante do evento. É mais imediato, mas exige que o seu sistema esteja no ar o tempo todo para receber, e que trate repetição — o mesmo evento pode chegar duas vezes se a primeira entrega falhar.
| Critério | Consulta à API | Webhook |
|---|---|---|
| Atraso do evento | 30 a 60 segundos | Quase imediato |
| Seu sistema fora do ar | Recupera na volta | Pode perder, se não houver reenvio |
| Complexidade | Baixa | Média: endereço público, segurança, repetição |
| Como contratar | Incluso com a API | Projeto de integração |
Para entrega, assistência técnica e coleta, 30 a 60 segundos de atraso raramente fazem diferença. Por isso o caminho padrão é a consulta.
Como não perder nem duplicar evento?
- Guarde o identificador de cada evento e ignore o que já foi processado.
- Peça sempre um período com sobreposição (alguns segundos antes da última leitura) e deduplique.
- Separe ler de agir: grave o evento primeiro e dispare a ação depois, para poder refazer a ação sem reler a API.
- Registre a fonte: qual cerca, qual veículo, qual horário do rastreador — não o horário em que você leu.
Posso bloquear o veículo quando ele sair da cerca?
Tecnicamente existe comando de bloqueio, mas bloqueio automático por evento de cerca é o caso que mais causa problema: GPS impreciso perto da borda, veículo em movimento, cerca mal desenhada. O recomendado é o evento gerar alerta e uma pessoa decidir. As razões estão em como funciona o bloqueio veicular.
Como desenhar a cerca de uma entrega ou visita?
Para cerca criada por pedido ou ordem de serviço, um círculo em volta do endereço costuma bastar. O raio precisa ser maior que o erro do GPS e menor que a distância até o vizinho que confunde a leitura — em área urbana, por exemplo, algo entre 100 e 300 metros. Em condomínio, galpão ou fazenda, desenhe o polígono do terreno.
Apague a cerca quando o pedido terminar. Cerca esquecida gera evento que ninguém usa e polui a consulta.
Perguntas frequentes
A plataforma tem webhook de cerca virtual?
Com que atraso o evento chega por consulta à API?
O que acontece se o meu sistema ficar fora do ar?
Dá para fazer isso no n8n?
Devo bloquear o veículo automaticamente quando sair da cerca?
Quer o evento de cerca dentro do seu sistema?
Mostramos como consultar os eventos pela API e o que muda se o seu caso pedir webhook.
Falar sobre integração Ver o guia de integrações
