Erros, testes e aprovação humana

Nesta aula

Uma automação que ninguém vigia não economiza tempo. Ela só muda o dia em que o problema aparece.

Toda automação que eu já coloquei no ar falhou em algum momento. Uma senha expirou, um serviço saiu do ar por uma hora, alguém mudou o nome de uma coluna na planilha. Isso não é motivo para não automatizar. É motivo para montar o fluxo já esperando a falha: com um alerta que avisa na hora e com uma pessoa no ponto certo, antes de qualquer ação que não dá para desfazer. Nesta aula, a automação da escola de idiomas que você montou nas aulas 3 e 4 ganha essas duas proteções.

• Ao final, você vai saber ler o histórico de execuções e reconhecer os quatro erros mais comuns.
• Vai entender onde colocar uma pessoa no fluxo e como fazer isso com uma planilha e um segundo gatilho.
• Vai sair com um entregável: a automação "Contatos do site" com alerta de falha e aprovação humana antes da resposta.

Os quatro erros que você vai encontrar

Erros em automação parecem infinitos, mas quase todos caem em quatro tipos. Reconhecer o tipo já é metade do conserto.

O histórico de execuções: onde você investiga

Toda ferramenta de automação guarda um registro de cada rodada do fluxo. No n8n chama histórico de execuções; no Make e no Zapier o nome muda (histórico do cenário, histórico do Zap), mas é a mesma coisa: uma lista com data, hora, se deu certo ou não, e o detalhe de cada nó.

Quando algo dá errado, esse é o primeiro lugar. Não a planilha, não o formulário, não o prompt. Abra o histórico, procure a execução marcada como falha, clique nela e veja qual nó ficou em vermelho. A mensagem de erro dele diz o tipo do problema, quase sempre em uma das quatro categorias acima.

O que olhar em cada execução

• O dado que entrou no gatilho: o formulário chegou com os campos que você esperava? Um campo vazio aparece aqui.
• O dado que saiu de cada nó: o passo de IA devolveu "Orçamento" ou devolveu uma frase inteira? É aqui que se pega o formato errado.
• O nó em vermelho e a mensagem: "não autorizado" é credencial; "tempo esgotado" é serviço fora do ar.

Alerta de falha: fique sabendo na hora

O problema da escola de idiomas não foi a credencial. Foi o silêncio. Uma automação que falha calada é pior do que não ter automação, porque você acha que está coberto. A solução é um segundo fluxo, pequeno e separado, cujo único trabalho é avisar.

No n8n, procure o gatilho de erro (Error Trigger). Ele não depende de formulário nem de horário: dispara quando qualquer outro fluxo que você apontar para ele falha. Depois dele, coloque uma ação de aviso: um e-mail para a equipe ou uma mensagem pelo canal oficial que vocês usam. No corpo do aviso, use os dados que o gatilho de erro entrega: nome do fluxo, hora, nó que falhou e mensagem de erro. Cada fluxo que você quiser vigiar tem uma configuração para escolher qual fluxo de erro chamar quando quebrar.

No Make e no Zapier a lógica é a mesma: existe um lugar para definir o que fazer quando uma execução falha, e normalmente a própria plataforma manda um e-mail. Muda o nome da caixinha, não o raciocínio.

O aviso precisa ser curto e chegar num canal que alguém realmente olha. Um e-mail assim resolve:

Os nomes entre chaves são os campos que o gatilho de erro do n8n entrega; o nome exato pode variar conforme a versão, então confira na saída do nó antes de usar. A ideia é o que importa: fluxo, nó e mensagem, em três linhas.

Aprovação humana: a pessoa no ponto certo

Na aula 4, a IA passou a classificar cada contato da escola em Orçamento, Dúvida ou Reclamação e a rascunhar uma resposta. O rascunho é bom na maior parte das vezes. Mas "maior parte" não serve para responder um cliente, e muito menos uma reclamação. A regra do curso, desde a aula 1: IA organiza, regra decide, pessoa aprova o que é sensível. Responder cliente é sensível.

A forma mais simples de colocar uma pessoa no fluxo não precisa de nada além da planilha que você já tem. Funciona assim:

1. A planilha "Contatos do site" ganha duas colunas novas: Rascunho e Status.
2. O fluxo da aula 4 continua igual até o passo de IA. Só que, em vez de enviar a resposta, ele grava o rascunho na coluna Rascunho e escreve "aguardando aprovação" na coluna Status.
3. Uma pessoa da escola abre a planilha, lê o rascunho, corrige o que quiser direto na célula e muda o Status para "aprovado". Se não quiser responder, escreve "descartado".
4. Um segundo fluxo, com gatilho de agenda a cada 15 minutos, lê a planilha, filtra só as linhas com Status "aprovado", envia o texto da coluna Rascunho para o e-mail do cliente e troca o Status para "enviado". Se a sua ferramenta tiver um gatilho de "linha atualizada" na planilha, ele serve no lugar da agenda.

Repare no que aconteceu: a pessoa não precisou aprender a ferramenta de automação. Ela aprova numa planilha, que já sabe usar. E nada sai sem passar por ela. O fluxo lê a coluna Status, e a coluna Status só muda pela mão de alguém.

A alternativa: o nó de espera

O n8n tem um nó Esperar (Wait) que consegue parar o fluxo no meio e só continuar quando alguém clica num link de aprovação, enviado por e-mail ou mensagem. É elegante: um clique e a resposta sai. Eu prefiro começar pela planilha, porque ela deixa um registro visível de tudo o que foi aprovado, editado ou descartado, e porque a pessoa pode corrigir o texto antes de aprovar. Quando o time já estiver confortável, o nó de espera é um bom próximo passo.

Testar antes de ligar, e ligar devagar

Alerta e aprovação protegem a automação depois que ela está no ar. Testes protegem antes. Eu sigo uma sequência fixa toda vez:

• Dados fictícios primeiro. Uma planilha de teste, um e-mail seu como destinatário, nomes inventados. Nenhum cliente real até tudo passar.
• Caminho feliz. Envie um formulário completo e certinho. Tudo gravou, o aviso chegou, o rascunho apareceu com Status correto?
• Caminho de erro. Envie um formulário com o telefone vazio. Envie uma mensagem sem sentido para a IA classificar. O fluxo tratou ou quebrou? Se quebrou, o alerta chegou?
• Aprovação de ponta a ponta. Mude o Status para "aprovado" e espere o segundo fluxo. O e-mail saiu uma vez só? O Status virou "enviado"?
• Ligar em produção. Só agora troque a planilha de teste pela real e o e-mail de teste pelo da equipe.

E mesmo depois de ligar, há uma última regra que me poupou de muito constrangimento: nova automação roda uma semana só avisando antes de agir. Em vez de enviar a resposta ao cliente, o fluxo manda para você um e-mail dizendo "eu teria enviado isto para fulano". Você confere por uma semana, com dados reais, sem risco. Se o comportamento estiver certo, libera a ação. Se não, ajusta sem ninguém de fora ter percebido.