API de Chatbot con IA

Crea tus propias integraciones de chatbot con IA usando nuestra API REST. Envía mensajes y recibe respuestas de IA inteligentes para cualquier plataforma, aplicación o solución a medida.

Obtener clave API Ver precios

Crea lo que quieras con IA

Nuestra API REST te permite integrar funciones de chatbot con IA en cualquier aplicación

# Enviar un mensaje a la IA
curl -X POST https://asyntai.com/api/v1/chat/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "¿Cuál es su horario?"}'

API REST sencilla

Un único punto de acceso para enviar mensajes y recibir respuestas de IA. Usa cURL, Python, JavaScript o cualquier lenguaje capaz de hacer peticiones HTTP. Sin SDK complejos.

# Respuesta de la IA
{
  "success": true,
  "response": "Abrimos de lunes a viernes,
    de 9 a 18 h. ¿En qué puedo ayudarle?"
,
  "session_id": "abc123"
}

Respuestas inteligentes

La IA conoce tu negocio a fondo. Se apoya en tu sitio web, tus documentos y tus instrucciones para dar respuestas exactas y adecuadas a cada pregunta.

# Conversación con contexto
{
  "message": "¿Cuál fue mi última pregunta?",
  "session_id": "user_12345"
}

# La IA recuerda la conversación

Memoria de conversación

Usa identificadores de sesión para mantener el contexto. La IA recuerda los mensajes anteriores y responde de forma coherente a lo largo de varias interacciones.

Pensada para desarrolladores

Todo lo necesario para integrar funciones de chatbot con IA en tus aplicaciones

Diseño RESTful

Una API REST clara e intuitiva que sigue las buenas prácticas. Fácil de entender, de integrar y de mantener.

Autenticación sencilla

Autenticación segura mediante clave API. Pon tu clave en la cabecera y ya puedes hacer peticiones.

Tiempos de respuesta cortos

Optimizada para la velocidad. Respuestas de IA en milisegundos, no en segundos.

Gestión de sesiones

Seguimiento de conversaciones integrado con identificadores de sesión. Mantén el contexto en varios mensajes sin esfuerzo.

Multilingüe

La IA detecta el idioma del usuario y responde en él. Atiende a un público global sin trabajo adicional.

Segura y fiable

Cifrado HTTPS, límite de peticiones y 99,9 % de disponibilidad. Tu integración es segura y está siempre accesible.

¿Listo para desarrollar con la API de Chatbot con IA?

Prueba el chatbot gratis con 100 mensajes. El acceso a la API requiere un plan de pago.

Consigue tu clave API

Cómo funciona

Empieza con la API de Chatbot con IA en tres pasos sencillos

1

Regístrate y consigue la clave API

Crea tu cuenta y genera la clave API desde el panel. Tu IA usará automáticamente el contenido de tu sitio web.

2

Haz tu primera petición

Envía una petición POST con tu mensaje a nuestro punto de acceso de chat. La IA la procesa y devuelve una respuesta inteligente.

3

Integra donde quieras

Usa la API en tu aplicación móvil, tu sitio web, tus herramientas internas o cualquier plataforma propia. Las posibilidades están abiertas.

Ver la documentación de la API

Casos de uso

La API de Chatbot con IA es versátil y puede dar soporte con IA en cualquier plataforma o aplicación que imagines.

  • Aplicaciones móviles (iOS, Android, React Native)
  • Aplicaciones web a medida
  • Herramientas de soporte internas
  • Asistentes de voz y sistemas IVR
  • Bots de Slack, bots de Discord y más
# Ejemplo en Python
import requests

response = requests.post(
  "https://asyntai.com/api/v1/chat/",
  headers={"Authorization": "Bearer API_KEY"},
  json={"message": "¡Hola!"}
)

print(response.json()["response"])

Precios sencillos y claros

El plan Free incluye 100 mensajes de prueba en el panel. El acceso a la API empieza con Starter.

Free
$0
para siempre
100 mensajes
Empezar
Starter
$39
al mes
2.500 mensajes
Empezar
Pro
$449
al mes
50.000 mensajes
Empezar

Por qué elegir nuestra API

Crea integraciones de chatbot con IA potentes con el mínimo esfuerzo

Lanza antes

Ahórrate meses de desarrollo de IA. Integra nuestra API y ten funciones de chatbot inteligente en tu aplicación hoy mismo.

Siempre al día

Actualiza el conocimiento de tu IA cuando quieras desde el panel. No hace falta cambiar la API cuando tu negocio evoluciona.

Rentable

Paga solo por lo que uses. Sin costes de infraestructura, sin costes de entrenamiento de IA, sin carga de mantenimiento.

Empieza hoy mismo

El acceso a la API requiere Starter, Standard o Pro. Crea primero una cuenta gratuita para probar el chatbot.

