Tem ações que um agente IA não deveria tomar sozinho.

Enviar um e-mail pra base de 10 mil contatos. Fazer uma cobrança. Postar no nome da empresa. Deletar registros. Nessas horas, o custo de um erro é alto demais pra deixar a IA decidir sem checkpoint.

O módulo Human in the Loop ensina como construir fluxos no n8n que pausam antes de executar, esperam aprovação de um humano via Telegram, e só seguem se a resposta for positiva. São 11 aulas, do conceito ao fluxo funcionando.

Para quem é esse módulo

Para quem já usa n8n e quer adicionar uma camada de controle humano em ações sensíveis.

É aplicável tanto em automações internas (relatórios, cobranças, alterações de dados) quanto em agentes de atendimento que fazem ações externas em nome do cliente.

Pré-requisito: saber criar fluxos básicos no n8n. O módulo usa Telegram como canal de aprovação e a API da OpenAI pra parte de IA.

O que tem dentro

Estrutura do módulo Human in the Loop no n8n: fluxo de aprovação e configuração de credenciais

Conceito e fluxo (3 aulas)

Começa apresentando o problema e as duas formas de implementar o checkpoint humano no n8n: usando o node de Telegram com botões de aprovação, ou usando o node Wait que pausa o fluxo até receber uma resposta via webhook.

Cada abordagem tem trade-offs. O Telegram é mais simples de configurar e funciona bem pra aprovações rápidas. O Wait é mais flexível e se integra melhor a sistemas externos.

Configuração de credenciais (2 aulas)

Cria a credencial da OpenAI e configura o bot do Telegram que vai receber as notificações de aprovação. É o setup técnico necessário antes de construir qualquer fluxo.

Aprovação com Telegram (3 aulas)

A parte principal. Cobre 3 abordagens de aprovação via Telegram:

Approval simples: o fluxo manda uma mensagem pra um chat específico com botões “Aprovar” e “Recusar”. O n8n aguarda o clique.

Free text: o aprovador responde com texto livre. O n8n lê a resposta e decide.

Custom form: o aprovador preenche um formulário estruturado. Útil quando a aprovação precisa de mais contexto (ex.: “aprovar mas com observação X”).

Aprovação com node Wait (1 aula)

Mostra como usar o node Wait nativo do n8n como mecanismo de checkpoint. O fluxo para na execução, salva o estado e retoma quando uma requisição externa aciona o webhook de retomada.

Essa abordagem é mais robusta pra workflows longos onde o tempo entre acionamento e aprovação pode ser grande.

Tempo total e nível

Nível: intermediário Aulas: 11 Carga estimada: ~41 minutos de conteúdo

Módulo direto ao ponto. O tempo curto é real: o conceito é simples e as aulas são densas.

Quando usar Human in the Loop

Algumas situações onde vale adicionar um checkpoint:

Ações financeiras: qualquer automação que dispara pagamento, reembolso ou cobrança.

Comunicações em escala: envio de e-mail/WhatsApp pra muitas pessoas. Um erro de segmentação pode causar dano de imagem.

Alterações de dado crítico: deletar registros, alterar status de cliente, encerrar contrato.

Respostas de IA com alto risco de erro: quando o agente está atuando em domínio que ele erra com frequência e o erro tem consequência.

Próximo passo

Human in the Loop é uma das camadas que fazem um agente de IA confiável pra empresa. Sem ele, o agente precisa ser testado exaustivamente pra cada caso. Com ele, você coloca o humano onde ele importa e deixa a IA fazer o resto.

A Formação em Agentes IA e Automações da ibe.IA mostra como construir esse tipo de sistema do zero e entregá-lo como produto pra qualquer empresa.

Conheça a Formação em Agentes IA e Automações

E se essa leitura te ajudou a entender o que está acontecendo, segue a ibe.IA no Instagram (@ibe.ia) que toda semana sai conteúdo desse jeito.