Cómo migrar tu chatbot de IA de GPT Assistant v1.2.0 a v1.3.0 (Assistants API → Responses API)

Esta guía explica cómo migrar un chatbot de IA existente de GPT Assistant v1.2.0 (basado en la Assistants API de OpenAI) a GPT Assistant v1.3.0 (basado en la Responses API de OpenAI) dentro de WOZTELL.

Está dirigida a clientes que ya tienen un chatbot funcionando en v1.2.0 y necesitan volver a crearlo en v1.3.0 antes de que la Assistants API deje de estar disponible.

Por qué debes migrar

OpenAI ha discontinuado la Assistants API y ha programado su cierre para el 26 de agosto de 2026. A partir de esa fecha, cualquier chatbot que siga basado en v1.2.0 podría dejar de funcionar. Para evitar interrupciones del servicio, migra a un chatbot v1.3.0 basado en la Responses API antes de esa fecha.

Qué es y qué no es esta migración

Enfoque recomendado: migrar con pruebas.

Crea el nuevo chatbot v1.3.0, valídalo en un entorno de prueba con un grupo reducido de testers y pásalo a producción solo cuando tengas plena confianza. Así tus clientes siguen hablando con el chatbot v1.2.0 ya probado durante todo el proceso, sin interrupciones.

Antes de empezar

Asegúrate de tener:

• Acceso a la configuración de tu extensión v1.2.0 (copiarás sus ajustes).
• Tu API Key de OpenAI (puedes reutilizar la misma).
• Al menos un canal ya conectado en WOZTELL (WhatsApp Business Platform / Cloud API, Instagram, Facebook Messenger o Webchat).
• Algunos testers cuyas cuentas o números de teléfono puedas usar para probar el nuevo chatbot de forma segura.

La forma más rápida de migrar es abrir la configuración de tu v1.2.0 en una pestaña y la nueva extensión v1.3.0 en otra, y copiar cada ajuste de una a otra.

Paso 1 — Mantén activo tu chatbot v1.2.0

Aún no desconectes ni elimines tu chatbot actual. Permanece activo y sigue respondiendo a los clientes durante todo el tiempo que construyes y pruebas el nuevo. Solo lo desactivarás al final, durante el cambio a producción (Paso 6).

Paso 2 — Crea la nueva extensión v1.3.0

Crearás el nuevo chatbot desde cero como una extensión aparte.

1. Ve a Marketplace → + New Extension.
2. Busca la tarjeta de la extensión ChatGPT (Artificial Intelligence · OpenAI | WOZTELL) y haz clic en Learn More.
3. En Extension Version, selecciona v1.3.0.
4. Introduce un Alias único (en minúsculas, sin espacios), por ejemplo my-gpt-assistant-v13.
5. Haz clic en Install y luego abre la nueva extensión en Installed Extensions.
6. En la sección API Key Setup, pega tu API Key de OpenAI y haz clic en Save. Una marca verde confirma que la clave es válida y habilita las secciones Configuration y Connect to Channel.

Para ver la configuración completa paso a paso con capturas de pantalla, consulta la guía completa: How to Create an AI Chatbot with OpenAI in WOZTELL. Esta guía de migración se centra en los pasos específicos para pasar de v1.2.0.

Importante: No podrás configurar el chatbot ni conectarlo a un canal hasta que guardes la API Key.

Paso 3 — Replica tu configuración

En v1.2.0, todo el comportamiento de tu chatbot estaba en el prompt (Instructions). Migrarlo consiste, sobre todo, en copiar ese prompt y seleccionar el modelo adecuado.

En la nueva extensión v1.3.0, abre Configuration → AI Chatbot y define las Instructions (prompt), el Model, el Transcription model y los ajustes avanzados.

Importante: Guarda cada pestaña antes de cambiar a otra; los cambios sin guardar pueden perderse.

Cómo funcionan los canales y los entornos

Este es el concepto que hace posible una migración segura, así que conviene entenderlo antes de conectar nada.

• Un canal es el canal de comunicación conectado a WOZTELL: WhatsApp, Instagram, Facebook Messenger o Webchat.
• Un entorno es un espacio de trabajo dentro de un canal que permite separar las pruebas de la producción. Si no has creado entornos adicionales, el canal usa el entorno Default.

Durante la migración, los entornos te permiten ejecutar el nuevo chatbot v1.3.0 en un entorno de prueba mientras tu chatbot v1.2.0 permanece en el entorno activo (Default/producción). Tus clientes siguen hablando con el chatbot anterior, ya probado, hasta que decidas hacer el cambio.

Mantén los dos chatbots en entornos separados.

Si dos chatbots quedan activos dentro del mismo entorno, se producirán respuestas impredecibles (los usuarios llegarán a uno u otro bot sin control). Usar un entorno de prueba separado es justamente la forma de evitarlo.

Paso 4 — Conecta el nuevo chatbot a un entorno de prueba

Ahora conecta el nuevo chatbot, pero a un entorno de prueba, no a producción.

1. Si aún no tienes uno, crea un entorno de prueba y asigna testers para tu canal. Consulta: How to create a test environment.
2. En la extensión v1.3.0, abre la sección Connect to Channel.
3. Busca tu canal y selecciona el entorno de prueba que creaste, no el entorno Default/producción donde está activo v1.2.0.
4. Haz clic en Connect.
5. Introduce un Prefix Name si se solicita; usa una etiqueta clara como AI-CHATBOT-WHATSAPP-TEST.
6. Haz clic en Confirm y luego en Connect de nuevo.

Cuando el botón cambie a Disconnect, el nuevo chatbot estará activo solo en el entorno de prueba.

Paso 5 — Prueba y valida

Ahora solo los testers de tu lista (whitelist) se dirigen al entorno de prueba y al nuevo chatbot v1.3.0. Producción —y tus clientes reales— permanecen en v1.2.0, sin cambios.

Pide a tus testers que pongan a prueba el nuevo chatbot a fondo:

1. Desde un dispositivo o número de la whitelist, envía mensajes al canal.
2. Comprueba que el chatbot responde y que las respuestas coinciden con tus Instructions.
3. Prueba distintos tipos de preguntas y casos límite (incluidas preguntas fuera del alcance del chatbot).
4. Si añadiste un Knowledge Base / File Search, haz preguntas que deban responderse a partir de tus documentos y confirma que funciona.
5. Revisa los logs en busca de errores (API Key, modelo, tools, File Search o problemas de conexión del canal).

Paso 6 — Pasa a producción

Cuando tengas confianza en el nuevo chatbot, cambia tu canal activo de v1.2.0 a v1.3.0.

1. Desconecta el chatbot v1.2.0 del canal/entorno de producción (Default).
2. Conecta el chatbot v1.3.0 a ese entorno de producción (los mismos pasos del Paso 4, pero seleccionando esta vez el entorno de producción).
3. Envía una última prueba en vivo para confirmar que el nuevo chatbot responde en producción.

Importante: Desconecta primero v1.2.0 y luego conecta v1.3.0, para que los dos nunca estén activos en el mismo entorno a la vez.

Una vez que confirmes que v1.3.0 funciona en producción, puedes eliminar con seguridad la antigua extensión v1.2.0.

Problemas conocidos durante la migración

Artículos relacionados

• How to Create an AI Chatbot with OpenAI in WOZTELL | User Guide
• How to create a new environment
• Introduction to AI Chatbots with OpenAI + WOZTELL
• 14 Frequently Asked Questions About the New AI Chatbots with OpenAI + WOZTELL