Cómo migrar tu chatbot de IA de GPT Assistant v1.2.0 a v1.3.0 (Assistants API → Responses API)
Índice
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.
Qué es y qué no es esta migración
| La migración no es automática | No existe un botón que actualice de v1.2.0 a v1.3.0. Debes crear una nueva extensión v1.3.0 y reconstruir la configuración. |
| Se crea una nueva extensión | Tu extensión v1.2.0 no se modifica. Instalas una extensión v1.3.0 aparte, junto a ella. |
| Tu chatbot v1.2.0 sigue funcionando | Mantén el chatbot anterior activo hasta validar por completo el nuevo, para que tus clientes nunca se queden sin respuesta. |
| Los usuarios finales no se ven afectados | Los clientes siguen escribiendo desde el mismo canal de WhatsApp, Instagram, Facebook Messenger o Webchat. Solo cambia la conexión interna con OpenAI. |
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.
- Ve a Marketplace → + New Extension.
- Busca la tarjeta de la extensión ChatGPT (Artificial Intelligence · OpenAI | WOZTELL) y haz clic en Learn More.
- En Extension Version, selecciona v1.3.0.
- Introduce un Alias único (en minúsculas, sin espacios), por ejemplo my-gpt-assistant-v13.
- Haz clic en Install y luego abre la nueva extensión en Installed Extensions.
- 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: Cómo crear un chatbot con IA de OpenAI en WOZTELL. Esta guía de migración se centra en los pasos específicos para pasar de v1.2.0.
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.
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.
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.
- Si aún no tienes uno, crea un entorno de prueba y asigna testers para tu canal. Consulta: Cómo crear un entorno de prueba.
- En la extensión v1.3.0, abre la sección Connect to Channel.
- Busca tu canal y selecciona el entorno de prueba que creaste, no el entorno Default/producción donde está activo v1.2.0.
- Haz clic en Connect.
- Introduce un Prefix Name si se solicita; usa una etiqueta clara como AI-CHATBOT-WHATSAPP-TEST.
- 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:
- Desde un dispositivo o número de la whitelist, envía mensajes al canal.
- Comprueba que el chatbot responde y que las respuestas coinciden con tus Instructions.
- Prueba distintos tipos de preguntas y casos límite (incluidas preguntas fuera del alcance del chatbot).
- Si añadiste un Knowledge Base / File Search, haz preguntas que deban responderse a partir de tus documentos y confirma que funciona.
- 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.
- Desconecta el chatbot v1.2.0 del canal/entorno de producción (Default).
- 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).
- Envía una última prueba en vivo para confirmar que el nuevo chatbot responde en producción.
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
| Problema | Causa | Qué hacer |
|---|---|---|
| Respuestas impredecibles / los usuarios llegan al bot equivocado | Dos chatbots quedaron activos dentro del mismo entorno. | Mantén v1.2.0 y v1.3.0 en entornos separados. Durante el cambio, desconecta uno antes de conectar el otro en el mismo entorno. |
| Los testers no pueden acceder al nuevo chatbot | No se asignó ningún Priority Group, o los testers no se añadieron a él. | Confirma que el Priority Group está asignado al entorno de prueba y que cada tester está en la whitelist (en WhatsApp, los testers deben escribir primero a la WABA). |
| Parte de la lógica basada en el prompt se comporta de forma distinta | La Responses API gestiona el contexto de forma diferente a la Assistants API. | Revisa y ajusta el prompt durante la validación; considera mover el contenido de referencia a File Search. |
| El asistente no responde en el entorno de prueba | La API Key no se guardó, el chatbot no está conectado o se seleccionó el entorno equivocado. | Confirma que la API Key está guardada, que el chatbot está conectado y que estás escribiendo al entorno correcto. |
Preguntas frecuentes
¿Por qué necesito migrar de GPT Assistant v1.2.0 a v1.3.0?
OpenAI cierra la Assistants API, que es la base de la v1.2.0, el 26 de agosto de 2026. A partir de esa fecha, los chatbots que sigan en v1.2.0 pueden dejar de funcionar. La v1.3.0 funciona con la nueva Responses API de OpenAI, así que migrar mantiene tu chatbot en marcha.
¿La migración es automática?
No. No existe un botón que actualice de v1.2.0 a v1.3.0. Creas una nueva extensión v1.3.0 y reconstruyes la configuración, mientras tu chatbot v1.2.0 sigue funcionando hasta que el nuevo esté listo.
¿Se verán afectados mis clientes durante la migración?
No, si migras con pruebas. Mantienes la v1.2.0 activa, creas y validas la v1.3.0 en un entorno de prueba separado y solo pasas a producción cuando estás seguro, de modo que los clientes nunca se quedan sin servicio.
¿Qué es un entorno de prueba y por qué debería usarlo?
Un entorno es un espacio de trabajo dentro de un canal que separa las pruebas de la producción. Ejecutar la v1.3.0 en un entorno de prueba permite que un grupo pequeño de testers la pruebe mientras los clientes reales siguen en la v1.2.0, lo que evita que dos chatbots choquen en el mismo entorno.
¿Tengo que reconstruir mi prompt y mis ajustes?
Sí. En la v1.2.0 el comportamiento del chatbot estaba en el prompt. Copia ese prompt en la nueva extensión v1.3.0, selecciona el modelo y el transcription model, y replica tus ajustes avanzados. Si quieres, puedes mover el contenido de referencia extenso a File Search.
¿Cuál es la fecha límite para migrar?
El 26 de agosto de 2026, cuando OpenAI cierra la Assistants API. Migra antes de esa fecha para evitar cualquier interrupción.
