Qué necesitas
- Una web configurada con nosotros, con un plan de pago (Básico, Estándar, Élite o Empresa). Si aún no la tienes, regístrate con tu e-mail e indica la dirección de tu web.
- Una clave de API: en tu panel, abre Apps de chat y API, ponle un nombre a la clave (por ejemplo “AstrBot”) y pulsa Crear clave de API. Cópiala en ese momento: solo se muestra esa vez.
- AstrBot (u otra herramienta) en marcha y conectado a tu app de chat. La documentación de AstrBot explica cómo instalarlo y conectar Discord, Telegram, Slack, WeChat o QQ.
Estos son los tres datos que te pide cualquier herramienta:
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistantConfigúralo en AstrBot
- Abre el panel de AstrBot y ve a Providers. En la pestaña Chat Completion, pulsa + Add junto a Provider Sources.
- En New model provider, elige OpenAI Compatible.
- Dale un ID que reconozcas, como
7x24hrs. Pega tu clave en API Key y ponhttps://7x24hrs.com/v1en API Base URL. - Pulsa Save And Fetch Models. En Available Models, pulsa + junto a
7x24hrs-assistant. En la ventana que se abre, deja marcada solo Text en Model capabilities (desmarca Image, Audio y Tool use: el asistente responde con texto) y pulsa Save. - Haz que sea el modelo que usa tu bot: en Config, elígelo como modelo de chat predeterminado (o elígelo para una sola conversación con el selector de modelo de Chat).
- Haz una pregunta en la página Chat de AstrBot o en tu app de chat conectada. La respuesta sale de los datos de tu web.
Deja vacíos la persona y el prompt de sistema de AstrBot, o que sean breves: tu asistente sigue las reglas y el personaje que configuras en el panel de 7x24hrs y no acepta instrucciones del prompt de sistema de la app de chat.
Dify, LobeChat y otras herramientas
Cualquier herramienta con un proveedor “compatible con OpenAI” u “OpenAI personalizado” funciona igual: URL base https://7x24hrs.com/v1, tu clave de API y el modelo 7x24hrs-assistant.
- Dify: en Settings → Model Provider, añade OpenAI-API-compatible, escribe el nombre del modelo, tu clave y la URL base como endpoint de la API, y luego usa el modelo en tu app.
- LobeChat: en los ajustes, en la sección de modelos de lenguaje, activa el proveedor OpenAI, escribe tu clave, pon la URL base como dirección del proxy de la API y añade
7x24hrs-assistanta la lista de modelos. - Tu propio código: llama a la API con cualquier librería cliente de OpenAI, indicando la URL base y la clave.
Para probar la API desde un terminal:
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Con "stream": true la respuesta llega como server-sent events, igual que en OpenAI:
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Cómo funcionan las respuestas en las apps de chat
| Botón de chat en tu web | App de chat a través de la API | |
|---|---|---|
| Responde con | Los datos de tu web, tus respuestas estándar y tu personaje | Lo mismo |
| Cuando no está seguro | Lo dice y te pasa al visitante | Lo dice y da tu dirección de contacto en la respuesta |
| Avisos para ti | Por e-mail, Slack, Discord o Telegram | Igual, marcados “vía API / AstrBot” |
| Responder tú al visitante | Desde tu app de chat o tu panel | No es posible desde aquí: contesta por e-mail |
| Conversaciones que cuentan | Una por visitante y conversación | Igual, del mismo cupo mensual |
¿Qué planes incluyen las apps de chat?
Todos los planes de pago: Básico a $19 al mes por 90 conversaciones, Estándar a $59 por 275, Élite a $199 por 1000 y Empresa a $1,099 por 6000. Las conversaciones a través de la API se descuentan del mismo cupo mensual que las del botón de chat. El plan gratuito no incluye apps de chat: las claves creadas con él quedan en pausa hasta que elijas un plan de pago. Consulta los precios.
¿Qué cuenta como una conversación?
Un visitante que chatea, haga las preguntas que haga, exactamente igual que con el botón de chat. Las herramientas que envían un campo user en cada petición nos permiten distinguir a los visitantes; si no, una conversación se reconoce por su primer mensaje.
¿Un prompt de sistema en AstrBot puede cambiar lo que dice el asistente?
No. Los prompts de sistema que envía la app de chat no se siguen. El asistente mantiene tus reglas: responde solo con los datos de tu web, dice cuando no sabe algo y no promete nada que tu web no diga. Su personaje es el que configuras en el panel.
¿Admite imágenes, mensajes de voz o llamadas a herramientas?
Todavía no. Se responde al texto; las imágenes y otros adjuntos se descartan del mensaje, y un mensaje sin texto recibe un error claro. Las definiciones de herramientas que envía el cliente se ignoran.
¿Y si se filtra una clave?
Revócala en Apps de chat y API: deja de funcionar al instante. Después crea otra y pégala en tu herramienta. Las claves solo se guardan como huella, así que tampoco nosotros podemos volver a mostrarte una clave.