Como Atualizar Seu Workflow n8n para a Gamma API v1.0

Atualização Crítica: Descontinuação da Gamma API v0.2

Se você está usando a API do Gamma com o n8n para gerar apresentações automaticamente, precisa atualizar seus workflows antes de 31 de janeiro de 2026. O Gamma está descontinuando seus endpoints da API v0.2, e qualquer workflow que ainda use a versão antiga vai parar de funcionar após essa data.

A boa notícia? A migração é simples e leva apenas alguns minutos. Este guia orienta você exatamente sobre o que precisa mudar.

O Que Está Mudando na Gamma API v1.0

A mudança mais significativa na API v1.0 é como os temas são especificados. Em vez de usar nomes de temas legíveis, a nova API requer IDs de tema.

Forma antiga (v0.2):

“themeName”: “Oasis”

Forma nova (v1.0):

“themeId”: “theme_abc123xyz”

Essa mudança melhora a estabilidade da API e permite uma seleção de tema mais precisa, mas requer uma atualização única nos seus workflows.

Migração Passo a Passo para Usuários do n8n

Passo 1: Abra Seu Workflow no n8n

Navegue até sua instância do n8n e abra o workflow que usa a API do Gamma. Procure o nó HTTP Request que faz a chamada à API do Gamma.

Passo 2: Atualize a URL da API

No seu nó HTTP Request, altere a URL de:

https://public-api.gamma.app/v0.2/generations

Para:

https://public-api.gamma.app/v1.0/generations

Passo 3: Obtenha Seu Theme ID do Gamma

Este é o passo crucial. Veja como encontrar seu theme ID:

1. Faça login na sua conta Gamma em gamma.app
2. Clique no ícone de paleta na barra de navegação para abrir a Design Library
3. Encontre o tema que deseja usar para suas apresentações
4. Clique nos três pontos (…) ao lado do nome do tema
5. Selecione “Copy theme ID for API” no menu

Seu theme ID será copiado para a área de transferência. Ele será algo como: theme_12345abcde

Passo 4: Atualize Seu Payload JSON

No seu nó HTTP Request do n8n, encontre a seção do corpo JSON. Substitua o parâmetro themeName por themeId:

Antes:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeName”: “Oasis”, “numCards”: 10 }

Depois:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeId”: “theme_12345abcde”, “numCards”: 10 }

Passo 5: Salve e Teste

Salve seu workflow atualizado. Se você está usando o n8n v2.0+, publique a nova versão. Se está na v1.x, ative o workflow.

Execute uma execução de teste para verificar se tudo funciona corretamente com a nova versão da API.

Alternativa: Use o Tema Padrão do Gamma

Se você não precisa de um tema personalizado específico, pode simplificar sua migração removendo o parâmetro de tema completamente. A API v1.0 usará o tema padrão do Gamma automaticamente:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “numCards”: 10 }

E Se Eu Tiver Múltiplos Workflows?

Se você tem vários workflows do n8n usando a API do Gamma, precisará atualizar cada um individualmente. No entanto, o processo é idêntico para cada workflow:

1. Atualize a URL da API para v1.0
2. Substitua themeName por themeId
3. Use o mesmo theme ID em todos os workflows (ou obtenha diferentes theme IDs se quiser temas diferentes)

Considere documentar seus theme IDs em um local central para que possa referenciá-los facilmente ao criar novos workflows.

Recursos Adicionais

• Documentação Oficial da Gamma API
• Central de Ajuda da Gamma API

Precisa de Ajuda?

Se você encontrar problemas durante a migração, verifique se:

• Sua API key não mudou (ela deve permanecer a mesma)
• Você copiou o theme ID completo do Gamma
• Está usando a URL correta do endpoint v1.0
• Sua sintaxe JSON é válida (cuidado com vírgulas ou aspas faltando)

O prazo de 31 de janeiro de 2026 está se aproximando rapidamente, então certifique-se de atualizar seus workflows em breve. A migração é simples, e uma vez concluída, sua geração automatizada de apresentações continuará funcionando perfeitamente com a API v1.0 aprimorada.