Cómo implementar un chatbot en un sitio web, paso a paso
Aprender a implementar un chatbot en proyectos web se reduce a tres partes: un cuadro de chat en el navegador, un pequeño backend que contiene tu clave de API y una llamada a un endpoint compatible con OpenAI. Esta guía construye cada parte con código funcional.
Actualizado

Puntos clave
- Nunca llames a la API desde el código del navegador. Mantén la clave en un servidor y expón tu propia ruta /api/chat.
- La API es compatible con OpenAI, por lo que los SDK estándar funcionan después de configurar la base URL y usar el modelo uncensored.
- Transmite respuestas para que la página se sienta rápida y limita el historial en el servidor.
- Gestiona las respuestas 429 y establece un límite por visitante, ya que una clave completa permite 8 peticiones simultáneas.
La arquitectura en una imagen
La forma habitual de implementar un chatbot en proyectos web es una relay de tres pasos. El visitante escribe en un cuadro de chat. Tu página envía el mensaje a tu propio servidor. Tu servidor llama a la API del modelo con tu clave secreta y pasa la respuesta de vuelta. El navegador nunca ve la clave.
Esto es importante porque cualquier cosa en JavaScript front-end es pública. Si pones la clave en una etiqueta script, cualquiera que abra las herramientas de desarrollo puede copiarla y gastar tu saldo. Una ruta de backend también te da un lugar para agregar límites de tasa, recorte de historial, registro y un control de edad. Para un recorrido más largo de una página terminada, consulta el tutorial de chat web.
Paso 1: obtener una clave y probar el endpoint
Regístrate con Google o con correo electrónico y contraseña, luego reclama la prueba gratis en la página de clave de API. La prueba es de $0,50 de crédito, válido por 7 días, uno por persona y no requiere pago. Guarda la clave como una variable de entorno, no en tu código.
Verifica que funcione con curl antes de escribir cualquier código de aplicación:
export API_KEY="YOUR_KEY"
curl https://api.uncensoredchatbotapi.com/v1/models -H "Authorization: Bearer $API_KEY"
curl https://api.uncensoredchatbotapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in five words."}]}'La primera llamada enumera modelos y la segunda devuelve un completado de chat. Si ambas tienen éxito, la clave y la base URL son correctas. Un 401 significa que la clave es incorrecta o le falta el prefijo Bearer.
Paso 2: escribir la ruta del backend
El ejemplo a continuación usa Node 18 o superior, Express y el paquete oficial openai. Instálalos con npm install express openai y establece "type": "module" en package.json.
import express from "express";
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredchatbotapi.com/v1",
apiKey: process.env.API_KEY,
});
const SYSTEM = "You are a helpful assistant for our website. Keep answers under 150 words.";
const app = express();
app.use(express.json({ limit: "100kb" }));
app.use(express.static("public"));
app.post("/api/chat", async (req, res) => {
const incoming = Array.isArray(req.body.messages) ? req.body.messages : [];
const history = incoming.slice(-10).map((m) => ({
role: m.role === "assistant" ? "assistant" : "user",
content: String(m.content).slice(0, 4000),
}));
try {
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "system", content: SYSTEM }, ...history],
stream: true,
});
res.setHeader("Content-Type", "text/plain; charset=utf-8");
for await (const chunk of stream) {
const text = chunk.choices[0]?.delta?.content;
if (text) res.write(text);
}
} catch (err) {
if (res.headersSent === false) res.status(err.status === 429 ? 429 : 502);
}
res.end();
});
app.listen(3000, () => console.log("Listening on http://localhost:3000"));Tres detalles hacen el trabajo real aquí. El servidor reconstruye la lista de mensajes él mismo, por lo que un visitante no puede inyectar un mensaje de sistema falso. Solo mantiene los últimos 10 mensajes y los corta a 4.000 caracteres, lo que controla el costo. Y siempre establece los roles explícitamente, mapeando cualquier desconocido a user.
Paso 3: construir la caja de chat
Pon esto en public/index.html. Usa JavaScript puro sin framework, para que puedas pegarlo en una plantilla existente.
<div id="log"></div>
<form id="form">
<input id="input" autocomplete="off" required />
<button>Send</button>
</form>
<script>
const messages = [];
const log = document.getElementById("log");
document.getElementById("form").addEventListener("submit", async (e) => {
e.preventDefault();
const input = document.getElementById("input");
messages.push({ role: "user", content: input.value });
log.insertAdjacentHTML("beforeend", "<p></p>");
log.lastElementChild.textContent = "You: " + input.value;
input.value = "";
const reply = document.createElement("p");
log.appendChild(reply);
const res = await fetch("/api/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ messages }),
});
if (res.ok === false) { reply.textContent = "Busy, please try again in a moment."; return; }
const reader = res.body.getReader();
const decoder = new TextDecoder();
let full = "";
while (true) {
const { done, value } = await reader.read();
if (done) break;
full += decoder.decode(value, { stream: true });
reply.textContent = full;
}
messages.push({ role: "assistant", content: full });
});
</script>Usar textContent en lugar de innerHTML para la salida del modelo evita que la respuesta inyecte marcado en tu página. Mantén ese hábito incluso cuando el modelo se comporte bien.
Paso 4: manejar límites y errores
Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. Una clave de prueba permite 2 simultáneas y 60 por minuto. Cuando superas el límite, la API devuelve HTTP 429 con un código de error: rate_limited para peticiones por minuto o concurrency para demasiadas a la vez. En sobrecarga temporal también devuelve 429 con un encabezado Retry-After: 5.
Se aplican dos reglas prácticas. Primero, reintenta el 429 tras el retardo con un backoff corto y muestra un mensaje amigable al visitante si sigue fallando. Segundo, recuerda que una petición en streaming ocupa un espacio de concurrencia hasta que finaliza el flujo. Si diez visitantes hacen streaming a la vez con una clave completa, dos serán rechazados, así que añade una pequeña cola o un límite por visitante en tu servidor. Un contador en memoria con la IP como clave es suficiente para un sitio pequeño.
Los encabezados de respuesta te ayudan a depurar: X-Request-Id identifica una llamada si contactas a soporte, y X-Balance-USD muestra tu crédito restante. El límite del cuerpo de la petición es de 8 MB, muy por encima de lo que necesita un chat, y la ventana de contexto es de 100.000 tokens.
Errores comunes al implementar
El código anterior funciona en localhost. Estos son los problemas que aparecen una vez que está en un servidor real.
- Proxies de almacenamiento. Algunos proxies inversos retienen las respuestas en streaming hasta que terminan, por lo que la respuesta aparece de golpe. Si usas nginx, desactiva el almacenamiento de respuesta para la ruta del chat. Prueba el streaming a través de la misma cadena de proxies que usas en producción, no solo en tu portátil.
- Claves en el repositorio. Mantén la clave en una variable de entorno o una tienda de secretos y agrega cualquier archivo de entorno local a tu lista de ignorados. Si una clave llega a un repositorio público, crea una nueva y deja de usar la antigua.
- Confiar en el cliente. El navegador envía el historial de chat, por lo que un visitante puede editarlo. Por eso el servidor en el paso 2 establece los roles él mismo y corta la longitud del mensaje. Nunca aceptes un mensaje de sistema desde el cliente.
- Llamadas de origen cruzado. Si tu página y tu backend viven en dominios diferentes, el navegador bloqueará la petición hasta que tu servidor envíe los encabezados CORS adecuados. Servir ambos desde un mismo origen evita el problema.
- Coste descontrolado. Un visitante automatizado puede enviar cientos de mensajes. Cuenta las peticiones por IP o sesión en el servidor y rechaza cuando el número sea muy alto. También limita la longitud del mensaje, como hace el ejemplo.
- Markdown y enlaces. Los modelos suelen responder con listas y bloques de código. Decide si los renderizas o muestras texto plano, y nunca insertes el texto de la respuesta como HTML sin procesar.
Una última comprobación es el diseño móvil. La mayor parte del tráfico de chat en sitios públicos proviene de teléfonos, así que prueba con una pantalla estrecha, un teclado software abierto y una conexión inestable. Si el flujo se interrumpe a mitad, el visitante debería poder reenviar sin perder el hilo.
Extender el bot más tarde
Una vez que el intermediario básico funciona, la misma ruta puede hacer más, porque la API admite las características estándar de OpenAI. Puedes pedir salida estructurada con modo JSON estableciendo response_format a {"type": "json_object"} y diciendo en el prompt que la respuesta debe ser JSON. Eso sirve para un formulario de captación que convierte un mensaje de texto libre en campos como nombre, tema y urgencia.
Las llamadas a funciones permiten que el modelo pida a tu servidor que ejecute una función, como buscar un pedido o verificar el horario de apertura. Pasas una lista tools, lees los tool_calls en la respuesta, ejecutas la función tú mismo y envías el resultado de vuelta como un mensaje con role: "tool". El modelo escribe luego la respuesta final con tus datos. Así un bot web obtiene información real en lugar de adivinar.
Los parámetros de muestreo también están a tu disposición. Una temperatura más baja se adapta a centros de ayuda basados en hechos y una más alta se adapta a la narración de historias. Añade un cambio a la vez y compara los resultados en las mismas cinco preguntas de prueba.
Paso 5: dar forma al bot y ponerlo en línea
El prompt del sistema define tu bot. Dile quién es, de qué trata y cuánto deben durar las respuestas. Si el personaje tiene una personalidad, las notas sobre diseño de la personalidad profundizan más. Debido a que el modelo está ajustado para responder sin filtros de contenido para uso adulto lícito, las barreras para tu audiencia son tuyas para escribir: una confirmación de edad, un enlace de reporte y una lista clara de lo que el bot no discutirá. El contenido sexual que involucre a menores de edad nunca está permitido. Consulta la página sobre uso responsable y salvaguardas antes del lanzamiento.
En cuanto al coste, pagas $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. Una respuesta con 1.200 tokens de entrada y 300 de salida cuesta $0,00018 más $0,00015, lo que es $0,00033. Una recarga de $20 cubre más de 60.000 de estas respuestas. Las recargas van de $20 a $500, con +5% desde $50, +10% desde $100 y +15% desde $200, pagadas en USDT en TRC20 o USDC en Base. El crédito no caduca. La página de precios tiene los detalles, y la documentación enumera cada parámetro admitido, incluyendo llamadas a funciones y modo JSON.
Antes de lanzar, prueba con algunas conversaciones largas, observa los registros para 429s y confirma que tu servidor recorta el historial. Los prompts no se usan para entrenamiento, pero aún debes decirle a tus visitantes qué almacenas.
Más guías
Preguntas y respuestas
¿Puedo llamar a la API directamente desde JavaScript en el navegador?
Puedes, pero no deberías. La clave sería visible para todos los visitantes. Enruta las peticiones a través de tu propio servidor y mantén la clave en una variable de entorno.
¿Qué lenguajes y SDKs funcionan?
Cualquier SDK de OpenAI o cliente HTTP. Establece la base URL a https://api.uncensoredchatbotapi.com/v1, usa tu clave como token Bearer y establece el modelo a uncensored. Python, Node y curl funcionan todos.
¿Funciona el streaming en un navegador?
Sí. La API transmite sobre SSE con stream establecido en true. El ejemplo retransmite el texto a través de tu servidor con fetch y un lector de stream.
¿Qué sucede cuando alcanzas el límite de peticiones?
Obtienes HTTP 429 con el código rate_limited o concurrency. Espera y reintenta. Para sobrecarga temporal, el encabezado Retry-After es de 5 segundos.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.