BrokIAr

Agente de cotización

Carga el riesgo en todos los portales a la vez y arma la comparativa.

Activas
8
Requieren atención
0
Con el cliente
4
Pasos hoy
0
en los portales
API · v1

Agente de cotización

Carga el riesgo en todos los portales a la vez y arma la comparativa. 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/cotizacion: 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
curl "https://api.brokiar.app/v1/agentes/cotizacion" \
  -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.
respuesta 404
{
  "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.

respuesta
{
  "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.

GET/actividad?limite=3
curl
curl "https://api.brokiar.app/v1/agentes/cotizacion/actividad?limite=3" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "data": [
    {
      "id": "a-q-h10-r2",
      "fecha": "2026-09-10",
      "hora": "16:31:00",
      "registro": "cotizacion:q-h10",
      "tipo": "portal",
      "texto": "Costa Atlántica Seguros no toma el riesgo: queda fuera de la comparativa"
    },
    {
      "id": "a-q-h10-r0",
      "fecha": "2026-09-10",
      "hora": "16:27:00",
      "registro": "cotizacion:q-h10",
      "tipo": "portal",
      "texto": "Litoral Cía. de Seguros cotizó en su portal: prima $ 905.000"
    },
    {
      "id": "a-q-h10-r1",
      "fecha": "2026-09-10",
      "hora": "16:23:00",
      "registro": "cotizacion:q-h10",
      "tipo": "portal",
      "texto": "Andes Seguros cotizó en su portal: prima $ 948.000"
    }
  ],
  "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.

GET/configuracion
curl
curl "https://api.brokiar.app/v1/agentes/cotizacion/configuracion" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "agente": "cotizacion",
  "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.

GET/corridas?limite=2
curl
curl "https://api.brokiar.app/v1/agentes/cotizacion/corridas?limite=2" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "data": [
    {
      "id": "run_cotizacion_20260910_162000",
      "agente": "cotizacion",
      "inicio": "2026-09-10T16:20:00-03:00",
      "fin": "2026-09-10T16:31:00-03:00",
      "duracion_s": 660,
      "resultado": "ok",
      "casos": [
        "cotizacion:q-h10"
      ],
      "pasos": [],
      "pasos_total": 6
    },
    {
      "id": "run_cotizacion_20260907_104500",
      "agente": "cotizacion",
      "inicio": "2026-09-07T10:45:00-03:00",
      "fin": "2026-09-07T11:06:00-03:00",
      "duracion_s": 1260,
      "resultado": "ok",
      "casos": [
        "cotizacion:q-h09"
      ],
      "pasos": [],
      "pasos_total": 6
    }
  ],
  "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.

POST/corridas
curl
curl -X POST "https://api.brokiar.app/v1/agentes/cotizacion/corridas" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta 409
{
  "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ó.

GET/corridas/run_cotizacion_20260910_162000
curl
curl "https://api.brokiar.app/v1/agentes/cotizacion/corridas/run_cotizacion_20260910_162000" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "id": "run_cotizacion_20260910_162000",
  "agente": "cotizacion",
  "inicio": "2026-09-10T16:20:00-03:00",
  "fin": "2026-09-10T16:31:00-03:00",
  "duracion_s": 660,
  "resultado": "ok",
  "casos": [
    "cotizacion:q-h10"
  ],
  "pasos": [
    {
      "hora": "16:20:00",
      "registro": "cotizacion:q-h10",
      "texto": "Cotizando en el portal de Costa Atlántica Seguros",
      "error": false
    },
    {
      "hora": "16:20:00",
      "registro": "cotizacion:q-h10",
      "texto": "Cotizando en el portal de Andes Seguros",
      "error": false
    },
    {
      "hora": "16:20:00",
      "registro": "cotizacion:q-h10",
      "texto": "Cotizando en el portal de Litoral Cía. de Seguros",
      "error": false
    },
    {
      "hora": "16:23:00",
      "registro": "cotizacion:q-h10",
      "texto": "Andes Seguros cotizó en su portal: prima $ 948.000",
      "error": false
    }
  ],
  "pasos_total": 6
}

Casos

La cola del agente, por pestaña (activas, atencion, presentadas, cerradas). Es lo que se ve en Trabajo.

GET/casos?pestana=activas&limite=2
curl
curl "https://api.brokiar.app/v1/agentes/cotizacion/casos?pestana=activas&limite=2" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "data": [
    {
      "id": "q-01",
      "titulo": "Sofía Renzi",
      "detalle": "Automotor · Honda HR-V 0km",
      "estado": "Presentada",
      "monto": 698000,
      "ultimo": "3 de 3 cotizaron"
    },
    {
      "id": "q-02",
      "titulo": "Agro Vidal e Hijos",
      "detalle": "Comercio · Galpón acopio · Balcarce",
      "estado": "Recibida",
      "monto": 2180000,
      "ultimo": "2 de 2 cotizaron"
    }
  ],
  "siguiente": "eyJkZXNkZSI6Mn0"
}

Pedir una cotización

Pide una cotización: el agente la carga en todos los portales.

POST/cotizaciones
curl
curl -X POST "https://api.brokiar.app/v1/agentes/cotizacion/cotizaciones" \
  -H "Authorization: Bearer bk_live_••••••••••••" \
  -H "Content-Type: application/json" \
  -d '{"cliente_id":"c-03","ramo":"Automotor","detalle":"Toyota Corolla 2022"}'

Emitir

Emite con la compañía que eligió el cliente.

POST/cotizaciones/{id}/emitir
curl
curl -X POST "https://api.brokiar.app/v1/agentes/cotizacion/cotizaciones/{id}/emitir" \
  -H "Authorization: Bearer bk_live_••••••••••••" \
  -H "Content-Type: application/json" \
  -d '{"aseguradora":"Andes Seguros"}'

Buscar

Buscá un cliente, una póliza, un siniestro, una cotización o una pantalla