Cómo actualizar su flujo de trabajo en n8n para la API v1.0 de Gamma
La API v0.2 de Gamma dejará de funcionar el 31 de enero de 2026. Aprenda a migrar sus flujos de trabajo de n8n a la nueva API v1.0 en solo unos minutos, con especial atención al cambio crítico del parámetro themeName a themeId.
Actualización crítica: fin de la API v0.2 de Gamma
Si está usando la API de Gamma con n8n para generar presentaciones automáticamente, necesita actualizar sus flujos de trabajo antes del 31 de enero de 2026. Gamma va a dejar de dar soporte a los endpoints de la API v0.2, y cualquier flujo de trabajo que siga usando la versión antigua dejará de funcionar después de esta fecha.
¿La buena noticia? La migración es sencilla y toma solo unos minutos. Esta guía le muestra exactamente lo que necesita cambiar.
Qué cambia en la API v1.0 de Gamma
El cambio más significativo en la API v1.0 es cómo se especifican los temas. En lugar de usar nombres de tema legibles, la nueva API requiere IDs de tema.
Forma antigua (v0.2):
“themeName”: “Oasis”
Forma nueva (v1.0):
“themeId”: “theme_abc123xyz”
Este cambio mejora la estabilidad de la API y permite una selección de temas más precisa, pero requiere una actualización puntual de sus flujos de trabajo.
Migración paso a paso para usuarios de n8n
Paso 1: Abra su flujo de trabajo en n8n
Navegue a su instancia de n8n y abra el flujo de trabajo que usa la API de Gamma. Busque el nodo HTTP Request que realiza la llamada a la API de Gamma.
Paso 2: Actualice la URL de la API
En su nodo HTTP Request, cambie la URL de:
https://public-api.gamma.app/v0.2/generations
A:
https://public-api.gamma.app/v1.0/generations
Paso 3: Obtenga su ID de tema de Gamma
Este es el paso crucial. Así es como encontrar su ID de tema:
- Inicie sesión en su cuenta de Gamma en gamma.app
- Haga clic en el icono de paleta en la barra de navegación para abrir la Design Library
- Encuentre el tema que desea usar para sus presentaciones
- Haga clic en los tres puntos (…) junto al nombre del tema
- Seleccione “Copy theme ID for API” del menú
Su ID de tema se copiará al portapapeles. Tendrá un aspecto similar a: theme_12345abcde
Paso 4: Actualice su carga JSON
En su nodo HTTP Request de n8n, encuentre la sección del cuerpo JSON. Reemplace el parámetro themeName por themeId:
Antes:
{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeName”: “Oasis”, “numCards”: 10 }
Después:
{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeId”: “theme_12345abcde”, “numCards”: 10 }
Paso 5: Guarde y pruebe
Guarde su flujo de trabajo actualizado. Si está usando n8n v2.0+, publique la nueva versión. Si está en v1.x, active el flujo de trabajo.
Ejecute una prueba para verificar que todo funciona correctamente con la nueva versión de la API.
Alternativa: use el tema predeterminado de Gamma
Si no necesita un tema personalizado específico, puede simplificar su migración eliminando el parámetro de tema por completo. La API v1.0 usará el tema predeterminado estándar de Gamma automáticamente:
{ “inputText”: “Your presentation topic”, “format”: “presentation”, “numCards”: 10 }
¿Qué pasa si tengo múltiples flujos de trabajo?
Si tiene varios flujos de trabajo en n8n que usan la API de Gamma, necesitará actualizar cada uno individualmente. Sin embargo, el proceso es idéntico para cada flujo de trabajo:
- Actualice la URL de la API a v1.0
- Reemplace
themeNameporthemeId - Use el mismo ID de tema en todos los flujos de trabajo (u obtenga IDs de tema diferentes si desea temas distintos)
Considere documentar sus IDs de tema en una ubicación central para poder consultarlos fácilmente al crear nuevos flujos de trabajo.
Recursos adicionales
¿Necesita ayuda?
Si encuentra problemas durante la migración, verifique que:
- Su API key no haya cambiado (debería seguir siendo la misma)
- Ha copiado el ID de tema completo de Gamma
- Está usando la URL correcta del endpoint v1.0
- Su sintaxis JSON es válida (atención a comas o comillas faltantes)
La fecha límite del 31 de enero de 2026 se acerca rápidamente, así que asegúrese de actualizar sus flujos de trabajo pronto. La migración es sencilla, y una vez completada, su generación automatizada de presentaciones seguirá funcionando sin problemas con la API v1.0 mejorada.
