Introducción a los Chatbots de IA con OpenAI + WOZTELL

Si actualmente tienes un chatbot de IA, en WOZTELL tienes que configurar la versión 3. La migración es importante porque las configuraciones antiguas basadas en Assistants API dejarán de estar soportadas por OpenAI a partir del 26 de agosto de 2026.

Guía práctica para entender GPT Assistant v1.3.0, Responses API, prompts, bases de conocimiento, herramientas y canales en WOZTELL

Esta guía explica cómo funcionan los nuevos chatbots de inteligencia artificial en WOZTELL utilizando OpenAI y la extensión GPT Assistant v1.3.0.

Con esta extensión, puedes crear asistentes de IA conectados a OpenAI para responder automáticamente en canales como WhatsApp Business, WhatsApp Cloud API, Instagram, Facebook Messenger y Webchat. También puedes usar IA para ayudar a los agentes humanos dentro del Inbox de WOZTELL mediante sugerencias de respuesta.

1. ¿Qué es un chatbot de IA en WOZTELL?

Un chatbot de IA en WOZTELL es un asistente conectado a OpenAI que puede interpretar mensajes de usuarios, generar respuestas automáticas y utilizar herramientas adicionales para responder mejor.

Dependiendo de la configuración, el asistente puede:

• Responder automáticamente a clientes en WhatsApp, Instagram, Facebook Messenger o Webchat.
• Consultar documentos de una base de conocimiento antes de responder.
• Buscar información actualizada en la web.
• Ejecutar funciones externas mediante Function Call.
• Ayudar a agentes humanos con sugerencias de respuesta dentro del Inbox de WOZTELL.

Esto permite automatizar conversaciones repetitivas, mejorar la velocidad de atención, apoyar al equipo comercial y ofrecer respuestas más consistentes en todos los canales conversacionales.

2. ¿Qué es GPT Assistant v1.3.0?

GPT Assistant v1.3.0 es la extensión de WOZTELL que permite conectar una cuenta de OpenAI con los canales conversacionales de WOZTELL.

La configuración principal se divide en tres grandes pasos:

1. API Key Setup: conexión de la cuenta de OpenAI mediante una API Key.
2. Configuration: configuración del modelo, prompt, herramientas, Knowledge Base y sugerencias.
3. Connect to Channel: conexión del asistente a uno o varios canales de WOZTELL.

Una vez configurado, el asistente puede activarse en los canales disponibles dentro de la cuenta de WOZTELL.

3. ¿Qué API usa ahora WOZTELL?

Responses API

La nueva versión de GPT Assistant utiliza Responses API de OpenAI.

Responses API es la API recomendada por OpenAI para nuevas implementaciones de asistentes de IA. Permite trabajar con modelos, instrucciones, contexto y herramientas como File Search, Web Search y Function Call.

En WOZTELL, el contexto conversacional lo gestiona WOZTELL. Esto significa que WOZTELL decide cuántos mensajes anteriores se envían al modelo según la configuración definida en el asistente.

¿Por qué es importante esta migración?

La migración es importante porque las configuraciones antiguas basadas en Assistants API dejarán de estar soportadas por OpenAI a partir del 26 de agosto de 2026.

Por este motivo, los clientes que todavía utilicen configuraciones anteriores deberán migrar sus asistentes a la nueva configuración basada en Responses API.

4. Conceptos básicos de OpenAI

API Key

La API Key es la credencial que permite conectar WOZTELL con la cuenta de OpenAI del cliente.

Sin una API Key válida, WOZTELL no puede hacer solicitudes al modelo ni activar correctamente la configuración del asistente.

Model

El Model es el modelo de OpenAI que genera las respuestas del asistente.

La lista de modelos disponibles se obtiene dinámicamente desde la cuenta de OpenAI conectada. Por eso, no todos los clientes verán exactamente los mismos modelos.

Token

Un token es la unidad de texto que procesa el modelo. Puede ser una palabra, parte de una palabra, un número, un espacio o un signo de puntuación.

El coste de OpenAI suele calcularse en función de los tokens de entrada y salida.

Input Tokens

Son los tokens enviados al modelo. Pueden incluir:

• El mensaje del usuario.
• Las instrucciones del asistente.
• El historial de conversación.
• Fragmentos recuperados desde File Search.
• Resultados de Web Search.
• Datos devueltos por Function Call.

Output Tokens

Son los tokens generados por el modelo en su respuesta.

Context

El contexto es toda la información que se envía al modelo para que pueda responder correctamente.

Puede incluir instrucciones, mensajes anteriores, información de la Knowledge Base, resultados de herramientas y datos externos.

Context Window

