Cómo crear un chatbot con IA de OpenAI en WOZTELL | Guia de Usuario
Cómo crear un chatbot con IA de OpenAI en WOZTELL
Conecta un asistente impulsado por OpenAI a WhatsApp, Instagram, Facebook Messenger y Webchat.
Esta guía explica cómo configurar un chatbot con inteligencia artificial en WOZTELL utilizando la extensión GPT Assistant y la Responses API de OpenAI.
Con esta extensión, puedes crear un asistente que responda automáticamente en WhatsApp Business Platform, Instagram, Facebook Messenger y Webchat. También puedes activar sugerencias de respuesta con IA dentro del WOZTELL Inbox para ayudar a los agentes humanos durante conversaciones en vivo.
| Paso de configuración | Qué vas a configurar |
|---|---|
| 1 | Añadir tu OpenAI API Key. |
| 2 | Configurar tu AI Chatbot, AI Inbox Replies, Knowledge Base y herramientas. |
| 3 | Conectar el asistente a uno o varios canales de WOZTELL. |
Paso 1 — Instalar la extensión GPT Assistant
1.1 Acceder al Marketplace
Ve a Marketplace → + New Extension.
En Marketplace, busca la tarjeta de la extensión ChatGPT: Artificial Intelligence · OpenAI | WOZTELL. Después haz clic en Learn More.
1.2 Configurar la instalación
| Campo | Qué hacer |
|---|---|
| Extension Version | Selecciona v1.3.0. |
| Alias | Introduce un nombre único en minúsculas y sin espacios, por ejemplo: my-gpt-assistant. |
| Description | Opcional. Añade una descripción breve sobre lo que hará este asistente. |
Haz clic en Install. Si aparece el error “App Integration with alias already exists”, utiliza un alias diferente.
Una vez instalada, haz clic en el nombre de la extensión dentro de Installed Extensions para abrir la ventana de configuración. Verás tres secciones: API Key Setup, Configuration y Connect to Channel.
Paso 2 — Añadir tu OpenAI API Key
La OpenAI API Key es necesaria para acceder a las secciones de configuración y conexión de canales. Esta clave permite que WOZTELL envíe solicitudes a tu cuenta de OpenAI.
2.1 Generar tu API Key en OpenAI
En la sección API Key Setup, haz clic en generate one here. Esto abrirá platform.openai.com en una nueva pestaña.
- Ve a API Keys.
- Haz clic en + Create new secret key.
- Añade un nombre descriptivo, por ejemplo:
woztell-gpt-assistant. - Deja el proyecto como Default, salvo que tu cuenta de OpenAI utilice una estructura específica de proyectos.
- Haz clic en Create secret key.
- Copia la clave inmediatamente.
2.2 Pegar la clave en WOZTELL
Vuelve a WOZTELL y pega la clave en el campo API Key. Haz clic en Save. Una marca verde confirma que la clave es válida. Una vez guardada, las secciones Configuration y Connect to Channel estarán disponibles.
Paso 3 — Configurar el asistente de IA
La sección Configuration define cómo se comporta tu asistente. Incluye tres áreas principales:
| Área | Para qué sirve |
|---|---|
| AI Chatbot | Configura respuestas automáticas del chatbot en los canales conectados. |
| AI Inbox Replies | Genera sugerencias de respuesta con IA para agentes humanos dentro del WOZTELL Inbox. |
| Knowledge Base | Permite subir documentos que el asistente puede consultar al responder preguntas. |
3.1 AI Chatbot — Configuración principal
La sección AI Chatbot controla el comportamiento del asistente cuando responde automáticamente a los usuarios. Para un chatbot básico, solo necesitas configurar Model e Instructions.
| Campo | Qué hacer |
|---|---|
| Model | Selecciona el modelo de OpenAI que generará las respuestas. La lista se obtiene en tiempo real desde tu cuenta de OpenAI. Punto de partida recomendado: gpt-4o mini, porque es rápido, asequible y fiable para la mayoría de casos de uso de chatbot. |
| Transcription Model | Se utiliza para convertir mensajes de voz en texto. El modelo por defecto suele ser whisper-1. Déjalo sin cambios salvo que tengas una razón específica para modificarlo. |
| Instructions | El prompt de sistema que define el rol, tono, reglas y comportamiento del asistente. Estas instrucciones se envían al modelo antes de cada conversación. |
WOZTELL también ofrece un generador de prompts para ayudarte a crear mejores instrucciones para tu asistente:
https://woztell.com/perfect-prompt-generator/
Cómo escribir buenas instrucciones
Tus instrucciones deben definir claramente el rol, tono, alcance, tareas y reglas de escalado del asistente.
Eres un asistente de preventa para WOZTELL.
Tu objetivo es ayudar a las empresas a entender cómo WOZTELL puede ayudarles a automatizar conversaciones en WhatsApp, Instagram, Facebook Messenger y Webchat.
Sé amable, claro, breve y profesional.
Responde únicamente preguntas relacionadas con WOZTELL, WhatsApp Business Platform, chatbots con IA, integraciones, automatización y canales conversacionales.
Si el usuario pregunta algo que no está relacionado, explica de forma educada que solo puedes ayudar con temas relacionados con WOZTELL.
Antes de calificar el lead, pregunta por su nombre, empresa, sitio web y caso de uso principal.
| Elemento de la instrucción | Ejemplo |
|---|---|
| Rol | Eres un asistente de preventa para WOZTELL. |
| Tono | Sé amable, claro, breve y profesional. |
| Alcance | Responde solo preguntas sobre productos y servicios de WOZTELL. |
| Tareas | Pregunta por el nombre, empresa, sitio web y caso de uso antes de calificar el lead. |
| Escalado | Si el usuario pregunta por precios, integraciones complejas o soporte técnico, recomienda hablar con el equipo de WOZTELL. |
3.2 Advanced Settings
Estos campos son opcionales. La mayoría de usuarios puede dejarlos con los valores por defecto. Úsalos solo si necesitas más control sobre el comportamiento del asistente o si estás trabajando en una integración personalizada.
| Campo | Qué hace | Recomendación |
|---|---|---|
| Temperature | Controla qué tan creativas o consistentes son las respuestas. Los valores bajos generan respuestas más predecibles; los valores altos generan respuestas más variadas. | Recomendado: 0.5. Algunos modelos pueden no soportar este parámetro. Si no es compatible, aparecerá un error en los logs. |
| Top P | Forma alternativa de controlar la diversidad de las respuestas. | Usa Temperature o Top P, pero no ambos al mismo tiempo. |
| Number of chat history messages used to provide context | Define cuántos mensajes anteriores se envían como contexto al generar una nueva respuesta. | Por defecto: 10. Valores más altos pueden mejorar el contexto, pero aumentan el consumo de tokens. Máximo aproximado: 20 mensajes. |
| Max Chat Session Duration | Define cuántos días permanece activa una sesión. Cuando la sesión expira, se crea un nuevo thread y se recarga el contexto anterior. | Por defecto: 3 días. Sesiones más largas pueden aumentar el consumo de tokens. |
| Format | Define la estructura de salida esperada. | Usa Text para chatbots normales. Usa JSON Schema o JSON Object solo para integraciones técnicas. |
3.3 Tools
Las herramientas permiten que tu asistente acceda a información adicional o realice acciones externas. Para añadir una herramienta, haz clic en el icono + junto a Tools.
Web Search
Web Search permite que el asistente busque información en internet en tiempo real. Úsalo cuando el asistente necesite responder con información actualizada. También puedes usar Domain Filtering para limitar la búsqueda a sitios web específicos.
Ejemplos correctos de filtrado por dominio:
woztell.com
support.woztell.com
No introduzcas la URL completa con https://.
File Search
File Search permite que el asistente busque información en archivos almacenados en una Knowledge Base / Vector Store. Úsalo cuando el asistente deba responder basándose en documentos subidos, FAQs, documentación de producto, guías internas o material comercial.
Antes de usar File Search, debes crear una Knowledge Base y subir archivos. Después, selecciona el Vector Store correspondiente dentro de la herramienta File Search.
Function Call
Function Call permite que el asistente ejecute acciones externas, como consultar el estado de un pedido, recuperar datos de un cliente o activar un flujo de trabajo. Esta opción requiere una integración técnica personalizada. La mayoría de usuarios no la necesita para una configuración básica.
3.4 AI Inbox Replies
AI Inbox Replies ayuda a los agentes humanos a responder más rápido desde el WOZTELL Inbox. A diferencia del AI Chatbot, esta función no responde automáticamente al cliente. En su lugar, genera respuestas sugeridas que los agentes pueden revisar, editar y enviar manualmente.
| Usa AI Inbox Replies cuando... | Motivo |
|---|---|
| Un agente está gestionando una conversación en vivo. | El agente mantiene el control mientras recibe apoyo de la IA. |
| El equipo quiere responder más rápido. | Las sugerencias reducen el tiempo de redacción. |
| La conversación requiere empatía o validación humana. | El agente puede ajustar la respuesta antes de enviarla. |
| El caso de uso aplica a todo el Inbox. | El prompt debe ser general, no limitado a un único flujo de chatbot. |
Cómo configurar AI Inbox Replies
| Campo | Qué hacer |
|---|---|
| Model | Selecciona el modelo de OpenAI que generará las sugerencias de respuesta. |
| Instructions | Define cómo debe redactar el asistente las respuestas sugeridas para los agentes. Este prompt debe ser general porque aplica globalmente al WOZTELL Inbox. |
Eres un asistente de IA que ayuda a los agentes de WOZTELL a escribir mejores respuestas dentro del Inbox.
Genera sugerencias claras, breves y profesionales basadas en el contexto de la conversación.
No hagas promesas sobre precios, tiempos de entrega, viabilidad técnica o condiciones contractuales salvo que estén confirmadas explícitamente en la conversación.
Mantén un tono amable y útil.
Si el cliente pide algo que requiere validación humana, sugiere escalar la conversación al equipo correspondiente.
| Campo | Qué hace | Recomendación |
|---|---|---|
| Temperature | Controla qué tan creativas son las sugerencias. | Recomendado: 0.5. |
| Max Tokens | Define la longitud máxima de cada sugerencia. Valores más altos permiten respuestas más largas. | Usa un valor moderado para mantener respuestas concisas. |
| Number of Suggestions | Define cuántas opciones de respuesta se generan por cada mensaje. | Recomendado: 2 o 3 sugerencias. |
| Previous messages used as context | Define cuántos mensajes anteriores se usan para generar la sugerencia. | Recomendado: 5. Más contexto puede mejorar la precisión, pero aumenta el coste. |
3.5 Knowledge Base — Vector Stores
La Knowledge Base permite subir documentos que el asistente puede consultar al responder preguntas. Un Vector Store funciona como una carpeta: puedes subir varios archivos a la misma Knowledge Base y eliminar archivos individuales o toda la carpeta cuando sea necesario.
| Usa una Knowledge Base para... | Ejemplos |
|---|---|
| Documentación de producto | Guías de funcionalidades, instrucciones de configuración, documentación técnica. |
| FAQs | Preguntas frecuentes sobre precios, onboarding, canales, integraciones o soporte. |
| Material comercial | Sales decks, one-pagers, descripciones de servicio. |
| Procesos internos | Reglas de escalado, playbooks de soporte, reglas de calificación. |
Cómo crear una Knowledge Base
- Haz clic en + New Knowledge Base.
- Introduce un nombre descriptivo, por ejemplo:
woztell-faq. - Haz clic en el icono de subida.
- Arrastra y suelta tus archivos, o selecciónalos desde tu dispositivo.
- Espera a que los documentos se procesen.
- Vuelve a la configuración de AI Chatbot.
- Añade la herramienta File Search.
- Selecciona la Knowledge Base / Vector Store que has creado.
Paso 4 — Conectar el asistente a un canal
La sección Connect to Channel permite elegir dónde estará activo el asistente. Puedes conectar el mismo asistente a uno o varios canales de tu cuenta de WOZTELL.
| Asistente de ejemplo | Canal | Caso de uso |
|---|---|---|
| AI-CHATBOT-WHATSAPP-PRESALES | Calificación de leads y preguntas comerciales. | |
| AI-CHATBOT-INSTAGRAM-SUPPORT | Social commerce y soporte. | |
| AI-CHATBOT-WEBCHAT-FAQ | Webchat | Automatización de preguntas frecuentes en la web. |
| AI-CHATBOT-FACEBOOK-LEADS | Facebook Messenger | Gestión de leads entrantes. |
Entender canales y entornos
Un canal es el canal de comunicación conectado a WOZTELL, como WhatsApp, Instagram, Facebook Messenger o Webchat.
Un entorno es un espacio dentro de un canal que puede utilizarse para separar configuraciones de prueba, desarrollo o producción. Si no has creado entornos adicionales, el asistente utilizará el entorno default.
- Probar un chatbot antes de publicarlo.
- Habilitar usuarios concretos para pruebas.
- Separar configuraciones de desarrollo y producción.
- Ejecutar diferentes asistentes en distintos contextos.
Cómo conectar el asistente
- Ve a Section 3 — Connect to Channel.
- Busca el canal y entorno donde quieres activar el asistente.
- Haz clic en Connect.
- Introduce un Prefix Name si se solicita.
- Haz clic en Confirm.
- Haz clic de nuevo en Connect.
Una vez conectado, el botón cambiará a Disconnect. Esto significa que el chatbot está activo en ese canal y entorno.
Qué es el Prefix Name
El Prefix Name ayuda a identificar el asistente conectado a ese canal o entorno específico. Usa un nombre claro que explique el canal y el caso de uso.
AI-CHATBOT-WHATSAPP-PRESALES
AI-CHATBOT-INSTAGRAM-SUPPORT
AI-CHATBOT-WEBCHAT-FAQ
AI-CHATBOT-FACEBOOK-LEADS
Estructura recomendada:
AI-CHATBOT-[CANAL]-[CASO-DE-USO]
Paso 5 — Probar tu chatbot
Después de conectar el asistente, pruébalo antes de usarlo con clientes reales.
Proceso de prueba recomendado
- Ve al canal conectado en WOZTELL.
- Envía un mensaje desde otro dispositivo, cuenta o número.
- Comprueba si el asistente responde correctamente.
- Verifica que la respuesta coincide con tus Instructions.
- Prueba diferentes tipos de preguntas.
- Prueba casos límite, como preguntas fuera del alcance del asistente.
- Revisa los logs si algo no funciona como esperas.
Preguntas de prueba sugeridas
Para un asistente de preventa
Hola, quiero automatizar WhatsApp para mi empresa.
¿WOZTELL puede conectar WhatsApp con Instagram?
¿Puedo usarlo para atención al cliente?
¿Cuánto cuesta?
¿Puedo hablar con una persona?
Para un asistente de soporte
¿Cómo puedo conectar mi número de WhatsApp?
¿Por qué mi plantilla no ha sido aprobada?
¿Dónde puedo ver mis conversaciones?
¿Cómo puedo subir contactos?
Buenas prácticas antes de salir en producción
| Buena práctica | Qué revisar |
|---|---|
| Revisa las Instructions | El rol, tono, alcance, tareas, límites y reglas de escalado deben estar claros. |
| Sube una Knowledge Base limpia | Los documentos deben estar actualizados, bien estructurados y sin información duplicada o contradictoria. |
| Prueba escenarios reales | No pruebes solo preguntas simples. Usa conversaciones reales, objeciones y mensajes ambiguos. |
| Monitoriza el consumo de tokens | Más contexto, sesiones largas, Knowledge Bases grandes y respuestas extensas pueden aumentar el consumo. |
| Mantén disponible el escalado humano | Para ventas, soporte, precios, facturación y dudas técnicas, es recomendable permitir que el asistente escale a un agente. |
| Revisa los logs regularmente | Los logs ayudan a detectar errores de API Key, modelo, herramientas, prompt, File Search o conexión de canal. |
Troubleshooting
Si el asistente no responde como esperas, revisa primero la sección de logs. La mayoría de mensajes de error vienen directamente de OpenAI y suelen indicar qué ha fallado.
| Problema | Causa probable | Cómo solucionarlo |
|---|---|---|
| API Key not accepted | La clave se copió mal, fue revocada o no es válida. | Genera una nueva clave en OpenAI y pégala de nuevo en WOZTELL. |
| Alias error during installation | El alias ya se está usando en tu cuenta de WOZTELL. | Elige un alias diferente. |
| Sections 2 or 3 are not accessible | La API Key todavía no se ha guardado. | Guarda primero la API Key en el Paso 1. |
| Model does not appear in the list | Tu cuenta de OpenAI no tiene acceso a ese modelo. | Revisa tu cuenta de OpenAI, proyecto y permisos del modelo. |
| Assistant is not responding | El canal no está conectado o la API Key no es válida. | Comprueba la conexión del canal y verifica que la API Key sigue siendo válida. |
| Temperature or Top P error appears in logs | El modelo seleccionado no soporta ese parámetro. | Desactiva el parámetro o cambia a un modelo compatible. |
| File Search is not working | No hay archivos subidos, se seleccionó el Vector Store incorrecto o File Search no se añadió como herramienta. | Sube archivos, selecciona la Knowledge Base correcta y confirma que File Search está activo. |
| Assistant answers with incorrect information | Las Instructions no son claras o la Knowledge Base contiene información incompleta o contradictoria. | Mejora el prompt y revisa los documentos subidos. |
| Two OpenAI accounts are connected to the same channel | Otra extensión GPT Assistant ya está activa en ese canal. | Desconecta la extensión existente antes de conectar la nueva. |
Recomendación final
Una vez configurado y probado el chatbot, sigue mejorándolo con base en conversaciones reales. Revisa las preguntas de los clientes, actualiza la Knowledge Base, ajusta las Instructions y monitoriza el rendimiento del asistente de forma periódica.
Un asistente de IA bien configurado puede ayudar a tu equipo a automatizar conversaciones repetitivas, apoyar a los agentes dentro del Inbox, calificar leads más rápido y ofrecer respuestas consistentes en WhatsApp, Instagram, Facebook Messenger y Webchat.