Erro “input values have X keys” no n8n: como identificar, corrigir e evitar falhas em fluxos com IA

Ao desenvolver automações com inteligência artificial no n8n, especialmente utilizando AI Agent ou Redis Chat Memory, um erro relativamente comum pode surgir durante a execução:

input values have 3 keys, you must specify an input key or pass only 1 key as input

Esse erro costuma gerar confusão, pois em muitos casos ele aparece de forma aparentemente aleatória, funcionando em uma execução e falhando em outra. No entanto, a causa é objetiva e pode ser corrigida de forma definitiva com um pequeno ajuste na estrutura dos dados.

O que esse erro realmente significa

Esse erro indica que o node responsável pelo processamento da mensagem (como AI Agent ou Redis Chat Memory) não conseguiu identificar corretamente qual campo deve ser utilizado como entrada.

No n8n, esses nodes esperam explicitamente um campo chamado input. Quando esse campo não está presente, o sistema tenta inferir a entrada com base nas demais chaves disponíveis, como message, text ou outras.

Se houver mais de uma chave disponível, o n8n não consegue decidir automaticamente qual usar, resultando no erro.

Exemplo de estrutura problemática

Veja um exemplo comum que causa esse problema:

{
  "session_id": "4718028fb5ed66f9997acb020f2e4e71",
  "type": "text",
  "message": "Olá! Aqui é a Rebecca da Saldaris."
}

Nesse caso, existem múltiplos campos possíveis, mas nenhum deles é explicitamente o input. Isso gera ambiguidade e leva à falha.

Por que o erro parece acontecer “do nada”

Em fluxos mais complexos, especialmente aqueles que utilizam integrações com APIs externas, Webhooks, loops (Loop Over Items), merges ou condicionais, a estrutura do JSON pode variar entre execuções.

Por exemplo, em uma execução o fluxo pode gerar:

{
  "input": "Olá!"
}

E em outra:

{
  "message": "Olá!",
  "session_id": "123"
}

Essa inconsistência faz com que o erro apareça de forma intermitente, dando a impressão de instabilidade no sistema.

Como corrigir corretamente no n8n

A solução recomendada é padronizar a estrutura do JSON antes de enviá-lo ao AI Agent ou Redis Chat Memory.

Para isso, utilize um node Edit Fields (Set) imediatamente antes do node de IA e defina explicitamente o campo input.

{
  "input": "Olá! Aqui é a Rebecca da Saldaris.",
  "sessionId": "4718028fb5ed66f9997acb020f2e4e71"
}

Se estiver utilizando expressões no n8n, você pode tratar diferentes formatos de entrada da seguinte forma:

input: {{ Array.isArray($json.message) ? $json.message[0] : $json.message }}
sessionId: {{ $json.session_id }}

Esse padrão garante que, independentemente da origem dos dados, o fluxo sempre terá um campo válido de entrada.

Boas práticas para evitar esse tipo de erro

Sempre normalize os dados antes de enviá-los para nodes de IA ou memória.

Evite depender diretamente da estrutura retornada por APIs externas sem tratamento prévio.

Mantenha um padrão consistente de campos em todo o fluxo, especialmente em integrações com WhatsApp, CRMs ou sistemas de atendimento.

Quando utilizar arrays, garanta que apenas um valor seja utilizado como entrada, evitando múltiplos itens simultâneos sem controle.

Valide sempre o output do node anterior ao AI Agent para garantir que o campo input está presente.

Impacto em automações com IA

Esse tipo de erro pode interromper completamente fluxos automatizados de atendimento, envio de mensagens ou processamento de dados, afetando diretamente a experiência do usuário final.

Em ambientes de produção, especialmente em integrações com WhatsApp ou sistemas de atendimento automatizado, esse tipo de falha pode resultar em perda de mensagens, respostas inconsistentes ou interrupções no fluxo de conversa.

Conclusão

O erro “input values have X keys” no n8n está diretamente relacionado à ausência do campo input no payload enviado aos nodes de IA.

Apesar de parecer aleatório em alguns cenários, ele é causado por inconsistências na estrutura dos dados entre execuções.

A padronização do JSON antes do processamento é a forma mais eficiente de evitar esse problema de forma definitiva.

Se você está enfrentando dificuldades com fluxos no n8n, integrações com APIs ou automações com inteligência artificial, a Saldaris Consultoria oferece suporte especializado para análise, correção e otimização dos seus processos.

Entre em contato pelo formulário abaixo e descubra como podemos ajudar a tornar seus fluxos mais estáveis, seguros e escaláveis.

Erro: Formulário de contato não encontrado.