Pesquisar
Português
Conteúdo
  1. Tutorial de n8n
Primeiros passos
  1. O que é n8n
  2. Instalação do n8n
  3. Guia da interface
  4. Primeiro workflow
  5. Estrutura de dados e items
Conceitos essenciais
  1. Expressões
  2. Gerenciamento de credenciais
  3. Nós principais
  4. Webhook
  5. Nó Code
  6. Tratamento de erros
Automação com IA
  1. Introdução ao AI Agent
  2. Conecte modelos locais do Ollama
  3. Perguntas e respostas com base de conhecimento RAG
Exemplos práticos
  1. Automação do Google Sheets
  2. Bot de IA do Telegram
Implantação e operações
  1. Hospedagem própria
  2. Backup e atualização
  3. Perguntas frequentes e erros

Gerenciamento de credenciais no n8n: configure chaves de API, OAuth e acesso ao Google

As contas, senhas, chaves de API e autorizações OAuth necessárias para conectar o n8n a serviços externos ficam nas credenciais (Credentials). As credenciais são armazenadas separadamente dos workflows:

  • Você pode reutilizar as mesmas credenciais em vários workflows
  • As credenciais não são incluídas quando você exporta ou compartilha um workflow
  • As credenciais são armazenadas criptografadas no banco de dados

Adicionar credenciais

Há duas maneiras:

  1. No nó, selecione Create new credential em Credential to connect with.
  2. Na página inicial, acesse a aba Credentials → Add Credential.
Selecione um serviço ao adicionar credenciais
Credentials → Create credential e pesquise o serviço ao qual você quer se conectar

Os campos necessários variam de acordo com o serviço. Normalmente, há um link para a documentação oficial no topo do formulário.

Tipos de credenciais

TipoDescriçãoExemplos
API Key / TokenGere uma chave no painel do serviço e cole-a no n8nOpenAI, Notion, Telegram Bot
Nome de usuário e senhaInforme diretamenteSMTP, banco de dados, FTP
OAuth2Clique no botão para abrir o serviço, entrar e autorizar o acessoGoogle, Microsoft, Slack

Exemplo: Telegram Bot

  1. No Telegram, pesquise @BotFather, envie /newbot e escolha um nome seguindo as instruções.
  2. O BotFather fornecerá um Bot Token, por exemplo, 123456789:AAH....
  3. No n8n, adicione uma credencial Telegram API, cole o Token e salve.
Tela de configuração das credenciais da API do Telegram
Credenciais da API do Telegram: cole o Access Token fornecido pelo BotFather e clique em Save

Confira o exemplo detalhado em Bot do Telegram.

Exemplo: autorização do Google em uma instalação própria do n8n

No n8n Cloud, você pode entrar no Google com um clique. Em uma instalação própria, primeiro é necessário criar seu próprio cliente OAuth no Google Cloud:

1. Criar um projeto no Google Cloud

  1. Acesse o Google Cloud Console e crie um projeto.
  2. Em “APIs e serviços → Biblioteca”, ative as APIs necessárias, como Google Sheets API, Gmail API e Google Drive API.

2. Configurar a tela de consentimento OAuth

  1. Acesse “APIs e serviços → Tela de consentimento OAuth” e selecione Externo como tipo de usuário.
  2. Informe o nome do aplicativo e um e-mail de contato.
  3. Adicione sua própria Conta do Google em Usuários de teste.

3. Criar um ID de cliente OAuth

  1. Acesse “APIs e serviços → Credenciais → Criar credenciais → ID do cliente OAuth”.

  2. Selecione Aplicativo da Web como tipo de aplicativo.

  3. Em URIs de redirecionamento autorizados, cole o OAuth Redirect URL exibido na tela de credenciais do n8n, por exemplo:

    https://n8n.example.com/rest/oauth2-credential/callback

  4. Após a criação, você receberá um Client ID e um Client Secret.

4. Voltar ao n8n para concluir a autorização

  1. Adicione uma credencial Google Sheets OAuth2 API (ou Gmail, Google Drive).
  2. Cole o Client ID e o Client Secret.
  3. Clique em Sign in with Google, entre na conta e autorize o acesso.

O URI de redirecionamento precisa corresponder exatamente. O n8n gera esse endereço usando variáveis de ambiente como N8N_HOST, N8N_PROTOCOL e a URL do Webhook. Se o endereço exibido for http://localhost:5678, a configuração da implantação ainda não está concluída. Consulte Implantar o n8n por conta própria.

Enquanto o aplicativo estiver no modo “Teste”, a autorização terá validade menor, e talvez seja necessário autorizá-la novamente periodicamente. Para uso prolongado, considere publicar o aplicativo em produção (pode ser necessário passar pela análise do Google).

Usar credenciais no nó HTTP Request

Ao chamar uma API que não tem um nó próprio, selecione uma destas opções em Authentication no nó HTTP Request:

  • Predefined Credential Type: use credenciais de serviços já compatíveis com o n8n (por exemplo, Notion). Mesmo que o nó do Notion no n8n não seja compatível com uma API específica, você pode chamá-la usando as mesmas credenciais.
  • Generic Credential Type:
    • Header Auth: por exemplo, nome Authorization e valor Bearer sk-xxx
    • Query Auth: coloque a chave nos parâmetros da URL
    • Basic Auth: nome de usuário e senha
    • OAuth2: configure os endpoints OAuth manualmente

Não escreva a chave de API diretamente nos campos URL ou Header, pois ela será exposta junto com o workflow quando ele for exportado ou compartilhado.

Chave de criptografia das credenciais

As credenciais são criptografadas com uma chave de criptografia, que por padrão fica no diretório de dados do n8n (/home/node/.n8n/config). Você também pode defini-la com a variável de ambiente N8N_ENCRYPTION_KEY.

  • Ao migrar ou restaurar o n8n, use a mesma chave de criptografia; caso contrário, nenhuma credencial poderá ser descriptografada.
  • Várias instâncias do n8n (por exemplo, workers no queue mode) precisam usar a mesma chave.

Consulte Backup e atualização para ver como fazer backups.

Compartilhamento e permissões

Por padrão, somente quem criou uma credencial pode usá-la. Nas configurações Sharing da credencial, você pode compartilhá-la com outros usuários ou projetos (os recursos disponíveis dependem do plano). Quem receber o compartilhamento poderá usar a credencial nos workflows, mas não verá seu conteúdo.

Atualizado 12 de outubro de 2026