BrokIAr

Agente de cobranza

Persigue cada cuota por WhatsApp con su cadencia hasta que se paga o pasa a una persona.

Activos
7
$ 1.688.000,00
Promesas
1
Escalados
1
a una persona
Sin datos de contacto
0
API · v1

Agente de cobranza

Persigue cada cuota por WhatsApp con su cadencia hasta que se paga o pasa a una persona. 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/cobranza: 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/cobranza" \
  -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/cobranza/actividad?limite=3" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "data": [
    {
      "id": "bs-18",
      "fecha": "2026-09-11",
      "hora": "09:30:08",
      "registro": "poliza:p-10",
      "tipo": "whatsapp",
      "texto": "Cobro de la cuota 4 a Panadería La Espiga: reclamo (+10) por WhatsApp"
    },
    {
      "id": "bs-17",
      "fecha": "2026-09-10",
      "hora": "09:05:07",
      "registro": "poliza:p-10",
      "tipo": "whatsapp",
      "texto": "Cobro de la cuota 4 a Panadería La Espiga: promesa incumplida por WhatsApp"
    },
    {
      "id": "bs-23",
      "fecha": "2026-09-10",
      "hora": "09:02:13",
      "registro": "poliza:p-08",
      "tipo": "whatsapp",
      "texto": "Cobro de la cuota 7 a Clínica Bahía SRL: aviso del día por WhatsApp"
    }
  ],
  "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/cobranza/configuracion" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "agente": "cobranza",
  "horario": "07:30",
  "activo": true,
  "tope_intentos": 5,
  "cadencia": [
    {
      "etapa": "recordatorio",
      "dia": -7,
      "canal": "whatsapp"
    },
    {
      "etapa": "vencimiento",
      "dia": 0,
      "canal": "whatsapp"
    },
    {
      "etapa": "mora_3",
      "dia": 3,
      "canal": "whatsapp"
    },
    {
      "etapa": "mora_10",
      "dia": 10,
      "canal": "whatsapp"
    },
    {
      "etapa": "mora_20",
      "dia": 20,
      "canal": "telefono"
    }
  ],
  "canales": {
    "whatsapp": {
      "activo": true
    },
    "telefono": {
      "activo": true,
      "numero_salida": "+54 11 5263-0190",
      "instrucciones": "Presentate como asistente del estudio. Decí la póliza, la cuota y el importe; ofrecé mandar el link de pago por WhatsApp. Si promete una fecha, confirmala. Si pide algo que no sea pagar, decile que lo llama su productor."
    }
  }
}

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/cobranza/corridas?limite=2" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "data": [
    {
      "id": "run_cobranza_20260911_093008",
      "agente": "cobranza",
      "inicio": "2026-09-11T09:30:08-03:00",
      "fin": "2026-09-11T09:30:08-03:00",
      "duracion_s": 0,
      "resultado": "ok",
      "casos": [
        "poliza:p-10"
      ],
      "pasos": [],
      "pasos_total": 1
    },
    {
      "id": "run_cobranza_20260910_090203",
      "agente": "cobranza",
      "inicio": "2026-09-10T09:02:03-03:00",
      "fin": "2026-09-10T09:05:07-03:00",
      "duracion_s": 184,
      "resultado": "ok",
      "casos": [
        "poliza:p-05",
        "poliza:p-08",
        "poliza:p-10"
      ],
      "pasos": [],
      "pasos_total": 3
    }
  ],
  "siguiente": "eyJkZXNkZSI6Mn0"
}

Disparar una corrida

Lo mismo que corre solo a las 07:30 o que el botón de arriba. Responde enseguida; la corrida sigue y se consulta por su id.

POST/corridas
curl
curl -X POST "https://api.brokiar.app/v1/agentes/cobranza/corridas" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta 202
{
  "id": "run_cobranza_20260913_093000",
  "estado": "en_curso"
}

Ver el detalle de una corrida

La corrida con sus pasos, en orden, y los casos que tocó.

GET/corridas/run_cobranza_20260911_093008
curl
curl "https://api.brokiar.app/v1/agentes/cobranza/corridas/run_cobranza_20260911_093008" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "id": "run_cobranza_20260911_093008",
  "agente": "cobranza",
  "inicio": "2026-09-11T09:30:08-03:00",
  "fin": "2026-09-11T09:30:08-03:00",
  "duracion_s": 0,
  "resultado": "ok",
  "casos": [
    "poliza:p-10"
  ],
  "pasos": [
    {
      "hora": "09:30:08",
      "registro": "poliza:p-10",
      "texto": "Cobro de la cuota 4 a Panadería La Espiga: reclamo (+10) por WhatsApp",
      "error": false
    }
  ]
}

Casos

La cola del agente, por pestaña (activos, sin_contacto, excluidas). Es lo que se ve en Trabajo.

GET/casos?pestana=activos&limite=2
curl
curl "https://api.brokiar.app/v1/agentes/cobranza/casos?pestana=activos&limite=2" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "data": [
    {
      "id": "k-02",
      "titulo": "Estudio Ferreyra & Asoc.",
      "detalle": "51092-1 · Litoral Cía. de Seguros · cuota 12/12",
      "estado": "En cadencia",
      "monto": 118300,
      "ultimo": "2 intentos · Le toca: último aviso (+20)."
    },
    {
      "id": "k-03",
      "titulo": "Panadería La Espiga",
      "detalle": "11884-5 · Andes Seguros · cuota 4/12",
      "estado": "Para una persona",
      "monto": 82100,
      "ultimo": "5 intentos · 5 mensajes y no pagó: insistir más es molestar. Le toca a una persona."
    }
  ],
  "siguiente": "eyJkZXNkZSI6Mn0"
}

Cargar una respuesta

Carga lo que contestó el cliente: promesa, ya pagué u otra cosa.

POST/casos/{id}/respuestas
curl
curl -X POST "https://api.brokiar.app/v1/agentes/cobranza/casos/{id}/respuestas" \
  -H "Authorization: Bearer bk_live_••••••••••••" \
  -H "Content-Type: application/json" \
  -d '{"texto":"te lo pago el viernes"}'

Llamadas

Las llamadas con voz: resultado, duración y transcripción.

GET/llamadas
curl
curl "https://api.brokiar.app/v1/agentes/cobranza/llamadas" \
  -H "Authorization: Bearer bk_live_••••••••••••"
respuesta
{
  "data": [],
  "siguiente": null
}

Buscar

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