N8N e OAuth2: O Guia Prático e Definitivo

Configurar OAuth2 parece difícil porque envolve muitos nomes estranhos, mas na prática é apenas um "aperto de mão" digital entre o N8N e outra plataforma.

Este guia vai direto ao ponto para você conectar qualquer API sem perder horas lendo documentação técnica.

1. O Conceito (Sem Complicação)

Imagine que o OAuth2 é como um cartão de hotel:

Você não tem a chave mestra do dono do hotel (a senha da API).
Mas ele te dá um cartão magnético (o Token) que abre apenas a porta do seu quarto.
Esse cartão vence depois de um tempo, mas o N8N sabe ir até a recepção e pedir um novo automaticamente para você.

Você só precisa configurar isso uma vez.

2. Na Prática: Onde clicar no N8N

Para conectar uma API que não tem um node pronto (nativo), o segredo é o node HTTP Request.

Crie um node HTTP Request.
Vá em Authentication e troque para Generic Credential Type.
No campo logo abaixo, escolha OAuth2.
Clique em Create New Credential.

3. Preenchendo os Campos (Checklist)

Abra a documentação da API que você quer usar e procure por "OAuth" ou "Authentication". Você vai precisar preencher estes campos no N8N:

Campo no N8N	O que colocar?
Grant Type	Deixe em Authorization Code (é o padrão para 90% das APIs).
Authorization URL	O link da página onde você faz o login para autorizar.
Access Token URL	O link que o N8N usa nos bastidores para pegar o token.
Client ID	O "RG" do seu aplicativo (você pega no painel da API).
Client Secret	A "Senha" do seu aplicativo.
Scope	As permissões que você quer (ex: `read_products`, `send_email`).

Atenção Crítica: No topo da janela de credencial do N8N, existe um campo chamado OAuth Redirect URL. Copie esse link exato e cadastre no painel da sua API. Se faltar uma barra / ou o https, nada vai funcionar.

4. Onde Todo Mundo Trava (E Como Resolver)

Se a sua conexão der erro, com certeza é um destes três motivos. Veja como corrigir:

Erro 1: "Redirect URI mismatch"

O link que você cadastrou no site da API não é exatamente igual ao link que o N8N te mostrou.

Solução: Copie e cole novamente o link do N8N para garantir.

Erro 2: A conexão cai depois de 1 hora

O N8N pegou o token, mas a API não mandou o "Refresh Token" (a permissão para renovar o cartão do hotel).

Solução: No N8N, vá em Auth URI Query Parameters e adicione: access_type=offline.
Obs: Algumas APIs (como Google) também exigem prompt=consent.

Erro 3: "Invalid Client" ou "Auth Failed"

A API espera receber a senha (Secret) de um jeito, mas o N8N está mandando de outro.

Solução: Dentro da credencial no N8N, procure a opção Authentication. Tente mudar de Header para Body (ou vice-versa).

5. Resumo

Crie o App no site da API (Google, Facebook, RD Station, etc).
Copie a Redirect URL do N8N e cole lá no site da API.
Traga o Client ID e Secret para o N8N.
Adicione access_type=offline se precisar de conexão 24h.

Pronto. Agora seu node HTTP Request tem superpoderes.