Consigue tu clave API

Preguntas frecuentes

Todo lo que necesitas saber sobre la API de Chatbot con IA

¿Cómo empiezo con la API?
Haz clic aquí para obtener tu clave API. Crea una cuenta, indica la URL de tu sitio web para que la IA conozca tu negocio y genera tu clave API. Después haz tu primera petición con cURL, Python, JavaScript o cualquier cliente HTTP.
¿Qué lenguajes de programación se admiten?
Cualquier lenguaje capaz de hacer peticiones HTTP funciona con nuestra API. Esto incluye Python, JavaScript, PHP, Ruby, Java, C#, Go, Swift, Kotlin y muchos más. En nuestra documentación hay ejemplos de código.
¿Cómo funciona el contexto de la conversación?
Incluye el parámetro session_id en tus peticiones. La IA recordará todos los mensajes anteriores de esa sesión y responderá teniendo en cuenta el contexto. Usa un identificador único por usuario o conversación.
¿Cómo conoce la IA mi negocio?
Puedes dar conocimiento a la IA indicando la URL de tu sitio web, que rastreamos automáticamente, subiendo documentos PDF o de texto, añadiendo instrucciones propias o aportando pares de pregunta y respuesta. Todo se hace desde el panel, sin cambiar la API.
¿Cuáles son los límites de peticiones?
Los límites dependen de tu plan. La API está pensada para aplicaciones de chat en tiempo real. Si tu caso necesita límites mayores, escríbenos.
¿Es segura la API?
Sí. Todas las peticiones usan cifrado HTTPS. Mantén tu clave API en secreto y no la expongas nunca en el código del cliente. Recomendamos llamar a la API desde tu propio servidor.
Referencia para desarrolladores

Tu primera petición

Un solo POST devuelve una respuesta de IA basada en tu base de conocimiento. Sin SDK que instalar.

POST /api/v1/chat/curl
curl -X POST https://asyntai.com/api/v1/chat/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "¿Hacen envíos a España?"}'

# 200 OK
{
  "success": true,
  "response": "Sí, enviamos a España en 3-5 días.",
  "session_id": "api_1042_87"
}

Antes de la primera llamada, añade contenido a tu base de conocimiento. La API responde a partir de tu documentación, tus precios y tus condiciones. Con la base vacía las respuestas son genéricas.

Autenticación

Cada petición lleva tu clave API en una cabecera. Se aceptan dos formas de cabecera y se comportan igual. Elige una. Genera la clave en Ajustes → API.

Solo cabeceras. La clave nunca se lee de la cadena de consulta. Una clave en una URL acaba en los registros del servidor, los registros de proxy, el historial del navegador y las cabeceras Referer. Por eso ese método no se admite.

Dos formas admitidashttp
# Opción A - token bearer
Authorization: Bearer YOUR_API_KEY

# Opción B - cabecera propia
X-API-Key: YOUR_API_KEY

El punto de acceso de chat

POST https://asyntai.com/api/v1/chat/

Cuerpo de la petición

CampoTipoObligatorioDescripción
messagestringobligatorioEl mensaje del usuario. Un valor vacío devuelve un error 400.
session_idstringopcionalTu propio identificador para una conversación. Envía el mismo valor otra vez para mantener el contexto. Si lo omites, la cuenta usa una única sesión compartida.
website_idintegeropcionalCuál de tus agentes debe responder. Si lo omites, se usa tu sitio principal o el primero de la cuenta.

Cuerpo de la respuesta

CampoTipoDescripción
successbooleantrue cuando la IA ha generado una respuesta.
responsestringEl texto de la respuesta.
session_idstringLa sesión bajo la que se registró este mensaje. Devuélvela en la siguiente llamada.

Memoria de conversación

Envía un session_id estable y los últimos 10 mensajes de esa conversación se aportan como contexto, de modo que una repregunta como "¿y cuánto cuesta eso?" se entiende bien. Usa un session_id distinto por usuario final. Si lo omites, todas las llamadas de la cuenta comparten un solo hilo, algo casi nunca deseable en producción.

Mantener el contexto entre dos llamadasjson
// primera llamada
{ "message": "¿Hacen envíos a España?", "session_id": "user-8842" }

// segunda llamada - mismo session_id, por eso se entiende "eso"
{ "message": "¿Cuánto cuesta eso?", "session_id": "user-8842" }

Ejemplos de integración

Copia, pega, cambia la clave.

fetch en el servidorjavascript
const res = await fetch('https://asyntai.com/api/v1/chat/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: '¿Hacen envíos a España?',
    session_id: 'user-8842'
  })
});

const data = await res.json();
if (!data.success) throw new Error(data.error);
console.log(data.response);

