Ligar credenciais no n8n: Google, Slack, OAuth

O que são credenciais

No n8n, uma credencial é um acesso guardado e encriptado a uma app. Cria-a uma vez e reutiliza-a em todos os workflows. As credenciais são guardadas encriptadas com a chave de encriptação da sua instância e, nos planos pagos, podem ser partilhadas com colegas sem revelar o segredo.

Há três tipos comuns:

• Chave de API / token: cole uma chave das definições da app (OpenAI, personal access token do Airtable, chave secreta do Stripe).
• OAuth2: clica em «Iniciar sessão com…» e aprova o acesso (Google, Slack, Microsoft, HubSpot).
• Basic auth / header auth: para webhooks e APIs simples.

Antes de começar: o URL de redirecionamento OAuth

Cada credencial OAuth2 no n8n mostra um OAuth Redirect URL, como https://n8n.yourcompany.com/rest/oauth2-credential/callback. Cole-o na consola de programador da app. Tem de coincidir exatamente, incluindo https.

No n8n Cloud, muitas apps (Google, Slack, Microsoft) oferecem um botão Sign in de um clique, sem configuração de programador. No n8n com alojamento próprio, normalmente cria primeiro a sua própria app OAuth.

Google (Sheets, Gmail, Drive, Calendar)

No n8n com alojamento próprio:

1. Abra a Google Cloud Console e crie um projeto.
2. Vá a APIs & Services → Library e ative as APIs de que precisa, como Google Sheets API, Gmail API e Google Drive API.
3. Configure o OAuth consent screen. Escolha Internal se usar o Google Workspace e só a sua organização se for ligar; caso contrário, External, e adicione-se como utilizador de teste.
4. Vá a Credentials → Create credentials → OAuth client ID, tipo Web application.
5. Cole o URL de redirecionamento OAuth do n8n em Authorized redirect URIs.
6. Copie o Client ID e o Client Secret para a credencial do n8n (Google OAuth2 API ou a específica da app) e clique em Sign in with Google.

Dica: uma app External com o estado «Testing» emite tokens que expiram ao fim de 7 dias. Publique a app (ou use Internal) para workflows de longa duração.

Slack

1. Aceda a api.slack.com/apps e clique em Create New App → From scratch.
2. Em OAuth & Permissions, adicione o URL de redirecionamento do n8n.
3. Adicione os scopes de que precisa. Para publicar mensagens: chat:write; para ler canais: channels:read, channels:history.
4. Copie o Client ID e o Client Secret para a credencial Slack OAuth2 do n8n e ligue-a.
5. Convide a app para cada canal onde deva publicar (/invite @YourApp).

Para um único espaço de trabalho, um token de bot (começa por xoxb-) com a credencial Slack API é mais simples do que OAuth.

Microsoft (Outlook, Teams, OneDrive)

1. No portal do Azure, abra App registrations → New registration.
2. Adicione o URL de redirecionamento do n8n como redirect URI do tipo Web.
3. Em Certificates & secrets, crie um client secret.
4. Em API permissions, adicione permissões delegadas do Microsoft Graph como Mail.ReadWrite, Mail.Send e offline_access.
5. Cole o Application (client) ID e o secret na credencial Microsoft OAuth2 do n8n.

OAuth2 genérico para qualquer app

Se o n8n não tiver uma credencial dedicada, use OAuth2 API com o nó HTTP Request. Precisa do URL de autorização, do URL do token de acesso, do client ID, do client secret e dos scopes da documentação para programadores da app.

Checklist de segurança

• Dê a cada credencial apenas os scopes mínimos de que precisa.
• Use uma conta de serviço ou um utilizador bot dedicado, e não a conta de uma pessoa, para workflows críticos.
• Guarde a N8N_ENCRYPTION_KEY em segurança; se a perder, terá de recriar todas as credenciais.
• Renove os segredos quando alguém sair da equipa.

Porque é que isto é importante numa migração

Ao sair do Zapier ou do Make, os workflows podem ser reconstruídos a partir das exportações, mas as credenciais não podem ser transferidas. Recriá-las costuma ser a parte mais lenta de uma migração, por isso configure-as primeiro. Veja o guia de migração do Zapier para o n8n.