Cómo crear un chatbot con IA de OpenAI en WOZTELL — Para WhatsApp, Instagram, Facebook Messenger, y Webchat

How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat
Índice
Esta guía detalla cómo configurar un chatbot de IA usando la extensión de GPT Assistant v1.3.0.

¿Actualizando desde la versión 1.2.0? La migración no es automática. Deberás crear una nueva extensión y replicar manualmente tu configuración. Lee más información sobre la migración aquí.

Esta guía explica cómo configurar un chatbot con inteligencia artificial en WOZTELL utilizando la extensión GPT Assistant y 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.
Importante: Antes de empezar, asegúrate de tener al menos un canal conectado en tu cuenta de WOZTELL. Los canales compatibles incluyen WhatsApp Business Platform / WhatsApp Cloud API, Instagram, Facebook Messenger y Webchat.

Paso 1 — Instalar la extensión GPT Assistant

1.1 Acceder al Marketplace

Ve a Marketplace → + New Extension.

How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat

En Marketplace, busca la tarjeta de la extensión ChatGPT: Artificial Intelligence · OpenAI | WOZTELL. Después haz clic en Learn More.

How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat

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.
How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat

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.

  1. Ve a API Keys.
  2. Haz clic en + Create new secret key.
  3. Añade un nombre descriptivo, por ejemplo: woztell-gpt-assistant
  4. Deja el proyecto como Default, salvo que tu cuenta de OpenAI utilice una estructura específica de proyectos.
  5. Haz clic en Create secret key.
  6. Copia la clave inmediatamente.
How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat
How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat
Importante: OpenAI solo muestra la clave completa una vez. Después de cerrar el cuadro de diálogo, no podrás verla de nuevo. Nunca compartas tu API Key. Está vinculada a la facturación de tu cuenta de OpenAI. Si la clave queda expuesta, revócala inmediatamente desde OpenAI y genera una nueva.

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.

How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat

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.
Importante: Guarda cada pestaña antes de cambiar a otra. Los cambios no guardados pueden perderse.

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:
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.

How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat
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.

How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat
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
  1. Haz clic en + New Knowledge Base.
  2. Introduce un nombre descriptivo, por ejemplo: woztell-faq
  3. Haz clic en el icono de subida.
  4. Arrastra y suelta tus archivos, o selecciónalos desde tu dispositivo.
  5. Espera a que los documentos se procesen.
  6. Vuelve a la configuración de AI Chatbot.
  7. Añade la herramienta File Search.
  8. Selecciona la Knowledge Base / Vector Store que has creado.

Formatos compatibles: PDF, DOCX y TXT. Utiliza documentos limpios y bien estructurados. Cuanto más claros sean tus documentos, mejor podrá recuperar información precisa el asistente.

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.

How to Create an AI Chatbot with OpenAI in WOZTELL— for WhatsApp, Instagram, Facebook Messenger, and Webchat
Asistente de ejemplo Canal Caso de uso
AI-CHATBOT-WHATSAPP-PRESALES WhatsApp Calificación de leads y preguntas comerciales.
AI-CHATBOT-INSTAGRAM-SUPPORT Instagram 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

  1. Ve a Section 3 — Connect to Channel.
  2. Busca el canal y entorno donde quieres activar el asistente.
  3. Haz clic en Connect.
  4. Introduce un Prefix Name si se solicita.
  5. Haz clic en Confirm.
  6. 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

  1. Ve al canal conectado en WOZTELL.
  2. Envía un mensaje desde otro dispositivo, cuenta o número.
  3. Comprueba si el asistente responde correctamente.
  4. Verifica que la respuesta coincide con tus Instructions.
  5. Prueba diferentes tipos de preguntas.
  6. Prueba casos límite, como preguntas fuera del alcance del asistente.
  7. Revisa los logs si algo no funciona como esperas.

Preguntas de prueba sugeridas

Caso de uso Preguntas de prueba
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.