La context window es la cantidad máxima de información que un modelo puede procesar en una sola solicitud.

Cuanto más contexto se envía, mayor puede ser el coste y, en algunos casos, más lenta puede ser la respuesta.

5. Cómo elegir el modelo adecuado

La elección del modelo depende del caso de uso, el volumen de conversaciones, la complejidad de las respuestas y el presupuesto disponible.

Antes de publicar precios o hacer una propuesta comercial, se recomienda revisar la página oficial de precios de OpenAI, ya que los modelos y costes pueden cambiar.

6. Cómo se configura el comportamiento del asistente

Instructions / Prompt

Las Instructions, también conocidas como prompt base o system prompt, definen cómo debe comportarse el asistente.

Un buen prompt debe incluir:

• Rol del asistente.
• Tono de comunicación.
• Temas que puede responder.
• Temas que debe evitar.
• Datos que debe solicitar al usuario.
• Reglas de escalado a humano.
• Formato esperado de respuesta.

Ejemplo de prompt base

You are a presales assistant for WOZTELL.

Your goal is to help companies understand how WOZTELL can help them automate conversations across WhatsApp, Instagram, Facebook Messenger, and Webchat.

Be friendly, concise, and professional.

Only answer questions related to WOZTELL, WhatsApp Business Platform, AI chatbots, integrations, automation, and conversational channels.

If the user asks about something unrelated, politely explain that you can only help with WOZTELL-related topics.

Before qualifying the lead, ask for their name, company, website, and main use case.

Negative Constraints

Las negative constraints son reglas que indican lo que el asistente no debe hacer.

Do not invent prices.
Do not promise implementation timelines unless confirmed.
Do not answer questions outside the scope of WOZTELL.
Do not provide legal, financial or medical advice.
Do not say you are an AI unless the user asks directly.

Human Handover / Escalation

El Human Handover o escalado a humano ocurre cuando el asistente debe derivar la conversación a un agente.

Se recomienda escalar cuando:

• El usuario pide hablar con una persona.
• Hay una consulta de pricing.
• Hay una incidencia técnica.
• Hay dudas sobre facturación.
• El asistente no tiene información suficiente.
• La conversación requiere validación humana.

7. Herramientas disponibles en GPT Assistant

File Search

File Search permite al asistente buscar información dentro de una Knowledge Base antes de responder.

Es útil cuando el asistente debe responder a partir de documentación oficial, FAQs, guías de producto, procesos internos o material comercial.

Web Search

Web Search permite al asistente buscar información actualizada en internet.

Se recomienda usarlo cuando la respuesta depende de información que puede cambiar, como documentación externa, precios, regulaciones, novedades o información pública reciente.

Domain Filtering

Domain Filtering permite limitar las búsquedas web a dominios específicos.

Ejemplo correcto:

woztell.com
support.woztell.com
openai.com

Ejemplo incorrecto:

https://woztell.com/

Function Call

Function Call permite que el asistente llame a una función externa para consultar datos o ejecutar una acción.

Ejemplos de uso:

• Consultar el estado de un pedido.
• Verificar una cita.
• Buscar datos de un cliente.
• Crear un ticket.
• Enviar información a un CRM.
• Validar disponibilidad.

8. Knowledge Base y Vector Stores

Knowledge Base

La Knowledge Base es el conjunto de documentos que el asistente puede consultar para responder preguntas.

Puede incluir:

• FAQs.
• Guías de instalación.
• Documentación de producto.
• Argumentarios comerciales.
• Políticas internas.
• Material de soporte.

Vector Store

El Vector Store es el contenedor técnico donde se guardan los documentos procesados para que el asistente pueda buscar información relevante.

Forma simple de entenderlo:

• Knowledge Base: biblioteca de documentos.
• Vector Store: contenedor técnico donde se indexan los documentos.
• File Search: herramienta que busca dentro de esa biblioteca.

Retrieval

El Retrieval es el proceso mediante el cual el asistente recupera fragmentos relevantes de la Knowledge Base y los usa como contexto adicional para responder.

Buenas prácticas

• Usar documentos claros y actualizados.
• Eliminar información antigua.
• Evitar documentos duplicados.
• No mezclar versiones contradictorias.
• Separar documentación técnica, comercial y de soporte cuando sea necesario.
• Revisar la Knowledge Base periódicamente.

9. AI Chatbot and AI Inbox Replies

AI Chatbot

El AI Chatbot responde automáticamente a los usuarios finales en canales como WhatsApp, Instagram, Facebook Messenger y Webchat.

AI Inbox Replies

