Skip to main content

Webhooks de SmartFleet

Resumen​

SmartFleet entrega notificaciones de alerta usando el mismo registro de Webhook que otros productos Verifik. Cuando una regla de monitoreo incluye el canal webhook, Verifik envía un callback HTTP con un evento tipado fleet_alert_*.

Also available: English version.

Cómo se elige la URL destino
  1. Si la regla tiene webhookUrl, Verifik busca un Webhook activo del cliente cuya URL coincida (o usa el primer webhook activo al resolver la entrega).
  2. Si no, se usa el primer Webhook activo del cliente.
  3. Si no hay webhook, la entrega queda como skipped con no_webhook_configured.

Registra endpoints en Webhooks del panel y selecciona el canal webhook en la regla de SmartFleet.

Tipo de evento​

fleet_alert_{alertType}

Ejemplos:

type del eventoCuándo se dispara
fleet_alert_soat_expiringSOAT entra en la ventana de aviso
fleet_alert_soat_expiredSOAT vencido
fleet_alert_rtm_expiringRTM entra en la ventana de aviso
fleet_alert_rtm_expiredRTM vencido
fleet_alert_new_comparendoNuevo comparendo detectado
fleet_alert_fine_amount_changedCambió el monto de una multa
fleet_alert_ownership_changedCambió la propiedad
fleet_alert_new_claimNuevo siniestro detectado
fleet_alert_check_failedFalló una consulta programada
fleet_alert_customAlerta personalizada / sin clasificar

Forma del payload​

{
  "type": "fleet_alert_soat_expiring",
  "object": {
    "alertId": "66f0…",
    "type": "soat_expiring",
    "severity": "warning",
    "title": "SOAT vence en 12 días",
    "detectedAt": "2026-08-03T18:00:00.000Z",
    "payload": {},
    "asset": {
      "id": "66f1…",
      "plate": "ABC123",
      "vin": null,
      "nickname": "Camión 1",
      "group": "norte",
      "country": "co"
    }
  }
}

Trata los campos opcionales nuevos como aditivos.

Canales y estado de entrega​

Cada alerta guarda el resultado por canal (email, webhook, inApp) con estado pending | sent | failed | skipped. En Smart-Agent puedes verlo en Alertas y en detalle del vehículo → Alertas.

Relacionado​