- A assinatura ChatGPT Plus NÃO dá créditos de API — o uso via n8n é cobrado à parte, no modelo pay-as-you-go.
- O erro nº1 é usar uma key de conta sem billing ativo: a credencial 'passa', mas a OpenAI rejeita a requisição.
- Nó OpenAI ('Message a Model') = uma pergunta, uma resposta. Nó AI Agent = o modelo decide quais ferramentas chamar.
- gpt-4o-mini custa cerca de US$ 0,15 por milhão de tokens de entrada; gpt-4o, US$ 2,50. A diferença no fim do mês é enorme.
- Contas OpenAI novas às vezes só liberam o gpt-4o-mini até o primeiro pagamento cair.
Gere a API key na OpenAI (com billing ativo)
Entre em platform.openai.com, vá em API keys e clique em 'Create new secret key'. A chave aparece uma única vez — copie e guarde num lugar seguro. Antes de sair, confira em Billing se há um método de pagamento cadastrado. Sem billing, a chave existe mas toda chamada volta com erro. Isso confunde muita gente: a credencial no n8n fica verde, e mesmo assim nada funciona.
Adicione a credencial OpenAI no n8n
No menu lateral do n8n, abra Credentials → Add new credential, busque por 'OpenAI' e selecione. Cole a chave no campo API Key e salve. Essa credencial fica guardada e você reaproveita ela em quantos fluxos quiser — não precisa colar a chave nó por nó. Se usar Azure OpenAI, o tipo de credencial é outro (Azure OpenAI), com endpoint e deployment próprios.
Monte o fluxo: gatilho → nó OpenAI
Todo workflow começa por um gatilho (trigger): pode ser um webhook, um novo e-mail no Gmail, uma linha nova numa planilha. Ligue esse gatilho a um nó OpenAI. Na operação, escolha 'Message a Model' para o caso mais comum — mandar um prompt e receber texto de volta. É aqui que a maioria dos fluxos de IA no n8n começa.
Escolha o modelo e escreva o prompt
No nó, selecione a credencial e o modelo. Regra prática: gpt-4o-mini quando você quer velocidade e custo baixo (resumo, classificação, resposta curta); gpt-4o quando a tarefa exige mais raciocínio. No prompt, dê contexto e papel — 'Você é um assistente de vendas. Resuma este e-mail em duas frases e sugira uma resposta' rende muito mais que 'resuma isto'. Use expressões do n8n, tipo {{ $json.corpo }}, para injetar o dado que veio do gatilho.
Teste, trate a saída e conecte o próximo nó
Rode o fluxo com 'Test workflow' e olhe o output do nó OpenAI — a resposta vem dentro de um campo (geralmente message.content). Ligue esse campo ao próximo passo: salvar num Google Sheets, criar rascunho no Gmail, mandar no WhatsApp. Comece pequeno, valide a qualidade da resposta e só então automatize de ponta a ponta.
Quando o caso pede raciocínio, troque para o nó AI Agent
Se você quer que a IA decida sozinha quais ações tomar — buscar um dado, consultar uma API, responder — o nó certo é o AI Agent, não o OpenAI simples. O AI Agent recebe uma lista de ferramentas e escolhe qual usar e em que ordem (o famoso ciclo pensar → agir → observar). Nesse caso, o modelo é ligado como sub-nó 'OpenAI Chat Model'. É o pulo do gato para sair do 'pergunta e resposta' e chegar a um agente de verdade.
Nó OpenAI ou nó AI Agent? A confusão mais comum
Essa é a dúvida que mais aparece na comunidade do n8n, e ela define se seu fluxo vai funcionar ou frustrar. O nó OpenAI, na operação 'Message a Model', faz uma coisa só: manda um prompt (mensagem de sistema + mensagem do usuário) e devolve o texto. Uma pergunta, uma resposta. Ótimo para resumir, classificar, traduzir, gerar uma legenda.
Já o nó AI Agent trabalha diferente. Você entrega ao modelo um conjunto de ferramentas e ele decide quais chamar, e em que ordem, até chegar na resposta final. Por baixo do capô roda o ciclo de raciocínio e ação: o modelo pensa, escolhe uma ação, observa o resultado e repete. É o que transforma automação boba em agente. Se você ainda está mapeando essa fronteira, vale ler a nossa comparação entre automação e agente de IA — muda a forma de desenhar o fluxo.
Regra de bolso: precisa só de uma resposta de texto? Nó OpenAI. Precisa que a IA tome decisões e use ferramentas? AI Agent.
Qual modelo escolher (e por que o custo importa tanto)
A escolha do modelo é decisão de dinheiro, não só de qualidade. O gpt-4o-mini sai por volta de US$ 0,15 por milhão de tokens de entrada e US$ 0,60 de saída. O gpt-4o custa US$ 2,50 e US$ 10,00 pelos mesmos volumes — mais de 15 vezes mais caro. Num fluxo que roda centenas de vezes por dia, essa conta pesa rápido.
Comece sempre pelo gpt-4o-mini. Ele dá conta de resumo, extração de dados, classificação de leads e resposta curta com folga. Só suba para o gpt-4o quando a tarefa exige raciocínio mais elaborado — e teste a diferença real antes de fixar o modelo caro no fluxo de produção. Uma observação prática: contas OpenAI recém-criadas às vezes só liberam o gpt-4o-mini até o primeiro pagamento ser processado.
| Modelo | Entrada (por 1M tokens) | Saída (por 1M tokens) | Melhor para |
|---|---|---|---|
| gpt-4o-mini | ~US$ 0,15 | ~US$ 0,60 | Resumo, classificação, resposta rápida e barata |
| gpt-4o | ~US$ 2,50 | ~US$ 10,00 | Raciocínio complexo, textos longos, análise |
Os erros que travam a integração
O tropeço número um é o billing. A pessoa cria a chave, cola no n8n, a credencial fica verde — e na hora de rodar, erro. Quase sempre é conta sem método de pagamento ativo. A OpenAI só responde às chamadas de API depois que você habilita o pay-as-you-go em platform.openai.com. E não, o ChatGPT Plus (a assinatura mensal) não conta: os créditos de API são cobrados separadamente.
Outro erro comum é pedir um modelo que a conta ainda não liberou — daí a mensagem de 'model not found' ou permissão negada. Se acontecer, volte para o gpt-4o-mini. E cuide da chave como cuida de senha de banco: ela dá acesso ao seu saldo. Se vazar, revogue na hora no painel da OpenAI e gere uma nova.
Para onde levar esse fluxo depois
Com a integração de pé, os casos aparecem sozinhos. O clássico é o e-mail que chega, vira prompt para o ChatGPT e volta como rascunho de resposta salvo no Gmail. Dá para plugar a IA num fluxo de atendimento no WhatsApp, gerar respostas de suporte, resumir reuniões, qualificar leads antes do time comercial.
Se o seu objetivo é um agente conversando no WhatsApp, o caminho passa pelo nó AI Agent com o modelo da OpenAI ligado como sub-nó — e por uma camada de envio que respeite as regras da plataforma. Quando quiser recursos mais avançados, como memória e ferramentas encadeadas, a base é o ecossistema LangChain dentro do n8n. Um passo de cada vez: primeiro o 'Message a Model' funcionando, depois a inteligência em cima.
Perguntas frequentes
Preciso pagar o ChatGPT Plus para usar a OpenAI no n8n?
Qual modelo da OpenAI usar no n8n?
Minha credencial ficou verde mas o fluxo dá erro. Por quê?
Qual a diferença entre o nó OpenAI e o nó AI Agent?
Leia também
Como criar um agente de IA com n8n sem saber programar
Crie um agente de IA com n8n sem escrever código: conecte a OpenAI, dê memória de conversa ao nó AI Agent, ligue ferramentas e coloque no WhatsApp. Passo a passo em português, do zero.
Ler →
n8n e LangChain: como usar IA avançada nos seus fluxos (guia 2026)
Entenda os nós de LangChain no n8n — AI Agent, chains, memória, vector store e o LangChain Code — e saiba qual usar em cada tipo de fluxo com IA.
Ler →
Diferença entre automação e agente de IA
Automação segue regras fixas; agente de IA decide sozinho o próximo passo. Entenda a diferença, veja a tabela comparativa e saiba quando usar cada um.
Ler →
Como criar um chatbot de WhatsApp com IA usando n8n e Z-API
Monte um chatbot de WhatsApp com IA de verdade no n8n com a Z-API: conecte por QR Code, aponte o webhook, use o nó AI Agent com memória e responda sozinho. Passo a passo com custos e anti-ban.
Ler →
O que é n8n? Guia completo para iniciantes em 2026
Entenda o que é n8n, como a ferramenta de automação funciona, quanto custa, se é difícil de aprender e como criar seu primeiro workflow sem saber programar.
Ler →