Перейти до основного змісту

n8n workflow

AI-School може запускати n8n workflow через production webhook. Це корисно, коли потрібно запустити автоматизований процес поза AI-School, наприклад створити завдання, оновити CRM-запис, запустити звітний процес або передати дані форми в іншу систему.

Приклад: новина на сайті школи​

Уявімо, що школа створила workflow n8n, який публікує новину на WordPress-сайті. У AI-School користувач вводить лише короткий текст, наприклад кілька речень про проєктний тиждень, спортивний день або день відкритих дверей. Цей текст запускає workflow в n8n.

Після цього workflow n8n може, наприклад:

  1. Перетворити короткий текст на охайний чернетковий матеріал за допомогою LLM node і prompt, що відповідає тону школи.
  2. Створити відповідну ілюстрацію другим LLM node, наприклад у кольорах школи і впізнаваному ілюстративному стилі.
  3. Підготувати або опублікувати текст і зображення як blog post на WordPress-сайті.

Так AI-School і n8n працюють разом: у AI-School користувач обирає workflow і вводить потрібну інформацію. Потім n8n виконує автоматизовані кроки й забезпечує коректне розміщення новини на сайті.

Що робить ця інтеграція?​

Workflow n8n запускається з огляду workflow. Якщо workflow має поля, ви спочатку заповнюєте їх. Без полів workflow запускається одразу.

  • Якщо workflow не має полів, webhook викликається одразу.
  • Якщо workflow має поля, спочатку відкривається діалог. Користувач заповнює форму, а потім запускає workflow кнопкою.
  • Введені значення надсилаються як JSON у POST-запиті до n8n webhook.

Створення n8n workflow у AI-School​

Адміністратор реєструє workflow так:

  1. Перейдіть до Асистенти.
  2. Відкрийте Workflows.
  3. Виберіть Новий n8n workflow.
  4. Введіть назву workflow і production URL n8n.
  5. Налаштуйте Header authentication з назвою header і секретним значенням header.
  6. За потреби додайте поля, які потрібно надіслати в POST-запиті.
  7. Збережіть workflow.

Поля​

  • Поля необов’язкові.
  • Кожне поле має одну назву і один тип.
  • Підтримувані типи полів: короткий текст, довгий текст, число, так/ні та дата.
  • Обов’язкові поля потрібно заповнити перед запуском workflow.
  • Назва поля стає ключем у JSON body, який надсилається до n8n.

Створення сумісного workflow в n8n​

  1. Створіть новий workflow у n8n.
  2. Додайте Webhook Trigger як перший node.
  3. Встановіть HTTP Method на POST.
  4. Налаштуйте Header authentication у n8n. Використовуйте ту саму назву header і значення, що й у застосунку.
  5. Скопіюйте Production URL webhook. Не використовуйте тестовий URL.
  6. Активуйте workflow у n8n.
  7. Використовуйте отриманий JSON body у наступних n8n nodes.

Приклад JSON body​

Якщо ви визначите поля prompt, customerName і date, n8n отримає, наприклад, такий JSON body:

{
  "prompt": "Створіть короткий підсумок запиту.",
  "customerName": "Приклад організації",
  "date": "2026-09-22"
}

Важливі обмеження​

  • Підтримуються лише Webhook Triggers.
  • Підтримуються лише production webhook URLs.
  • Тестові webhook URLs з /webhook-test/ відхиляються.
  • Підтримується лише POST.
  • Підтримується лише generic header authentication.
  • Значення header обробляється в застосунку як секрет.
  • Tenant визначається server-side на основі користувача, який увійшов у систему, а не на основі значення, надісланого браузером.

Усунення проблем​

  • 404 або webhook не зареєстровано: активуйте workflow у n8n і використовуйте Production URL.
  • Помилка автентифікації: перевірте, чи назва header і значення точно однакові в обох системах.
  • Відсутні дані: перевірте, чи назви полів у застосунку відповідають ключам, які очікує n8n.
  • Немає запиту в n8n: перевірте, чи workflow починається з Webhook Trigger і використовує POST.
WhatsApp