AI Inbox Replies ayuda a los agentes humanos generando sugerencias de respuesta dentro del Inbox de WOZTELL. El agente puede revisar, editar y enviar la respuesta manualmente.

SuggestGPT

SuggestGPT permite generar sugerencias iniciales o preguntas de inicio para orientar al usuario antes de que escriba su primer mensaje.

10. Conexión a canales

Channel

El Channel es el canal de comunicación donde el asistente responderá a los usuarios.

Canales soportados:

• WhatsApp Business
• WhatsApp Cloud API
• Instagram
• Facebook Messenger
• Webchat

Environment

El Environment es un entorno dentro de un canal que permite separar pruebas, desarrollo y producción.

Si no se ha creado ningún entorno adicional, se utilizará el entorno por defecto.

Prefix Name

El Prefix Name es el nombre identificador de la configuración del asistente conectada a un canal o entorno específico.

Ejemplos:

AI-CHATBOT-WHATSAPP-PRESALES
AI-CHATBOT-INSTAGRAM-SUPPORT
AI-CHATBOT-WEBCHAT-FAQ
AI-CHATBOT-FACEBOOK-LEADS

Connect

Connect vincula el asistente al canal seleccionado y lo activa.

Disconnect

Disconnect desvincula el asistente del canal seleccionado.

Go Live

Go Live es el momento en que el asistente queda activo en un canal real y empieza a responder a usuarios finales.

11. Costes y control de consumo en Open AI

El coste de uso de OpenAI depende principalmente del modelo, los tokens procesados y las herramientas utilizadas.

Factores que pueden aumentar el coste

• Prompts demasiado largos.
• Historial de conversación muy amplio.
• Respuestas muy extensas.
• Uso frecuente de File Search.
• Uso frecuente de Web Search.
• Modelos más avanzados.
• Audios largos que requieren transcripción.
• Knowledge Bases grandes o mal estructuradas.

Buenas prácticas de Cost Control

• Usar modelos eficientes para casos de alto volumen.
• Limitar el número de mensajes anteriores enviados como contexto.
• Mantener respuestas concisas.
• Activar Web Search solo cuando sea necesario.
• Mantener la Knowledge Base limpia y actualizada.
• Escalar a humano cuando la conversación sea compleja.
• Revisar logs y consumo periódicamente.

12. Calidad, precisión y prevención de respuestas inventadas

Hallucination

Una hallucination es una respuesta generada por el modelo que puede sonar correcta, pero que no está basada en información real o confirmada.

Cómo reducir hallucinations

• Usar instrucciones claras.
• Limitar el alcance del asistente.
• Activar File Search cuando exista documentación oficial.
• Mantener la Knowledge Base actualizada.
• Indicar al asistente que no invente información.
• Definir reglas claras de escalado a humano.

If the answer is not available in the Knowledge Base or confirmed documentation, do not invent it. Ask the user to contact the WOZTELL team or escalate to a human agent.

Grounding

El grounding consiste en basar las respuestas del asistente en fuentes concretas, como documentos de la Knowledge Base, resultados de Web Search o datos devueltos por una Function Call.

13. Logs y troubleshooting

Logs

Los logs son registros técnicos que muestran eventos, solicitudes y errores generados durante el funcionamiento del asistente.

Sirven para diagnosticar problemas relacionados con:

• API Key.
• Modelos.
• Parámetros incompatibles.
• Canales.
• File Search.
• Web Search.
• Function Call.
• Errores de OpenAI.

14. Checklist antes de activar el asistente

• API Key válida y guardada.
• Modelo seleccionado correctamente.
• Prompt claro y probado.
• Reglas de escalado definidas.
• Temperature adecuada.
• Historial de chat limitado.
• Formato configurado como Text para chatbots normales.
• Knowledge Base actualizada si se usa File Search.
• Web Search limitado a dominios aprobados si aplica.
• Function Call probada si se usa integración externa.
• Canal correcto conectado.
• Environment correcto seleccionado.
• Prefix Name claro.
• Pruebas realizadas antes de Go Live.
• Logs revisados después de las primeras conversaciones.
  

Los nuevos chatbots de IA de WOZTELL basados en OpenAI y Responses API permiten crear asistentes más flexibles, conectados a múltiples canales y preparados para usar herramientas como File Search, Web Search y Function Call.

Esta nueva arquitectura sustituye progresivamente a las configuraciones anteriores basadas en Assistants API. Por ello, los clientes que todavía utilicen asistentes antiguos deberán migrar antes del 26 de agosto de 2026.

Configurar correctamente el modelo, el prompt, la Knowledge Base, las herramientas, el canal y las reglas de escalado es esencial para crear un asistente fiable, útil y controlado en coste.