- Inicio
- API de chatbot con IA
API de chatbot con IA para tu propia aplicación
Tu app ya tiene usuarios con preguntas. Con la API REST de Asyntai, tu servidor envía cada pregunta y recibe una respuesta en JSON, escrita a partir de tu web y tus documentos. Tú decides cómo se ve; Asyntai pone la respuesta.
- 50 respuestas de IA al mes gratis
- Respuestas en JSON
- Sin tarjeta de crédito
¿Cómo se usa una API de chatbot con IA?
Tu servidor manda la pregunta del usuario a POST https://asyntai.com/api/v1/chat/ con tu clave en la cabecera Authorization. Asyntai busca la respuesta en tu contenido y la devuelve en el campo response. Se hace en tres pasos:
- Crea la cuenta y añade tu web para que la IA lea tus páginas.
- Genera la clave de API en Ajustes, API. Está en los planes Starter, Standard y Pro.
- Envía el primer mensaje desde tu backend y muestra el campo
responseen tu app.
¿Widget, canales de mensajería o API REST?
El mismo asistente puede hablar con tus clientes en tres sitios distintos. Antes de programar nada, conviene saber cuál de ellos necesitas, porque dos de los tres no requieren código.
| Widget en tu webuna etiqueta script | Canales de mensajeríaWhatsApp, Instagram, Messenger, Discord | API RESTtu app, tu interfaz | |
|---|---|---|---|
| Dónde conversa el cliente | En tu sitio web, en una ventana de chat lista para usar. | En la app de mensajería que ya usa a diario. | En cualquier pantalla que programes: app móvil, área de clientes, intranet, quiosco. |
| Qué programas tú | Nada. Pegas el código o instalas el plugin. | Nada. Conectas la cuenta desde el panel. | La interfaz y una llamada HTTP desde tu servidor. |
| Contenido de las respuestas | Tu base de conocimiento. | La misma base de conocimiento. | La misma base y las mismas instrucciones. |
| Plan | Todos, también el gratuito. | Starter, Standard y Pro. | Starter, Standard y Pro. |
| Ideal para | Visitantes de tu web. | Clientes que escriben por redes sociales o móvil. | Productos digitales con usuarios registrados. |
Widget en tu web
- Dónde conversa el cliente
- En tu sitio web, en una ventana de chat lista para usar.
- Qué programas tú
- Nada. Pegas el código o instalas el plugin.
- Contenido de las respuestas
- Tu base de conocimiento.
- Plan
- Todos, también el gratuito.
- Ideal para
- Visitantes de tu web.
Canales de mensajería
- Dónde conversa el cliente
- En la app de mensajería que ya usa a diario.
- Qué programas tú
- Nada. Conectas la cuenta desde el panel.
- Contenido de las respuestas
- La misma base de conocimiento.
- Plan
- Starter, Standard y Pro.
- Ideal para
- Clientes que escriben por redes sociales o móvil.
API REST
- Dónde conversa el cliente
- En cualquier pantalla que programes: app móvil, área de clientes, intranet, quiosco.
- Qué programas tú
- La interfaz y una llamada HTTP desde tu servidor.
- Contenido de las respuestas
- La misma base y las mismas instrucciones.
- Plan
- Starter, Standard y Pro.
- Ideal para
- Productos digitales con usuarios registrados.
Los tres caminos se pueden combinar en una misma cuenta. Si actualizas una página de tu web o subes un PDF nuevo, el cambio llega a la vez al widget, a WhatsApp y a tu app. Para WhatsApp, mira la guía de la integración.
Cómo hacer la primera llamada en Node.js
La URL base es https://asyntai.com/api/v1/. Para chatear solo hace falta un campo, message. Este ejemplo usa el fetch que ya trae Node.js, sin librerías extra.
- 01
Comprueba las respuestas
Crea la cuenta gratis, añade tu web y haz en el panel las preguntas que harán tus usuarios. Corrige el contenido antes de integrar.
- 02
Guarda la clave en el servidor
Con un plan de pago, crea la clave en Ajustes, API, y guárdala en una variable de entorno, por ejemplo
ASYNTAI_API_KEY. - 03
Crea un endpoint propio
Tu app llama a tu backend, y tu backend llama a Asyntai. Así la clave nunca sale de tu servidor.
- 04
Envía el session_id
Usa un valor fijo por usuario o por conversación. La IA tendrá en cuenta los mensajes anteriores de esa sesión.
async function preguntarAsistente(pregunta, usuarioId) {
const res = await fetch("https://asyntai.com/api/v1/chat/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.ASYNTAI_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
message: pregunta,
session_id: `alumno_${usuarioId}`
})
});
const data = await res.json();
if (!data.success) throw new Error(data.error);
return data.response;
}
También puedes enviar la clave en la cabecera X-API-Key. Si tu cuenta tiene varias webs, añade website_id para elegir cuál responde.
{
"success": true,
"response": "Sí, si apruebas la prueba de nivel...",
"session_id": "alumno_5307",
"ai_disclosure": "..."
}
En el primer mensaje de cada sesión, ai_disclosure trae una frase que avisa de que responde una IA, en el idioma de la respuesta. Muéstrala en tu interfaz. Todos los campos están en la referencia de la API.
Leer los datos del chatbot desde tu sistema
La API no solo responde preguntas. Con la misma clave puedes llevar a tu CRM, a tu helpdesk o a tu panel de métricas lo que pasa en el chat, sin exportar archivos a mano.
Sesiones
GET /sessions/Lista las conversaciones recientes, de la más nueva a la más antigua, hasta 100 por llamada. Con los parámetros since y before recorres todo el historial por páginas.
Conversaciones
GET /conversations/Devuelve los mensajes de una sesión. Cada respuesta indica si la escribió la IA o una persona de tu equipo (sender_type) y cuánto tardó, en milisegundos (response_time_ms).
Leads
GET /leads/Los emails y teléfonos que dejaron los visitantes en el chat, con la página donde estaban y el session_id para leer la conversación completa. La captura de leads está en Starter y superiores.
Tickets
GET /tickets/Los tickets de soporte con su estado, su prioridad y las horas clave: creación, asignación, primera respuesta y resolución. Útil para medir tiempos de atención. Los tickets son una función de Standard y Pro.
Cuenta
GET /account/Tu plan, las respuestas de IA usadas este mes y el límite. Ideal para avisar a tu equipo antes de llegar al tope.
Webhooks
POST /webhooks/Si prefieres no consultar la API cada cierto tiempo, registra una URL y recibe un aviso cuando llega un mensaje, empieza una conversación, la IA pide ayuda humana o alguien de tu equipo toma el chat. Cada aviso va firmado con HMAC-SHA256.
La API también permite añadir contenido a la base de conocimiento (texto, una URL o una hoja de cálculo) y cambiar los ajustes y las instrucciones de cada web. Los detalles están en la documentación.
¿De dónde salen las respuestas de la API?
No tienes que mandar tu contenido en cada llamada. Asyntai guarda tu base de conocimiento y, para cada pregunta, busca los fragmentos que encajan y redacta la respuesta con ellos.
Rastreo de la web
El rastreador sigue tus enlaces y lee el texto de cada página.
URL sueltas
Una página concreta, como una nueva política de cambios.
Archivos PDF
Manuales, tarifas y condiciones. También PDF escaneados.
Hojas de cálculo
CSV o Excel. Cada fila se convierte en una entrada.
Texto libre
Datos que no están en la web, escritos en el panel o enviados por API.
Archivos HTML
Páginas guardadas y documentos en HTML.
Vídeos
La IA responde a partir de la transcripción.
Real-Time Data Feed
Datos que cambian a menudo, como plazas libres o stock.
Standard y ProTus instrucciones fijan el tono, los temas permitidos y qué hacer cuando falta información. Valen igual para el widget y para la API. Cada fuente se explica en la guía de la base de conocimiento.
Ejemplos de integración con la API
Tres proyectos típicos. En todos, tu código se ocupa de la pantalla y de quién es el usuario, y Asyntai se ocupa de la respuesta.
Un quiosco táctil llama a la API. La respuesta sale de una hoja de cálculo de productos y pasillos.
Respuesta de un PDF con la lista de documentos, dentro del área privada.
El equipo pregunta desde su propio panel. La respuesta sale de las condiciones de venta en texto libre.
Control, seguridad y códigos de error
Todas las llamadas van por HTTPS. Quien tiene tu clave tiene acceso a tu cuenta por API, así que guárdala solo en el servidor. Los errores llegan con "success": false y un campo error que explica el motivo.
Instrucciones
Todos los planesDefine el tono y los límites, por ejemplo: "Habla de tú. Solo responde sobre cursos y pagos. Si no sabes algo, remite a secretaría". Puedes editarlas en el panel o por API.
Registro de chats
Todos los planesLas conversaciones de la API aparecen en el panel con el origen api. Las lees como las del widget y ves qué preguntas hacen tus usuarios.
Errores 401 y 403
Acceso401 significa que falta la clave o no es válida. 403 significa que la cuenta está en el plan gratuito, que no incluye la API. Un JSON mal formado o sin message devuelve 400.
Errores 429 y 503
Límites429 llega cuando se acaban las respuestas de IA del mes, con limit_reached a true. 503 indica que la IA no pudo responder en ese momento: repite la llamada un poco más tarde.
Knowledge gaps
Standard y ProReúne las preguntas que tu contenido aún no cubre, vengan del widget o de la API. Así sabes qué página o documento añadir.
Planes y precios con acceso a la API
Pagas una cuota mensual fija. Cada respuesta que pides por API cuenta como una respuesta de IA del plan, igual que en el widget. No hay facturas por tokens.
Free
0 USD /mes- 50 respuestas de IA al mes
- 1 web
- Pruebas en el panel
Starter
39 USD /mes- 800 respuestas de IA al mes
- 2 webs
- API REST y WhatsApp
Standard
139 USD /mes- 15.000 respuestas de IA al mes
- 3 webs
- Tickets y toma de control
Pro
449 USD /mes- 50.000 respuestas de IA al mes
- 20 webs
- Sin marca Asyntai
Todas las funciones de cada plan están en la página de precios.
Preguntas frecuentes sobre la API de chatbot
¿La API de Asyntai es gratuita?
La API REST forma parte de los planes Starter, Standard y Pro. Con el plan gratuito puedes crear la cuenta, añadir tu web y probar las respuestas en el panel, pero una llamada a la API devuelve el código 403.
¿Qué necesito para hacer la primera llamada?
Una cuenta en un plan de pago, una clave de API creada en Ajustes y luego API, y un servidor que pueda hacer peticiones HTTPS. La llamada mínima es un POST a https://asyntai.com/api/v1/chat/ con el campo message.
¿Cómo sabe la IA que dos mensajes son de la misma conversación?
Por el session_id. Si mandas el mismo valor en cada mensaje de un usuario, la IA tiene en cuenta los mensajes anteriores de esa sesión. Puedes usar el ID del usuario en tu app o el ID de un pedido.
¿Puedo usar la API desde una app móvil?
Sí, pero la app debe hablar con tu propio servidor y tu servidor con la API de Asyntai. La clave no debe ir dentro de la app ni en el código del navegador, porque cualquiera podría leerla.
¿Las conversaciones de la API se guardan en el panel?
Sí. Aparecen en el registro de chats junto a las del widget, con el origen api. También puedes leerlas desde tu sistema con los endpoints /sessions/ y /conversations/.
¿En qué idioma responde la API?
En el idioma en que escribe el usuario. Si tu web está en español y alguien pregunta en inglés o en catalán, la respuesta llega en ese idioma.
¿Cuántas respuestas puedo pedir al mes?
Las de tu plan: cada respuesta de la API cuenta como una respuesta de IA, igual que en el widget. Puedes consultar el consumo con GET /account/. Cuando llegas al límite, la API devuelve el código 429.
¿Puedo conectar Asyntai con WhatsApp sin programar?
Sí. Desde el plan Starter, Asyntai se conecta con WhatsApp, Instagram, Messenger y Discord desde el panel, sin escribir código. La API es para tus propias aplicaciones y pantallas.
Lleva las respuestas de tu web a tu app
Crea la cuenta gratis, comprueba en el panel lo que responde la IA y conecta la API cuando estés listo.