Volver a desarrolladores
Zona técnica · API

API de AMI

Los endpoints que ya corren hoy en /api y le dan de comer al asistente: qué hacen, quién puede llamarlos y qué entra y sale de cada uno. Documentación interna — no hace falta llave para leerla, pero tampoco está pensada para el público.

Las siete rutas

Todo lo que sigue, de un vistazo. El cuadrado dorado marca lo que pide llave.

Siete rutas sobre seis ficheros/api/ami sirve el chat y el diagnóstico de memoria por la misma puerta. Son seis de las doce funciones que se despliegan: las otras seis corren el resto del sitio y no son de AMI.

Contexto de marca

De dónde saca AMI lo que sabe de AIMA antes de contestar.

POST /api/ami Abierto

Motor del chat general de AMI en toda la web pública: recibe el mensaje del visitante y el historial de la conversación, y devuelve la respuesta ya con el contexto de marca — precios, tono, packs — incorporado.

Entradamessage, history, pagina Salida{ reply } Límitepeticiones por día, por IP y en total — cifras no publicadas aquí
GET /api/contexto-bot Clave de servidor

Expone ese mismo contexto de marca, más el mapa de páginas, para que el bot de WhatsApp — que corre fuera de esta web, vía n8n — lo consulte al arrancar cada conversación. No es para llamarlo desde el navegador: sin la clave compartida responde "no autorizado".

Entradaninguna — solo la cabecera con la clave Salidacontexto de marca, índice de páginas, fecha de hoy

Memoria de conversación

Diagnóstico de qué recuerda AMI ahora mismo — nunca el contenido, solo el estado.

GET /api/ami?estado=memoria Abierto

El mismo endpoint del chat, en modo diagnóstico: informa de qué ficheros de memoria están cargados y cuánto ocupan — nunca su contenido.

Entradaninguna Salidalista de ficheros cargados y su porcentaje de ocupación

Hubo un endpoint aparte, /api/memoria-estado, con esta misma función. Se fusionó aquí por el límite de 12 funciones del plan de hosting (Vercel, plan Hobby) y el fichero ya no se despliega por separado — sigue en el repositorio solo como referencia.

Voz

Todo lo que convierte texto en audio, en tres sabores distintos.

POST /api/gemini-token Abierto

Por defecto entrega un token de un solo uso para que el navegador abra una conversación de voz en vivo con AMI, sin que la clave real del proveedor de IA viaje nunca al cliente. Con modo:'voz' genera en su lugar el audio de una frase suelta — más barato, sin sesión en vivo.

Entradapagina (modo token) — o texto, voz (modo frase) Salida{ token, modelo, sistema } — o { audio, modelo, hz } Límitepeticiones por día, por IP y en total
POST /api/voz Abierto

Respaldo de voz de mayor calidad para el «Modo AMI» del catálogo de identidad: si este proveedor falla o no está configurado, el catálogo cae de vuelta a la voz nativa del navegador.

Entradatexto Salidaaudio (mp3), servido directo — no JSON
POST /api/ami-entrevista Solo desde el catálogo

El backend por voz del «Modo AMI» dentro del catálogo de identidad — herramienta interna, detrás de contraseña en herramientas.html. Entrevista al cliente hablando y, al terminar, extrae lo dicho para autorrellenar el catálogo.

Conversaciónmessages, cliente, empresa, pregunta{ reply } Extracciónmodo:'extraer', transcripcion, preguntas{ respuestas }

Agentes de automatización

La entrada de los resultados que llegan desde fuera y acaban en el panel del cliente.

POST /api/agentes Clave de servidor

Recibe los resultados que genera el flujo de automatización externo — resumen semanal, estado de campañas, próximas acciones — y los guarda para que el panel de cada cliente los muestre. Sin la clave compartida responde "no autorizado".

Entradacliente_slug, agente_id, titulo, contenido Salida{ ok: true }

Lo que no está aquí

Dónde acaba AMI y empieza el resto del sitio.