Przejdź do głównej treści

Workflowy n8n

AI-School może uruchamiać workflowy n8n przez produkcyjny webhook. Jest to przydatne, gdy chcesz uruchomić zautomatyzowany proces poza AI-School, na przykład utworzyć zadanie, zaktualizować rekord CRM, rozpocząć proces raportowania albo przekazać dane formularza do innego systemu.

Przykład: artykuł aktualności na stronie szkoły​

Załóżmy, że szkoła utworzyła workflow n8n, który publikuje artykuł aktualności na stronie WordPress. W AI-School użytkownik wpisuje tylko krótki tekst, na przykład kilka zdań o tygodniu projektowym, dniu sportu lub dniu otwartym. Ten tekst uruchamia workflow w n8n.

Workflow n8n może następnie na przykład:

  1. Przekształcić krótki tekst w dopracowany szkic za pomocą węzła LLM i promptu pasującego do tonu szkoły.
  2. Utworzyć pasującą ilustrację za pomocą drugiego węzła LLM, na przykład w kolorach szkoły i w rozpoznawalnym stylu ilustracyjnym.
  3. Przygotować lub opublikować tekst i obraz jako wpis blogowy na stronie WordPress.

Tak współpracują AI-School i n8n: w AI-School użytkownik wybiera workflow i wpisuje potrzebne informacje. n8n wykonuje potem zautomatyzowane kroki i dba o to, aby artykuł trafił poprawnie na stronę.

Co robi ta integracja?​

Workflow n8n uruchamiasz z widoku workflowów. Jeśli workflow ma pola, najpierw je wypełniasz. Bez pól workflow uruchamia się od razu.

  • Jeśli workflow nie ma pól, webhook jest wywoływany natychmiast.
  • Jeśli workflow ma pola, najpierw otwiera się okno dialogowe. Użytkownik wypełnia formularz, a następnie uruchamia workflow przyciskiem.
  • Wprowadzone wartości są wysyłane jako JSON w żądaniu POST do webhooka n8n.

Utwórz workflow n8n w AI-School​

Administrator rejestruje workflow w następujący sposób:

  1. Przejdź do Asystenci.
  2. Otwórz Workflows.
  3. Wybierz Nowy workflow n8n.
  4. Wprowadź nazwę workflow i produkcyjny URL n8n.
  5. Ustaw Header authentication z nazwą headera i tajną wartością headera.
  6. Opcjonalnie dodaj pola, które mają być wysyłane w żądaniu POST.
  7. Zapisz workflow.

Pola​

  • Pola są opcjonalne.
  • Każde pole ma jedną nazwę i jeden typ.
  • Obsługiwane typy pól to krótki tekst, długi tekst, liczba, tak/nie i data.
  • Pola wymagane muszą być uzupełnione przed uruchomieniem workflow.
  • Nazwa pola staje się kluczem w JSON body wysyłanym do n8n.

Utworzenie kompatybilnego workflow w n8n​

  1. Utwórz nowy workflow w n8n.
  2. Dodaj Webhook Trigger jako pierwszy node.
  3. Ustaw HTTP Method na POST.
  4. Skonfiguruj Header authentication w n8n. Użyj tej samej nazwy i wartości headera co w aplikacji.
  5. Skopiuj Production URL webhooka. Nie używaj URL-a testowego.
  6. Aktywuj workflow w n8n.
  7. Użyj odebranego JSON body w kolejnych node’ach n8n.

Przykład JSON body​

Jeśli zdefiniujesz pola o nazwach prompt, customerName i date, n8n otrzyma na przykład taki JSON body:

{
  "prompt": "Utwórz krótkie podsumowanie zgłoszenia.",
  "customerName": "Przykładowa organizacja",
  "date": "2026-09-22"
}

Ważne ograniczenia​

  • Obsługiwane są tylko Webhook Triggers.
  • Obsługiwane są tylko produkcyjne URL-e webhooków.
  • Testowe URL-e z /webhook-test/ są odrzucane.
  • Obsługiwany jest tylko POST.
  • Obsługiwana jest tylko generic header authentication.
  • Wartość headera jest traktowana w aplikacji jako sekret.
  • Tenant jest ustalany po stronie serwera na podstawie zalogowanego użytkownika, a nie wartości wysłanej przez przeglądarkę.

Rozwiązywanie problemów​

  • 404 lub webhook niezarejestrowany: aktywuj workflow w n8n i użyj Production URL.
  • Błąd uwierzytelniania: sprawdź, czy nazwa i wartość headera są identyczne w obu systemach.
  • Brakujące dane: sprawdź, czy nazwy pól w aplikacji odpowiadają kluczom oczekiwanym przez n8n.
  • Brak żądania w n8n: sprawdź, czy workflow zaczyna się od Webhook Trigger i używa POST.
WhatsApp