Verificação Periódica (Polling)
Como a Kanglu consulta as transportadoras automaticamente como rede de segurança
Verificação Periódica (Polling)
A verificação periódica é a rede de segurança do sistema. A Kanglu consulta ativamente as APIs das transportadoras em intervalos regulares para garantir que nenhuma atualização de rastreio seja perdida.
Por que isso existe?
Mesmo com a notificação instantânea funcionando, problemas podem acontecer:
- A transportadora pode ter uma falha temporária e não enviar a notificação
- Uma atualização pode se perder no caminho
- A transportadora pode demorar para configurar o webhook
A verificação periódica garante que nenhum evento passe despercebido.
Frequência inteligente
A Kanglu ajusta automaticamente a frequência de verificação baseado na situação:
| Cenário | Frequência | Por quê |
|---|---|---|
| Webhook ativo | A cada 6 horas | O webhook já está trazendo os dados. O polling serve apenas como segurança extra |
| Webhook inativo | A cada 5 minutos | Sem webhook, o polling é o mecanismo principal de atualização |
Essa detecção é automática — você não precisa configurar nada. A Kanglu identifica sozinha se o webhook está funcionando ou não.
Horários de verificação (com webhook ativo)
Quando o webhook está funcionando normalmente, a verificação de segurança acontece 4 vezes ao dia:
| Horário (Brasília) | Horário (UTC) |
|---|---|
| 21:00 | 00:00 |
| 03:00 | 06:00 |
| 09:00 | 12:00 |
| 15:00 | 18:00 |
Quais pedidos são verificados?
A verificação periódica consulta apenas pedidos que:
- Ainda não foram entregues ou devolvidos (pedidos finalizados são ignorados)
- Têm um código de rastreamento válido
- Foram criados nos últimos 20 dias
Isso mantém o sistema eficiente, sem consultas desnecessárias.
E o consumo de API?
A Kanglu respeita os limites das APIs das transportadoras, fazendo pausas entre cada consulta. Isso garante que suas credenciais não sejam bloqueadas por excesso de requisições.