// No expongas nunca tu clave API en el código del navegador. Llama a esto desde
// tu propio servidor o una función edge y reenvía el resultado.
Python 3python
import requests

resp = requests.post(
    "https://asyntai.com/api/v1/chat/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "message": "¿Hacen envíos a España?",
        "session_id": "user-8842",
    },
    timeout=30,
)

data = resp.json()
if not data["success"]:
    raise RuntimeError(data["error"])

print(data["response"])
PHP 8php
$ch = curl_init('https://asyntai.com/api/v1/chat/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'message'    => '¿Hacen envíos a España?',
        'session_id' => 'user-8842',
    ]),
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

if (empty($data['success'])) {
    throw new Exception($data['error']);
}
echo $data['response'];
Node.js 18+javascript
const ASYNTAI_KEY = process.env.ASYNTAI_API_KEY;

export async function ask(message, sessionId) {
  const res = await fetch('https://asyntai.com/api/v1/chat/', {
    method: 'POST',
    headers: {
      'X-API-Key': ASYNTAI_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ message, session_id: sessionId })
  });

  if (res.status === 429) throw new Error('Límite mensual de mensajes alcanzado');

  const data = await res.json();
  if (!data.success) throw new Error(data.error);
  return data.response;
}
Shellcurl
curl -X POST https://asyntai.com/api/v1/chat/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "¿Hacen envíos a España?",
    "session_id": "user-8842"
  }'

Respuestas de error

Cada fallo devuelve {"success": false, "error": "..."} con uno de estos códigos de estado.

StatusSignificadoQué hacer
400Cuerpo JSON inválido, falta message, o un website_id que no pertenece a tu cuenta.Corrige los datos enviados. El texto de error indica el problema.
401Falta la clave API, o la clave no corresponde a ninguna cuenta.Revisa el nombre de la cabecera y si la clave se ha regenerado.
403La cuenta usa el plan Free. El acceso a la API requiere Starter, Standard o Pro.Cambiar de plan.
429Límite mensual de mensajes alcanzado. El cuerpo incluye además "limit_reached": true.Reduce el ritmo y cambia de plan, o espera al siguiente periodo de facturación.
503El servicio de IA no pudo responder a esta petición.Reinténtalo tras una espera. El fallo es pasajero.

Comprueba success, no solo el código de estado. Trata el 429 de forma explícita si envías muchas peticiones; si no, un límite alcanzado parece un fallo cualquiera para tus usuarios.

Referencia completa de puntos de acceso

URL base https://asyntai.com/api/v1/. Todos los puntos de acceso usan la misma autenticación.

Chat

MétodoRutaFunción
POST/chat/Enviar un mensaje y recibir una respuesta de IA.

Sitios y agentes

MétodoRutaFunción
GETPOST/websites/Listar tus agentes, o crear uno e iniciar el rastreo.
GET/websites/{id}/Detalles de un agente.
GETPATCH/websites/{id}/settings/Leer o cambiar los ajustes del widget.
GETPUT/websites/{id}/instructions/Leer o sustituir las instrucciones de la IA.

Base de conocimiento

MétodoRutaFunción
GET/knowledge/Listar todo aquello en lo que la IA puede apoyarse.
POST/knowledge/text/Añadir texto sin formato.
POST/knowledge/url/Añadir una página por URL.
POST/knowledge/spreadsheet/Añadir una hoja de cálculo.
GETDELETE/knowledge/{context_id}/Leer o eliminar un elemento.
POSTPUT/knowledge/{context_id}/tags/Gestionar las etiquetas de un elemento.

Conversaciones y datos

MétodoRutaFunción
GET/conversations/Conversaciones anteriores.
GET/sessions/Sesiones con el número de mensajes.
GET/leads/Datos de contacto recogidos por el chatbot.
GET/account/Plan, uso y límites.

Webhooks

MétodoRutaFunción
GETPOST/webhooks/Listar o registrar un webhook.
DELETE/webhooks/{webhook_id}/Eliminar un webhook.

Requisitos y límites

ElementoDetalle
PlanEl acceso a la API requiere un plan de pago: Starter, Standard o Pro. Las cuentas Free reciben un error 403.
Cupo de mensajesLos mensajes de la API se descuentan del mismo cupo mensual que las conversaciones del widget. Consulta la cifra actual con GET /api/v1/account/.
Profundidad del historialSe aportan como contexto hasta 10 mensajes anteriores por session_id.
TransporteSolo HTTPS. Cuerpos de petición y respuesta en JSON.
Cambio de claveRegenera la clave en Ajustes → API. La clave anterior deja de funcionar al instante.

¿Listo para crear con IA?

Crea una cuenta gratuita y prueba el chatbot en el panel. Después elige un plan de pago para obtener tu clave API.

Obtener clave API - requiere plan de pago