La API de Bentho
Pregúntale a los documentos de un espacio, sube y quita documentos, ajusta cómo responde y consulta tus créditos. Todo por HTTP, con JSON y una clave. Los módulos de tu espacio suman sus propias rutas.
Lo básico
| BASE | https://bentho.ai/api |
|---|---|
| CLAVE | Authorization: Bearer bth_<id>.<secreto> · Claves y permisos |
| FORMATO | JSON (Content-Type: application/json), salvo la subida de documentos (multipart) y el stream (SSE). |
| DESDE DÓNDE | Desde tu servidor. La API no admite llamadas desde el navegador de tus usuarios (CORS), y la clave nunca debe llegar ahí. |
| VERSIÓN | v1: se agregan campos, nunca se quitan ni se renombran. |
Las rutas
| MÉTODO | RUTA | PARA QUÉ | PERMISO |
|---|---|---|---|
| POST | /rag/{espacio}/conversations | Haz una pregunta a tu espacio | lee |
| SSE | /rag/{espacio}/conversations/stream | La misma pregunta, en vivo | lee |
| GET | /rag/{espacio}/documents | Los documentos del espacio | lee |
| POST | /rag/{espacio}/load_documents | Sube documentos | escribe |
| DEL | /rag/{espacio}/documents/{archivo} | Quita un documento | escribe |
| GET | /rag/{espacio}/indexing_status | ¿Ya está listo lo que subí? | lee |
| PATCH | /rag/{espacio}/config | Ajusta cómo responde el Cerebro | escribe |
| PATCH | /companies/{espacio}/api-config | Límites, cuota diaria e IPs del espacio | escribe |
| GET | /cuentas/{cuenta}/bolsa | Tus créditos | lee |
| GET | /profile | Qué puede hacer tu clave | lee |
| GET | /companies | Los espacios a los que llega tu clave | lee |
| GET | /companies/{espacio}/limite | Cuántos módulos caben en el espacio | lee |
| GET | /companies/{espacio}/semaforo | Si cada módulo del espacio funciona | lee |
| PATCH | /companies/{espacio}/modules | Activa o quita módulos del espacio | escribe |
| GET | /rag/{espacio}/documents/{archivo} | Descarga un documento | lee |
| DEL | /rag/{espacio}/clear_cache | Vacía la caché de respuestas | escribe |
| GET | /rag/{espacio}/config | Lee cómo responde el Cerebro | lee |
| GET | /companies/{espacio}/api-config | Lee los límites, la cuota y las IPs del espacio | lee |
| GET | /companies/{espacio}/cuenta | La cuenta de tu espacio | lee |
| GET | /cuentas/{cuenta}/cierres | Lo gastado en cada ciclo cerrado | lee |
Módulos
Cada módulo de tu espacio suma sus rutas bajo /api/mod/{modulo}/{espacio}/, con la misma clave y los mismos límites. Solo responden en los espacios que tienen ese módulo (los ves en GET /api/companies); en los demás, 403. Cómo se llaman, qué permisos piden y cuáles gastan créditos, en Módulos.
- Fuentes (
fuentes): Trae la web a los documentos del espacio: fichas con cada dato citado y páginas que se leen tal cual. - Transcripción (
transcripcion): Convierte notas de voz y audios en texto. - Agente ventas (
agente): Atiende y vende por chat: entiende qué pide el cliente, cotiza con el catálogo y los envíos del espacio y cierra la orden. - Marca (
marca): La personalidad del asistente: identidad, tono y tácticas de tu marca. - Productos (
productos): El catálogo del espacio: productos, precios, inventario y promociones. - Comercial (
comercial): Tarifas de envío, recargos y beneficios. - Facturación (
facturacion): Órdenes, total a pagar y revisión de los comprobantes de pago. - Contabilidad (
contabilidad): Conecta tu software contable: conciliación y exportaciones. - Kommo (
kommo): Sincroniza leads y conversaciones con tu CRM Kommo. - Landings (
landing): Crea landings con formulario desde un brief, probadas en un navegador antes de entregarlas.
Gestionar las claves
Crear, listar y revocar claves (/api/tokens) se hace con la sesión de la consola, no con una clave: así una clave filtrada no puede crear otras. Ver Claves y permisos.