n8n na Rússia: workflows de IA, erros e custos
Conecte o BetterToken ao n8n, execute um workflow de IA, limite tentativas e confira cada execução com tokens e cobranças no Dashboard.
Quer testar um workflow de IA do n8n com uma única solicitação controlada? Abra o guia do BetterToken para n8n, crie sua própria API Key e adicione uma credencial OpenAI no n8n. Conecte Manual Trigger, AI Agent e OpenAI Chat Model, limite Max Retries e compare a execução manual com o modelo, o status, o uso de tokens e a cobrança no BetterToken Dashboard.
O que o n8n faz neste processo de IA
O n8n gerencia a sequência de nós e armazena os dados de execução. OpenAI Chat Model envia uma solicitação ao modelo escolhido, e o BetterToken recebe uma chamada de API compatível com OpenAI. Para o primeiro teste, três componentes bastam:
Manual Trigger evita uma execução acidental por agendamento ou webhook. O AI Agent recebe um prompt fixo, e o Chat Model envia uma única solicitação ao modelo. Não adicione Telegram, e-mail, banco de dados, publicação nem outro nó com efeitos externos.
Nesse esquema, o BetterToken fornece a API Key, a Base URL, o Model ID disponível e o registro de uso no Dashboard. Isso não garante compatibilidade com todos os nós da comunidade ou ferramentas hospedadas pela OpenAI. A conexão ao BetterToken API Endpoint a partir da Rússia não exige VPN; a disponibilidade do n8n Cloud, do seu servidor e das integrações de terceiros precisa ser verificada separadamente.
Criar uma credencial sem expor a API Key
- Adicione o nó AI Agent ao workflow.
- No conector Chat Model, adicione o subnó OpenAI Chat Model.
- No campo Credential to connect with, selecione Create new credential → OpenAI.
- Se a interface oferecer OpenAI Account (ChatGPT) e API Key, selecione API Key.
Preencha a credencial:
- API Key: sua API Key do BetterToken.
- Organization ID: deixe em branco.
- Base URL:
https://www.bettertoken.ai/v1. - Add Custom Header: desative.
Salve a credencial no armazenamento seguro do n8n. Não coloque a chave em prompt, JSON do workflow, Code node, captura de tela, dados de execução ou repositório.
Consulte a documentação oficial do n8n para credenciais OpenAI para os campos e modos de autorização atuais.
A Base URL precisa terminar em /v1. Não acrescente /models, /chat/completions ou /responses: o n8n completa o endereço por conta própria. Ao salvar uma credencial, o n8n consulta os modelos por /models em relação à Base URL informada.
Se a lista de modelos não aparecer, abra novamente a credencial e o OpenAI Chat Model. Obtenha o Model ID exato na documentação atual do BetterToken para n8n ou no catálogo de modelos; este artigo não fixa um ID dinâmico.
Montar um workflow de IA mínimo
1. Adicionar Manual Trigger
Crie um workflow novo e adicione Manual Trigger. Não publique o workflow durante o teste: o n8n recomenda execuções manuais durante a criação e a validação.
2. Configurar AI Agent
Conecte Manual Trigger a AI Agent. Nas opções de prompt, escolha uma entrada que permita definir texto fixo e use:
Não conecte Tool nodes. Este teste precisa de uma resposta do modelo, e não de automação de agente.
3. Conectar OpenAI Chat Model
No subnó OpenAI Chat Model:
- selecione a credencial do BetterToken criada;
- selecione o Model ID exato;
- para a primeira solicitação, desative Use Responses API e use Chat Completions;
- defina um Timeout final;
- ajuste Max Retries para o menor valor permitido pela versão atual do n8n.
Os parâmetros Model, Use Responses API, Timeout e Max Retries são descritos na página oficial do OpenAI Chat Model.
Responses API e recursos integrados como Web Search, File Search ou Code Interpreter não fazem parte deste teste. A presença deles na interface do n8n não confirma suporte pelo modelo ou endpoint selecionado.
4. Executar exatamente uma rodada manual
Clique em Execute Workflow. Um resultado bem-sucedido deve conter JSON com workflow: "n8n" e sum: 4. Se um nó retornar erro, não reinicie imediatamente: primeiro classifique o erro.
Onde consultar o log de execução
Abra Executions para o workflow atual e selecione a execução manual. Confira:
- o status geral da execução;
- horário de início e duração;
- entrada e saída do AI Agent;
- o nó em que o processo parou;
- o texto do erro sem copiar a credencial ou um prompt sensível.
O n8n diferencia execuções manuais e de produção. Uma execução manual começa no editor e serve para teste; uma execução de produção começa automaticamente depois da publicação do workflow ou por um trigger. Mantenha o workflow sem publicar até verificar o provider.
As diferenças entre os tipos de execução e as listas de execuções estão na documentação do n8n sobre execuções.
Os dados de execução podem conter a entrada e a saída de um nó. Para workflows sensíveis, o n8n oferece redaction, que oculta dados e preserva metadados como status, horário e nomes dos nós. O prompt desta instrução não contém dados pessoais nem segredos.
Limitar tentativas e diagnosticar o erro
Uma nova tentativa automática só é útil para erros temporários. Ela também cria solicitações de API adicionais, portanto afeta o custo e dificulta o vínculo com uma única execução.
401/ Unauthorized: não repita automaticamente; primeiro verifique a API Key e espaços extras.403: não repita automaticamente; verifique se a chave tem acesso ao modelo selecionado.404/ model not found: não repita automaticamente; verifique a Base URL e o Model ID exato.429: permita apenas repetição limitada após uma pausa; verifique o limite de taxa e o número de execuções paralelas.5xx/ timeout: não ultrapasse o limite definido; verifique o status do provider, Timeout e o tamanho do prompt.- Workflow error: não repita antes do diagnóstico; verifique o nó, a expressão e os dados de entrada.
No primeiro teste, mantenha Max Retries no mínimo e não adicione loop, Wait + retry nem error workflow com uma nova chamada de API. Se precisar de retry em produção, defina um número finito de tentativas e um atraso, e depois confira quantas solicitações apareceram no Dashboard.
Um n8n error workflow é útil para notificar falhas, mas a própria notificação é um efeito externo. Adicione-o somente depois de uma verificação separada e com seus próprios limites.
O mecanismo Error Trigger e os dados de uma execução com falha são descritos no manual oficial de tratamento de erros.
Conferir tokens e valor no Dashboard
Abra o BetterToken Dashboard logo após uma execução manual. Compare:
- o horário de início delimitado no n8n com o horário da solicitação no Dashboard;
- o Model ID no OpenAI Chat Model com o modelo no registro de uso;
- o status de sucesso ou erro;
- tokens de entrada, saída e cache aplicáveis;
- a cobrança correspondente a esse registro.
Não calcule o valor a partir de um artigo antigo ou de um número fixo por milhão de tokens. Modelo e preço mudam: use a cobrança real de uma chamada no Dashboard e as tarifas atuais na página de preços do BetterToken.
Se uma execução manual corresponder a várias linhas no Dashboard, verifique Max Retries e o comportamento do agente. Uma execução visível do workflow pode gerar várias solicitações ao modelo, especialmente com loop de agente ou ferramentas Responses. Por isso, a primeira verificação usa prompt fixo, sem ferramentas e com o mínimo de repetições.
Erros frequentes
O teste de credencial retorna 401
Crie novamente a credencial do tipo OpenAI, remova espaços ao redor da API Key e confirme que o modo API Key está selecionado, não OpenAI Account. Não mostre a chave no log de execução.
O teste de credencial ou um nó retorna 404
A Base URL deve ser https://www.bettertoken.ai/v1. Não acrescente /models nem endpoint. Em seguida, recarregue a lista de modelos e selecione o ID atual.
O chat normal funciona, mas as ferramentas do agente não
Volte ao workflow mínimo: desative Use Responses API, remova Tool nodes e repita um prompt fixo. Assim você separa a conexão com o provider de uma restrição específica da ferramenta ou do workflow.
A execução é bem-sucedida, mas o Dashboard mostra várias solicitações
Verifique Max Retries e o loop do agente. Compare horários e status. Não some manualmente as linhas como uma única chamada se o n8n realmente enviou várias solicitações.
Perguntas frequentes
Preciso publicar um workflow para verificá-lo?
Não. Uma execução manual no editor é suficiente. A publicação ativa triggers de produção e pode iniciar ações externas sem confirmação adicional.
Posso usar a Responses API?
Somente depois de uma verificação separada do modelo e endpoint escolhidos. Para a primeira conexão, use Chat Completions comum sem ferramentas OpenAI integradas.
Onde a API Key do BetterToken fica armazenada?
Na credencial OpenAI do n8n. Não a duplique em parâmetros de nós, JSON do workflow, prompt ou repositório.
Como saber o custo real de um workflow?
Execute uma rodada manual com o mínimo de retries e compare horário de execução, Model ID e status com o registro no BetterToken Dashboard. Use os tokens e o consumo desse registro, não de um exemplo estimado.