API do n8n: o que dá para fazer e como usar com agentes de IA
O n8n é uma ferramenta de automação de fluxos que pode ser usada na nuvem ou instalada no servidor da empresa. Sua API pública permite gerenciar workflows e execuções, e cada workflow pode expor um webhook próprio. É usada por times técnicos que já têm automações e querem acioná-las de outros sistemas.
Os grandes recursos da API, em português claro.
Listagem, criação, ativação e desativação de workflows.
Consulta do histórico e do resultado das execuções.
Gatilhos HTTP que iniciam um workflow com os dados enviados.
Gestão das credenciais usadas pelos workflows.
Organização dos workflows por etiqueta ou projeto.
Como se acessa a API do n8n.
- Com credencial da sua empresaA API pública usa uma chave de API criada nas configurações do n8n; os webhooks de workflow podem ter autenticação própria, como cabeçalho ou básica.
- Documentação oficialdocs.n8n.io/api
- A disponibilidade da API pública pode variar conforme plano e versão do n8n.
- Webhooks sem autenticação podem ser acionados por qualquer um: proteja-os.
- Em instalação própria, mantenha o n8n atualizado e com acesso restrito.
- api n8n
- n8n api documentação
- n8n webhook
- n8n public api
- n8n api key
- integração n8n com ia
- n8n agente de ia
O que um agente do iTeam faz com a API do n8n.
O agente aciona workflows que a empresa já mantém no n8n, como gerar proposta ou sincronizar cadastro, a partir de um pedido em linguagem natural.
O agente consulta execuções que falharam, resume o erro e avisa o dono do workflow.
Quando o workflow precisa de decisão, ele chama o iTeam, o agente pede aprovação ao responsável e devolve a resposta.
O agente lista workflows ativos, sem dono ou parados há tempo, para revisão do time.
Da credencial ao agente trabalhando, com aprovação.
Gere a chave da API e mapeie os webhooks
No n8n, crie a chave de API e identifique os webhooks dos workflows que o agente poderá acionar.
Cadastre no cofre do iTeam
Chave e URLs ficam no cofre; cada agente recebe a lista exata de workflows que pode disparar.
Teste com dados de exemplo
Rode cada workflow com dados de teste, confira o retorno e mantenha aprovação para os que mexem em dinheiro ou clientes.
Dúvidas sobre a API do n8n.
A API do n8n é gratuita?
Depende de como o n8n é usado: na versão instalada pela empresa o custo é a infraestrutura, e na nuvem segue o plano contratado. Verifique as condições da sua edição.
Preciso programar para usar a API do n8n com o iTeam?
Não necessariamente. O iTeam lê a documentação e as URLs dos webhooks e o time de implantação liga os workflows aos agentes.
Por que usar o iTeam se já tenho n8n?
O n8n executa fluxos definidos; o agente do iTeam entende pedidos, decide qual fluxo usar, pede aprovação e conversa com as pessoas. Os dois se complementam.