Workflow-uri n8n
AI-School poate porni workflow-uri n8n printr-un webhook de producție. Este util când vrei să declanșezi un proces automatizat în afara AI-School, de exemplu să creezi o sarcină, să actualizezi un CRM, să pornești un flux de raportare sau să trimiți datele unui formular către alt sistem.
Exemplu: articol de știri pe site-ul școlii
Să presupunem că școala a creat un workflow n8n care publică un articol de știri pe site-ul WordPress. În AI-School, utilizatorul introduce doar un text scurt, de exemplu câteva propoziții despre o săptămână de proiecte, o zi sportivă sau o zi a porților deschise. Cu acel text pornește workflow-ul în n8n.
Workflow-ul n8n poate apoi, de exemplu:
- Să transforme textul scurt într-un draft bine scris cu un nod LLM și un prompt potrivit tonului școlii.
- Să creeze o ilustrație potrivită cu un al doilea nod LLM, de exemplu folosind culorile școlii și un stil ilustrativ recognoscibil.
- Să pregătească sau să publice textul și imaginea ca articol de blog pe site-ul WordPress.
Așa colaborează AI-School și n8n: în AI-School, utilizatorul alege workflow-ul și completează informațiile necesare. n8n execută apoi pașii automatizați și se asigură că articolul ajunge corect pe site.
Ce face această integrare?
Pornești un workflow n8n din prezentarea generală a workflow-urilor. Dacă workflow-ul are câmpuri, le completezi mai întâi. Fără câmpuri, workflow-ul pornește imediat.
- Dacă workflow-ul nu are câmpuri, webhook-ul este declanșat imediat.
- Dacă workflow-ul are câmpuri, se deschide mai întâi un dialog. Utilizatorul completează formularul și apoi pornește workflow-ul cu butonul.
- Valorile introduse sunt trimise ca JSON într-o cerere POST către webhook-ul n8n.
Creează un workflow n8n în AI-School
Un administrator înregistrează workflow-ul astfel:
- Mergi la Asistenți.
- Deschide Workflows.
- Alege Workflow n8n nou.
- Introdu numele workflow-ului și URL-ul de producție n8n.
- Setează Header authentication cu un nume de header și o valoare secretă.
- Adaugă opțional câmpurile care trebuie trimise în cererea POST.
- Salvează workflow-ul.
Câmpuri
- Câmpurile sunt opționale.
- Fiecare câmp are un singur nume și un tip.
- Tipurile acceptate sunt text scurt, text lung, număr, da/nu și dată.
- Câmpurile obligatorii trebuie completate înainte de pornirea workflow-ului.
- Numele câmpului devine cheia din JSON body trimis către n8n.
Creează un workflow compatibil în n8n
- Creează un workflow nou în n8n.
- Adaugă un Webhook Trigger ca primul node.
- Setează HTTP Method la POST.
- Configurează Header authentication în n8n. Folosește același nume și aceeași valoare de header ca în aplicație.
- Copiază Production URL al webhook-ului. Nu folosi URL-ul de test.
- Activează workflow-ul în n8n.
- Folosește JSON body primit în următoarele node-uri n8n.
Exemplu de JSON body
Dacă definești câmpuri numite prompt, customerName și date, n8n primește de exemplu acest JSON body:
{
"prompt": "Creează un scurt rezumat al solicitării.",
"customerName": "Organizație exemplu",
"date": "2026-09-22"
}
Limitări importante
- Sunt acceptate doar Webhook Triggers.
- Sunt acceptate doar URL-uri de webhook de producție.
- URL-urile de test cu
/webhook-test/sunt respinse. - Este acceptat doar POST.
- Este acceptată doar generic header authentication.
- Valoarea header este tratată ca secret în aplicație.
- Tenant-ul este determinat server-side pe baza utilizatorului autentificat, nu pe baza unei valori trimise de browser.
Depanare
- 404 sau webhook neînregistrat: activează workflow-ul în n8n și folosește Production URL.
- Eroare de autentificare: verifică dacă numele și valoarea header sunt identice în ambele sisteme.
- Date lipsă: verifică dacă numele câmpurilor din aplicație corespund cheilor așteptate de n8n.
- Nicio cerere în n8n: verifică dacă workflow-ul începe cu un Webhook Trigger și folosește POST.