TabbitBlog

Fluxo de navegador no n8n com resultados verificáveis

Chame o navegador de um subfluxo, valide a resposta e confira o estado antes de repetir uma gravação.

Neste artigo
  1. E se não houver um nó para o site?
  2. Separe o fluxo do navegador
  3. Importe o subfluxo
  4. Valide a resposta antes de encaminhá-la
  5. Confira antes de repetir
  6. Comece com uma ação e uma asserção

E se não houver um nó para o site?

Confira primeiro se uma API autorizada oferece a ação. Se for preciso manipular um controle renderizado ou acessar uma página autenticada, conecte um navegador por HTTP. O fluxo valida a entrada, confere o resultado e escolhe a rota. Um AI Agent pode chamar esse subfluxo como ferramenta.

Em um portal de teste, o navegador clica em Confirm demo e lê o estado. O n8n guarda o ID e verifica se o registro mudou. Se a resposta falhar, consulte o estado antes de enviar novamente. A operação pode ter surtido efeito mesmo que a resposta não tenha chegado. Ferramentas de automação web Busca e controle

Separe o fluxo do navegador

CamadaTarefaEvidência
Fluxo pai ou AI AgentEscolher a ação permitida e enviar uma solicitaçãoID e destino
Subfluxo de navegadorValidar, chamar o executor e classificar a respostaResultado estruturado ou revisão
NavegadorAbrir, confirmar o registro, agir e relerID, estado inicial e final
Aplicação ou armazenamento durávelResolver incerteza e evitar duplicatasResultado anterior ou estado desconhecido

HTTP Request chama o serviço. O navegador determina a página e a sessão em uso. Dê à ferramenta uma ação específica e deixe o executor identificar a página pela configuração aprovada. Confira a conta antes de usar uma sessão autenticada. Duas discussões no n8n apontam a diferença entre extrair e agir na interface, além do risco de rodar a mesma automação duas vezes. Conectar um navegador existente Conferir uma sessão Discussão sobre navegador Discussão de idempotência

Importe o subfluxo

Baixe o JSON do n8n e o adaptador de teste do Tabbit. O exemplo usa n8n, Node.js e Tabbit CLI na mesma máquina. A ação ocorre em uma página sintética sem contas externas. Inicie o adaptador, importe o JSON e execute Manual Test.

node tabbit-fixture-adapter.mjs

O adaptador escuta na interface local na porta 3219. Se o n8n roda num contêiner ou outro computador, localhost pertence a esse ambiente. Estabeleça conexão autorizada antes de trocar o endereço nos dois nós HTTP. Exemplo de localhost na nuvem

No AI Agent pai, adicione Call n8n Workflow Tool, escolha o subfluxo e mapeie operation_id e scenario para Workflow Tool Input. Passe um item por chamada. Mantenha o ID num nó comum. Em produção, derive o ID do registro e da ação para reutilizá-lo ao tentar novamente. Call n8n Workflow Tool Dados de subfluxos

Valide a resposta antes de encaminhá-la

Verifique estado HTTP, ID da operação, ID de teste, OFF inicial, ON final e uma gravação. Uma resposta positiva sem os valores previstos passa para revisão. O agente pode resumir o resultado, mas os nós seguintes usam os campos validados.

{
  "operation_id": "E09-lost-response",
  "outcome": "reconciled",
  "receipt_source": "read_back",
  "http_status": 200,
  "fixture_id": "E09-FIXTURE",
  "state": "ON",
  "writes": 1,
  "replay": false
}

Nesse resultado, http_status vem da consulta GET. Mantenha a falha POST separada no log da execução. Uma falha de rede sem código HTTP também indica um resultado desconhecido. Nó HTTP Request

Confira antes de repetir

CenárioO que verificarResultado esperado
Resposta normalPOST confirma o registro e ONconfirmed, uma gravação
Falha após mudançaPOST 503, GET acha a mesma operação e ONreconciled, uma gravação
Estado desconhecidoPOST 503, GET não acha a operaçãoneeds_review, sem repetir envio
Mesmo ID confirmadoExecutor devolve resultado guardadoMesmo resultado, uma gravação no total

O adaptador guarda o estado em memória. Em produção, use armazenamento durável, chaves únicas e leitura de estado depois de reiniciar. Registre a ação e o destino antes da gravação. Devolva resultados confirmados e consulte ou encaminhe os desconhecidos. Repita a gravação apenas se a aplicação aplicar a mesma chave, ou se uma pessoa confirmar que não ocorreu e autorizar outra tentativa. Tratamento de erros no n8n Verificação de formulário real

Importamos o fluxo disponível para download no n8n 2.46.6 com Node.js 24.16.0. Um fluxo local separado fez as chamadas com uma entrada por execução. A primeira rodada retornou confirmed (200), reconciled (503 seguido de 200) e needs_review (503 seguido de 404). O adaptador registrou dois cliques no Tabbit. Ao repetir os mesmos IDs, devolveu os dois recibos salvos e manteve o terceiro em revisão, sem cliques adicionais. O teste usou uma página simulada e não chamou nenhum modelo de linguagem.

Comece com uma ação e uma asserção

Teste manualmente antes de ligar o AI Agent. Confira se os nós distinguem resultado direto, reconciliado e pendente de revisão. Se a primeira tarefa usa conta real, comece com leitura. Primeira tarefa web O que faz um agente

Perguntas frequentes

O que fazer se o n8n não tiver um nó para o site?

Registre um subfluxo de navegador com escopo definido ou chame um serviço pelo HTTP Request.

HTTP Request é um navegador?

Ele chama um endpoint. O navegador cuida da renderização, dos cliques e da sessão autorizada.

O que o navegador deve devolver?

ID da operação, resultado, ID do registro, estado observado e evidência suficiente para conferir.

Posso repetir um envio que falhou?

Consulte o estado pelo mesmo ID antes de repetir. Se continuar incerto, encaminhe para revisão.

A tentativa precisa de outro ID?

Reutilize o ID estável para a mesma operação. Use outro ID para uma ação ou registro diferente.

Dê o próximo passo

Deixe o Tabbit trabalhar ao seu lado.

Pesquise entre abas, automatize o trabalho repetitivo do navegador e mantenha todo o contexto ao alcance.