Agente de siniestros
Toma la denuncia por WhatsApp, la carga en el portal y le avisa el número al cliente.
Agente de siniestros
Toma la denuncia por WhatsApp, la carga en el portal y le avisa el número al cliente. Todo lo que hace desde la app se puede hacer por API: disparar una corrida, leer su cola y su bitácora, y cambiar su configuración.
En la demo la API está documentada pero no expuesta: los ejemplos salen de los datos de esta sesión.
Introducción
Una API REST con JSON. Cada agente tiene su espacio en https://api.brokiar.app/v1/agentes/siniestros: sus corridas, sus casos, su bitácora y su configuración. Las fechas van en ISO 8601 con hora de Argentina; los importes, en pesos sin formato.
Autenticación
Cada pedido lleva la API key del estudio en el header Authorization. Las keys se generan en Configuración y ven la cartera entera, como la titular: no las pegues en el browser.
curl "https://api.brokiar.app/v1/agentes/siniestros" \ -H "Authorization: Bearer bk_live_••••••••••••"
Errores
Códigos HTTP de siempre y un cuerpo con un código estable para programar contra él.
- 400 datos_invalidos
- Falta un campo obligatorio o vino mal.
- 401 sin_autorizacion
- Falta la API key o no es válida.
- 404 no_existe
- El caso, la corrida o el registro no existe.
- 409 no_disparable
- El agente ya está corriendo, o corre solo cuando entra un caso.
- 429 demasiados_pedidos
- Más de 60 pedidos por minuto.
{
"error": {
"codigo": "no_existe",
"mensaje": "No hay una corrida con ese id."
}
}Paginación
Las listas devuelven hasta `limite` elementos (50 por defecto, 200 como máximo) y un cursor `siguiente`; se pide la próxima página con `?desde=<siguiente>`. Sin `siguiente`, no hay más.
{
"data": [
"…"
],
"siguiente": "eyJkZXNkZSI6NTB9"
}Bitácora de actividad
Cada cosa que hace el agente — un WhatsApp, una llamada, un paso en un portal — queda en la bitácora con su hora y el registro que tocó. Es la misma que se ve en la pestaña Bitácora.
curl "https://api.brokiar.app/v1/agentes/siniestros/actividad?limite=3" \ -H "Authorization: Bearer bk_live_••••••••••••"
{
"data": [
{
"id": "bs-27",
"fecha": "2026-09-07",
"hora": "09:00:00",
"registro": "siniestro:s-01",
"tipo": "portal",
"texto": "Cargó la denuncia #4471 en el portal de Andes Seguros y trajo el N° AND-77213"
},
{
"id": "bs-33",
"fecha": "2026-09-02",
"hora": "09:03:42",
"registro": "siniestro:s-08",
"tipo": "portal",
"texto": "Cargó la denuncia #4444 en el portal de Litoral Cía. de Seguros y trajo el N° LIT-12044"
},
{
"id": "bs-28",
"fecha": "2026-08-30",
"hora": "09:00:37",
"registro": "siniestro:s-02",
"tipo": "portal",
"texto": "Cargó la denuncia #4468 en el portal de Costa Atlántica Seguros y trajo el N° CAT-40118"
}
],
"siguiente": "eyJkZXNkZSI6M30"
}Ver y cambiar la configuración
Cuándo corre y por qué canales. `PATCH` con los campos que cambian; lo demás queda igual.
curl "https://api.brokiar.app/v1/agentes/siniestros/configuracion" \ -H "Authorization: Bearer bk_live_••••••••••••"
{
"agente": "siniestros",
"horario": "al entrar un caso",
"activo": true
}Listar corridas
Cada vez que corrió el agente, de la más nueva a la más vieja. `resultado` es ok, parcial (algún paso falló) o con_errores.
curl "https://api.brokiar.app/v1/agentes/siniestros/corridas?limite=2" \ -H "Authorization: Bearer bk_live_••••••••••••"
{
"data": [
{
"id": "run_siniestros_20260907_090000",
"agente": "siniestros",
"inicio": "2026-09-07T09:00:00-03:00",
"fin": "2026-09-07T09:00:00-03:00",
"duracion_s": 0,
"resultado": "ok",
"casos": [
"siniestro:s-01"
],
"pasos": [],
"pasos_total": 1
},
{
"id": "run_siniestros_20260902_090342",
"agente": "siniestros",
"inicio": "2026-09-02T09:03:42-03:00",
"fin": "2026-09-02T09:03:42-03:00",
"duracion_s": 0,
"resultado": "ok",
"casos": [
"siniestro:s-08"
],
"pasos": [],
"pasos_total": 1
}
],
"siguiente": "eyJkZXNkZSI6Mn0"
}Disparar una corrida
Este agente corre cuando entra un caso, no por horario: disparar devuelve 409 no_disparable. Para hacerlo trabajar, se crea el caso.
curl -X POST "https://api.brokiar.app/v1/agentes/siniestros/corridas" \ -H "Authorization: Bearer bk_live_••••••••••••"
{
"error": {
"codigo": "no_disparable",
"mensaje": "Este agente corre cuando entra un caso."
}
}Ver el detalle de una corrida
La corrida con sus pasos, en orden, y los casos que tocó.
curl "https://api.brokiar.app/v1/agentes/siniestros/corridas/run_siniestros_20260907_090000" \ -H "Authorization: Bearer bk_live_••••••••••••"
{
"id": "run_siniestros_20260907_090000",
"agente": "siniestros",
"inicio": "2026-09-07T09:00:00-03:00",
"fin": "2026-09-07T09:00:00-03:00",
"duracion_s": 0,
"resultado": "ok",
"casos": [
"siniestro:s-01"
],
"pasos": [
{
"hora": "09:00:00",
"registro": "siniestro:s-01",
"texto": "Cargó la denuncia #4471 en el portal de Andes Seguros y trajo el N° AND-77213",
"error": false
}
]
}Casos
La cola del agente, por pestaña (whatsapp, denunciar, abiertos). Es lo que se ve en Trabajo.
curl "https://api.brokiar.app/v1/agentes/siniestros/casos?pestana=whatsapp&limite=2" \ -H "Authorization: Bearer bk_live_••••••••••••"
{
"data": [
{
"id": "cv-01",
"titulo": "Marcos Iturria",
"detalle": "WhatsApp desde 23:38",
"estado": "Para confirmar",
"monto": null,
"ultimo": "Completa: la confirma una persona"
},
{
"id": "cv-02",
"titulo": "Transportes del Sur SRL",
"detalle": "WhatsApp desde 08:12",
"estado": "Tomando la denuncia",
"monto": null,
"ultimo": "Le faltan 5 datos"
}
],
"siguiente": "eyJkZXNkZSI6Mn0"
}Confirmar una denuncia
Una persona confirma la denuncia: el agente la carga en el portal.
curl -X POST "https://api.brokiar.app/v1/agentes/siniestros/denuncias/{id}/confirmar" \
-H "Authorization: Bearer bk_live_••••••••••••" \
-H "Content-Type: application/json" \
-d '{"poliza_id":"p-01","reclamado":850000}'Registrar el número
Registra el número de la compañía y se lo avisa al cliente por WhatsApp.
curl -X POST "https://api.brokiar.app/v1/agentes/siniestros/denuncias/{id}/numero" \
-H "Authorization: Bearer bk_live_••••••••••••" \
-H "Content-Type: application/json" \
-d '{"numero":"SN-2026-4471"}'