Como testar uma automação antes de a entregar à equipa

Essa experiência, mais do que qualquer checklist teórica, mostra porque vale a pena este cuidado.

Por que vale a pena isolar o ponto de partida

A primeira etapa de qualquer automação é onde os dados entram no sistema, e é aí que costumam aparecer os problemas mais bobos. Se o formulário não estiver bem montado, tudo o que vem a seguir recebe informação errada ou incompleta.

Na aula, ao tentar ligar um formulário do meu WordPress ao Make, o primeiro obstáculo nem foi técnico no sentido complexo: foi simplesmente não conseguir montar um formulário funcional. O Elementor que eu tinha instalado pedia licença Pro só para criar um formulário, e o plugin de Contact Form 7 que usei a seguir precisava de um addon pago para disparar um webhook diretamente. Tive de mudar de abordagem e usar a integração nativa do Elementor com o Make para conseguir avançar sem pagar por algo que não precisava.

Depois disso, quando o formulário finalmente ligou ao Make, a informação chegou toda condensada numa única célula da folha, porque o mapeamento inicial não separava nome, e-mail e mensagem. Só depois de pedir ajuda ao ChatGPT para escrever uma fórmula de separação é que consegui distribuir a informação em colunas legíveis.

Se estiveres a montar algo parecido, vale a pena verificar isto antes de mostrar a folha à equipa: mete um registo de teste e confirma se cada campo cai na coluna certa, sem misturas. E se a plataforma que estás a usar tiver várias versões de plugins de formulário, vale a pena confirmar antes de tudo se a integração que precisas está mesmo incluída na versão gratuita, em vez de descobrires isso só depois de já teres construído o resto do fluxo.

Por que as credenciais e permissões merecem atenção antes de tudo

Aprendi que ligar ferramentas como o Gmail ou o Google Sheets a plataformas de automação exige ativar APIs específicas na Google Cloud Console. Sem isso, a automação não avança, mesmo que o resto do fluxo esteja bem desenhado. Percebi isto na prática ao tentar configurar credenciais.

Na aula isto aconteceu de forma muito concreta: ao tentar ligar o Gmail e o Google Drive ao n8n, fui bloqueado repetidamente porque as APIs do Gmail e do Drive não estavam ativas no projeto, e porque tinha apagado umas credenciais antigas numa outra formação. Resolver isto exigiu seguir a documentação da própria Google passo a passo, criar um novo ecrã de consentimento, ativar as bibliotecas necessárias e gerar novas credenciais de cliente.

Recomendo que faças este trabalho de configuração de permissões antes de qualquer teste com dados reais. Um erro deste tipo, visível na aula como um "access blocked" ou erro 403, pode surgir quando a equipa já estiver a usar o sistema, transformando-se diretamente num problema em produção.

Como planear uma aplicação com Claude Code antes de começar a programar

Como usar a IA no negócio para além das perguntas ao chatbot

Para desenhar a execução e tratar as exceções, consulta o guia de automação de processos empresariais.

Por que a correspondência de linhas precisa de uma chave clara

Quando uma automação atualiza uma folha existente, precisa de saber exatamente qual linha alterar. Se a regra de correspondência estiver mal definida, o sistema pode nunca encontrar a linha certa. Vi isto suceder quando testei o passo de atualização no n8n.

Foi exatamente isso que aconteceu na aula: ao tentar que o n8n atualizasse a coluna com a mensagem gerada pela IA, o passo de "update row" falhava porque a correspondência estava a ser feita pela própria coluna que eu queria escrever, em vez de usar um identificador estável. Só depois de mudar a chave de correspondência para o campo de e-mail é que a atualização passou a acertar na linha certa, com a ajuda de instruções que pedi ao ChatGPT para entender o erro.

Antes de dar a folha à equipa, testa isto com dois ou três registos parecidos e confirma que cada atualização cai exatamente onde deveria. Escolhe sempre como chave um campo único por definição, como um e-mail, e evita campos que possam repetir-se, como o nome.

CONTEXTO, PLANO, CONSTRUÇÃO, VALIDAÇÃO

Dar contexto, preparar o plano e validar o resultado fazem parte do trabalho de construir com IA.

Por que vale a pena observar como a IA interpreta casos reais

Quando um agente de IA gera texto para enviar a clientes, o resultado inicial raramente vem pronto. Na aula, a primeira versão da mensagem gerada veio com informação de contexto que não devia aparecer no corpo do e-mail, e sem formatação nenhuma pensada para ser lida.

Corrigir isto exigiu reescrever as instruções dadas ao agente, pedindo explicitamente um formato HTML limpo, com uma estrutura definida: saudação, espelho do pedido, forma como a empresa ajuda, uma pergunta objetiva e um fecho com "vamos contactar em breve". Só depois dessa segunda tentativa é que a mensagem saiu num formato aceitável para enviar.

Antes de deixares um agente destes a responder a clientes reais, testa-o com mensagens variadas e vê se o resultado sai sempre dentro do tom que queres. Também vale a pena testar com mensagens curtas ou vagas, só para ver como o agente reage quando tem pouca informação, porque é nesses casos-limite que normalmente aparecem os erros mais visíveis.

Por que um teste ponta a ponta evita surpresas depois de ligar o gatilho automático

Só depois de cada etapa isolada estar a funcionar é que faz sentido ligar o fluxo todo em automático. Na aula, depois de resolvido o formulário, o mapeamento, as credenciais e a formatação da mensagem, testei o fluxo completo enviando pedidos fictícios e confirmando, em tempo real, que a mensagem chegava à caixa de entrada.

Mesmo assim, ficou um detalhe por afinar: o disparo automático a cada nova linha não estava totalmente fiável, e uma das mensagens chegou duplicada a quem tinha submetido o formulário. É um bom exemplo de que, mesmo depois de um teste bem-sucedido, vale a pena correr o fluxo mais do que uma vez antes de o considerar pronto para funcionar sem supervisão.

Se estiveres a validar um fluxo semelhante, eu deixaria o acionador automático desligado durante a fase de testes e correria o fluxo manualmente, passo a passo, até confirmar que cada etapa se comporta de forma previsível mais do que uma vez. Só depois disso ligaria o gatilho automático, de preferência primeiro com contactos internos antes de expor o sistema a leads reais.

Sextas Ímpares #125: Como automatizar tarefas com ajuda da IA

Esta reflexão nasce da aula que dei em direto nas Sextas Ímpares #125. Nessa sessão montei ao vivo, com tropeços e tudo, uma automação que liga um formulário do WordPress ao Google Sheets, depois a um agente de IA no n8n e finalmente ao envio de um e-mail personalizado pelo Gmail. Ficou tudo gravado, incluindo os erros, porque é isso que mostra o processo real de testar antes de entregar algo à equipa.

Passagem 1 · 01:45:28 · Passagem 2 · 02:21:41