n8n-nodes-canva

Aviso: Este node foi desenvolvido de forma independente para facilitar integrações com a API pública da Canva no n8n.
Não é afiliado, endossado ou mantido pela Canva Pty Ltd.
Todas as marcas citadas pertencem aos seus respectivos proprietários.

Para utilizar o nosso Community Node, é necessário atender aos seguintes requisitos:

• N8N na versão 1.54.4 ou superior
• Node.js na versão 16.0.0 ou superior
• Conta ativa na Canva com acesso à Connect API
• Application registrada no Canva Developer Portal

Via n8n Community Nodes:

1. Abra sua instância do n8n
2. Vá para Settings → Community Nodes
3. Instale o pacote: n8n-nodes-canva
4. Reinicie o n8n

Via NPM:

npm install n8n-nodes-canva

🔑 Configuração de Credenciais

Este node agora usa OAuth 2.0 nativo do n8n para autenticação automática:

1. Crie uma integração no Canva Developer Portal

   • Faça login no Developer Portal
   • Ative a MFA (Multi-Factor Authentication) se necessário
   • Vá para "Your Integrations" e clique em "Create an integration"
   • Escolha entre integração "Public" ou "Private"

2. Configure sua integração:

   • Defina um nome para sua integração
   • Copie o Client ID (será necessário no n8n)
   • Gere e salve o Client Secret (será necessário no n8n)
   • IMPORTANTE: Copie a URL de redirecionamento OAuth: [YOUR-URL-BASE]/rest/oauth2-credential/callback

3. ⚠️ CONFIGURAÇÃO CRÍTICA DE SCOPES:

   ATENÇÃO: Para evitar o erro "invalid_scope", você DEVE habilitar TODOS os scopes listados abaixo na seção Scopes da sua integração:

   app:read
   app:write
   asset:read
   asset:write
   brandtemplate:content:read
   brandtemplate:meta:read
   comment:read
   comment:write
   design:content:read
   design:content:write
   design:meta:read
   design:permission:read
   design:permission:write
   folder:read
   folder:write
   folder:permission:read
   folder:permission:write
   profile:read

   🚨 IMPORTANTE: Marque/habilite TODOS os 18 scopes acima na sua integração do Canva Developer Portal. Se qualquer scope estiver faltando, você receberá o erro "invalid_scope" durante a autenticação OAuth.

4. No n8n, crie uma nova credencial "Canva API":

   • Client ID: Cole o Client ID obtido no Developer Portal
   • Client Secret: Cole o Client Secret gerado no Developer Portal
   • Clique em "Connect my account" para iniciar o fluxo OAuth
   • Autorize a aplicação na tela do Canva
   • ✅ Pronto! O n8n gerenciará automaticamente tokens e renovações

5. 🎯 Vantagens do OAuth Nativo:

   • ✅ Configuração simplificada - Apenas Client ID e Secret
   • ✅ Renovação automática - n8n gerencia refresh tokens
   • ✅ Segurança aprimorada - Sem tokens manuais expostos
   • ✅ Fluxo padrão - Mesma experiência de outros nodes n8n

Migração: Se você usava versões anteriores com Access Token manual, delete a credencial antiga e crie uma nova seguindo os passos acima.

📡 Configuração de Webhooks

Para usar o Canva Trigger:

1. Adicione o node Canva Trigger ao seu workflow
2. Configure os eventos que deseja escutar
3. Ative o workflow
4. O webhook será automaticamente registrado no Canva
5. Quando desativar o workflow, o webhook será removido automaticamente

🚨 Troubleshooting - Erro "invalid_scope"

Problema: Durante a autenticação OAuth, você recebe o erro:

Error: Insufficient parameters for OAuth2 callback.
Received following query parameters: {"error":"invalid_scope","error_description":"Requested scopes are not allowed for this client."}

Solução:

1. Acesse sua integração no Canva Developer Portal
2. Vá para a seção "Your integrations" > "Create an integration"
3. Vá para a seção "Scopes" da sua integração
4. Marque/habilite TODOS os 18 scopes listados na seção de configuração acima
5. Salve as alterações
6. Tente a conexão OAuth novamente no n8n

Causa: Este erro ocorre quando a aplicação OAuth2 no Canva não está configurada com todos os scopes que o n8n-nodes-canva precisa para funcionar corretamente.

Contribua para o crescimento deste projeto! Você pode ajudar de diversas formas:

• Pull Requests: Envie melhorias, correções ou novas funcionalidades.
• Issues: Relate problemas ou sugira novas ideias.
• Sugestões: Compartilhe suas opiniões e feedbacks.
• Documentação: Ajude a melhorar ou expandir a documentação existente.