Disparado quando a tensão média da bateria externa cai abaixo do threshold
configurado para a frota. A média evita disparos espúrios em quedas instantâneas,
como a partida do motor.
O threshold aplicado vem em batteryVoltageThresholdMv e depende de voltageRegime:
frotas mistas têm um threshold para 12 V (LIGHT) e outro para 24 V (HEAVY).
Janela de 4 horas por dispositivo. Depois de um
battery_external_low, novas
quedas abaixo do threshold no mesmo dispositivo são silenciadas por 4 h. Ausência
de evento nesse intervalo não significa que a tensão se recuperou.
Assine o tipo battery_external_low para receber este evento.
A Cobli envia este evento como POST application/json para a URL cadastrada na
assinatura, assinado em X-Cobli-Signature. Responda 2xx em até 5 segundos e
deduplique por eventId.
Evento aceito. Responda 2xx em até 5 segundos — enfileire e processe de forma assíncrona se o seu processamento for demorado. Nenhuma retentativa é feita.
Evento rejeitado de forma permanente — use para assinatura HMAC inválida ou payload malformado. A Cobli trata 4xx como falha definitiva e não retenta, com duas exceções: 429 (ver abaixo) e 401 em assinaturas com Bearer auth habilitado, em que a Cobli renova o token e retenta. Não devolva 4xx para um eventType que você não espera: ignore-o e responda 2xx.
Falha temporária no seu lado. A Cobli faz até 5 tentativas no total, com backoff exponencial entre elas — 2 s → 4 s → 8 s → 15 s —, jitter de ±20 % e teto de 15 s por intervalo. O mesmo vale para timeout: sem resposta em 5 segundos.