Vai al contenuto principale

Workflow n8n

AI-School può avviare workflow n8n tramite un webhook di produzione. È utile quando vuoi attivare un processo automatizzato fuori da AI-School, ad esempio creare un'attività, aggiornare un record CRM, avviare un flusso di report o inoltrare dati di un modulo a un altro sistema.

Esempio: notizia sul sito della scuola​

Immagina che la scuola abbia creato un workflow n8n che pubblica una notizia sul sito WordPress. In AI-School, l’utente inserisce solo un breve testo, ad esempio alcune frasi su una settimana di progetto, una giornata sportiva o un open day. Con quel testo viene avviato il workflow in n8n.

Il workflow n8n può poi, ad esempio:

  1. Trasformare il breve testo in una bozza curata con un nodo LLM e un prompt adatto al tono della scuola.
  2. Creare un’illustrazione adatta con un secondo nodo LLM, ad esempio usando i colori della scuola e uno stile illustrativo riconoscibile.
  3. Preparare o pubblicare testo e immagine come post del blog sul sito WordPress.

Ecco come AI-School e n8n collaborano: in AI-School, l’utente sceglie il workflow e inserisce le informazioni necessarie. n8n esegue poi i passaggi automatizzati e fa in modo che la notizia arrivi correttamente sul sito.

Che cosa fa questa integrazione?​

Avvii un workflow n8n dalla panoramica dei workflow. Se il workflow contiene campi, li compili prima. Senza campi, il workflow viene avviato subito.

  • Se il workflow non ha campi, il webhook viene attivato immediatamente.
  • Se il workflow ha campi, si apre prima una finestra. L’utente compila il modulo e poi avvia il workflow con il pulsante.
  • I valori inseriti vengono inviati come JSON in una richiesta POST al webhook n8n.

Creare un workflow n8n in AI-School​

Un amministratore registra il workflow così:

  1. Vai a Assistenti.
  2. Apri Workflows.
  3. Scegli Nuovo workflow n8n.
  4. Inserisci il nome del workflow e l’URL di produzione n8n.
  5. Imposta Header authentication con un nome header e un valore header segreto.
  6. Aggiungi facoltativamente i campi da inviare nella richiesta POST.
  7. Salva il workflow.

Campi​

  • I campi sono facoltativi.
  • Ogni campo ha un solo nome e un tipo.
  • I tipi supportati sono testo breve, testo lungo, numero, sì/no e data.
  • I campi obbligatori devono essere compilati prima di avviare il workflow.
  • Il nome del campo diventa la chiave nel corpo JSON inviato a n8n.

Creare un workflow compatibile in n8n​

  1. Crea un nuovo workflow in n8n.
  2. Aggiungi un Webhook Trigger come primo nodo.
  3. Imposta HTTP Method su POST.
  4. Configura Header authentication in n8n. Usa lo stesso nome e valore header inseriti nell’applicazione.
  5. Copia la Production URL del webhook. Non usare l’URL di test.
  6. Attiva il workflow in n8n.
  7. Usa il corpo JSON ricevuto nei nodi n8n successivi.

Esempio di corpo JSON​

Se definisci campi chiamati prompt, customerName e date, n8n riceve un corpo JSON come questo:

{
  "prompt": "Create a short summary of the request.",
  "customerName": "Example organization",
  "date": "2026-09-22"
}

Limitazioni importanti​

  • Sono supportati solo i Webhook Trigger.
  • Sono supportati solo gli URL webhook di produzione.
  • Gli URL di test con /webhook-test/ vengono rifiutati.
  • È supportato solo POST.
  • È supportata solo la generic header authentication.
  • Il valore header viene trattato come segreto nell’applicazione.
  • Il tenant viene determinato lato server dall’utente connesso, non da un valore inviato dal browser.

Risoluzione dei problemi​

  • 404 o webhook non registrato: attiva il workflow in n8n e usa l’URL di produzione.
  • Errore di autenticazione: controlla che nome e valore header siano identici in entrambi i sistemi.
  • Dati mancanti: controlla che i nomi dei campi nell’applicazione corrispondano alle chiavi attese da n8n.
  • Nessuna richiesta in n8n: verifica che il workflow inizi con un Webhook Trigger e usi POST.
WhatsApp