Qué cambió en la API, y cuándo
Cada cambio que ve quien integra, del más reciente al más antiguo. La regla de v1 es simple: se agregan campos, nunca se quitan ni se renombran.
Comprueba tu clave, el estado de cada módulo y más consumo
NUEVO ·
GET /profile dice de quién es la clave, a qué espacios llega y si puede escribir. GET /api/companies/{espacio}/semaforo da un color por módulo (verde, amarillo, rojo o gris) con el motivo en palabras: si no responde, si se acabaron los créditos o si la cuenta no está al día. Ya están documentados también el consumo de Fuentes en créditos (GET /api/mod/fuentes/{espacio}/consumo) y el registro de mensajes que entraron por Kommo, con los que se perdieron (GET /api/mod/kommo/{espacio}/inbound/ledger). Todas son de lectura y no gastan créditos.
Landings: vuelve a una versión anterior
NUEVO ·
POST /api/mod/landing/{espacio}/landings/{landing}/restaurar copia una versión anterior como versión nueva, con su HTML y su certificado, sin gastar créditos. Las versiones traen con_html y restaurada_de. El formConfig queda guardado en la landing: refinar o validar sin él usa el mismo. La revisión del brief también pregunta por el destino de un siguiente paso que el brief promete, y sus ejemplos son formatos con huecos, nunca datos.
Fuentes: la publicación se reintenta sola
CORRECCIÓN ·
Si una ficha armada no llega a los documentos del espacio, traza.publicacion.status queda en fallida y se reintenta sola hasta lograrlo, sin gastar créditos. Con rechazada no se publicará: ármala otra vez.
Módulos que solo activa Bentho
NUEVO ·
Algunos módulos los activa o los quita solo Bentho. PATCH /api/companies/{espacio}/modules responde 403 si tu lista los pone o los quita, y GET /api/companies/{espacio}/limite no los ofrece en activables. Pídeselos a tu asesor.
Productos: fijar un precio reemplaza el anterior
CORRECCIÓN ·
POST /api/mod/productos/{espacio}/prices con la misma lista, variante, moneda y min_qty que un precio que ya existe lo reemplaza: el anterior deja de existir y la respuesta trae el id nuevo. Para cambiar un precio ya no hace falta borrarlo antes.
Las respuestas con precios o stock no se reusan
CORRECCIÓN ·
La caché de respuestas ya no guarda las que dan precios, totales, descuentos, envíos, stock o disponibilidad: se responden de nuevo cada vez, con los datos de ese momento. Cambiar el catálogo no pide vaciar la caché.
Agente ventas sustituye a Ventas y a Comprensión
NUEVO ·
El módulo agente (Agente ventas) atiende y vende por chat y entiende cada mensaje en el mismo turno. Ventas y Comprensión se retiraron: /api/mod/ventas/… y /api/mod/comprension/… responden 404. Cambia el prefijo de tu integración por /api/mod/agente/{espacio}/…: cada ruta de Ventas sigue igual, con el mismo cuerpo y la misma respuesta. Los espacios que tenían Ventas ya están en Agente ventas, y en ellos POST conversations del núcleo llega al agente.
Fuentes: cierre externo y lo que se leyó
NUEVO ·
Con como.cierre_externo, una búsqueda externa intenta llenar al final los campos vacíos de una ficha; lo que no respalda una página sale marcado y se cobra a tarifa externa. Tres rutas nuevas: el texto de una página que leyó una ficha y las capturas de una fuente. Los errores de fichas y corridas llegan en una frase clara.
Respuestas sin datos internos
CORRECCIÓN ·
Algunas respuestas traían campos internos que nunca estuvieron documentados, y ya no salen. La configuración del asistente devuelve lo que puedes cambiar más el nivel de exigencia y el repaso; la de Ventas, los ajustes que puedes cambiar, y mandar uno interno da 403. Ninguna ruta ni campo documentado cambió.
Todos los módulos, documentados
NUEVO ·
Cada módulo tiene ahora su guía y una ficha por ruta: Ventas, Marca, Comprensión, Productos, Comercial, Facturación, Contabilidad, Kommo y Transcripción, junto a Fuentes y Landings. En el mapa tienen su propia sección, por categorías. Y en la API, nuevas fichas para leer tus espacios, tu cuenta y su configuración.
Landings por la API
EN PREPARACIÓN ·
Ya puedes consultar la guía y preparar la integración de Landings. Su uso por API o desde el Estudio requiere que el módulo esté disponible y habilitado en tu espacio. Crear, refinar, validar y completar gastan créditos.
Fuentes por la API
NUEVO ·
Con el módulo Fuentes, arma fichas con datos de la web pública (cada uno con su página y su cita) y publícalas en los documentos del espacio. Armar una ficha y lanzar una fuente gastan créditos.
Validaciones más estrictas en la entrada
SEGURIDAD ·
Ninguna ruta ni campo cambió de forma.
Consumo medido en créditos, por ruta
NUEVO ·
Cada llamada descuenta créditos de la bolsa de tu cuenta según su uso. Consulta el saldo con GET /api/cuentas/{cuenta}/bolsa.
La lista de IPs compara con la IP pública de tu servidor
CORRECCIÓN ·
Una lista que incluye tu IP ya no te rechaza por error.
Los mandos de confianza del Cerebro, con sus rangos
NUEVO ·
GET /api/rag/{espacio}/config devuelve, además de la configuración, qué campos puedes editar y el rango válido de cada uno.
api-config: límites, cuota diaria e IPs por espacio
NUEVO ·
Cada espacio decide si su API está activa, cuántas peticiones por segundo acepta, su ráfaga, su cuota diaria y qué IPs pueden llamar.
El consumo se atribuye a la clave que llama
NUEVO ·
Ves cuánto consume cada clave.
Claves de servicio bth_
NUEVO ·
Claves con alcance por espacios, permiso de lectura o escritura y revocación. El secreto se muestra una sola vez.