Ir para o conteúdo principal

Workflows n8n

AI-School pode iniciar workflows n8n através de um webhook de produção. Isto é útil quando quer acionar um processo automatizado fora do AI-School, por exemplo criar uma tarefa, atualizar um registo CRM, iniciar um fluxo de relatório ou enviar dados de formulário para outro sistema.

Exemplo: notícia no site da escola​

Imagine que a escola criou um workflow n8n que publica uma notícia no site WordPress. No AI-School, o utilizador introduz apenas um texto curto, por exemplo algumas frases sobre uma semana de projetos, um dia desportivo ou um dia aberto. Esse texto inicia o workflow no n8n.

Depois, o workflow n8n pode, por exemplo:

  1. Transformar o texto curto num rascunho cuidado com um nó LLM e um prompt adequado ao tom da escola.
  2. Criar uma ilustração adequada com um segundo nó LLM, por exemplo usando as cores da escola e um estilo ilustrativo reconhecível.
  3. Preparar ou publicar o texto e a imagem como artigo de blog no site WordPress.

É assim que o AI-School e o n8n trabalham em conjunto: no AI-School, o utilizador escolhe o workflow e introduz a informação necessária. Depois, o n8n executa os passos automatizados e garante que a notícia fica corretamente no site.

O que esta integração faz?​

Inicia um workflow n8n a partir da visão geral de workflows. Se o workflow tiver campos, preenche-os primeiro. Sem campos, o workflow é iniciado imediatamente.

  • Se o workflow não tiver campos, o webhook é acionado imediatamente.
  • Se o workflow tiver campos, abre-se primeiro uma janela. O utilizador preenche o formulário e depois inicia o workflow com o botão.
  • Os valores introduzidos são enviados como JSON num pedido POST para o webhook n8n.

Criar um workflow n8n no AI-School​

Um administrador regista o workflow da seguinte forma:

  1. Vá para Assistentes.
  2. Abra Workflows.
  3. Escolha Novo workflow n8n.
  4. Introduza o nome do workflow e o URL de produção do n8n.
  5. Configure Header authentication com um nome de header e um valor secreto.
  6. Opcionalmente adicione os campos que devem ser enviados no pedido POST.
  7. Guarde o workflow.

Campos​

  • Os campos são opcionais.
  • Cada campo tem um único nome e um tipo.
  • Os tipos suportados são texto curto, texto longo, número, sim/não e data.
  • Os campos obrigatórios devem ser preenchidos antes de iniciar o workflow.
  • O nome do campo torna-se a chave no corpo JSON enviado para o n8n.

Criar um workflow compatível no n8n​

  1. Crie um novo workflow no n8n.
  2. Adicione um Webhook Trigger como primeiro nó.
  3. Defina HTTP Method como POST.
  4. Configure a autenticação por header no n8n. Use o mesmo nome e valor de header que introduz na aplicação.
  5. Copie a Production URL do webhook. Não use o URL de teste.
  6. Ative o workflow no n8n.
  7. Use o corpo JSON recebido nos nós seguintes do n8n.

Exemplo de corpo JSON​

Se definir campos chamados prompt, customerName e date, o n8n recebe um corpo JSON como este:

{
  "prompt": "Crie um resumo curto do pedido.",
  "customerName": "Example organization",
  "date": "2026-09-22"
}

Limitações importantes​

  • Apenas Webhook Triggers são suportados.
  • Apenas URLs de webhook de produção são suportados.
  • URLs de teste com /webhook-test/ são rejeitados.
  • Apenas POST é suportado.
  • Apenas generic header authentication é suportada.
  • O valor do header é tratado como segredo na aplicação.
  • O tenant é determinado no servidor a partir do utilizador autenticado, não a partir de um valor enviado pelo navegador.

Resolução de problemas​

  • 404 ou webhook não registado: ative o workflow no n8n e use o URL de produção.
  • Erro de autenticação: verifique se o nome e o valor do header são exatamente iguais nos dois sistemas.
  • Dados em falta: verifique se os nomes dos campos na aplicação correspondem às chaves esperadas pelo n8n.
  • Nenhum pedido no n8n: confirme que o workflow começa com um Webhook Trigger e usa POST.
WhatsApp