КОРОТКО
  • Test URL працює під час ручного listening; production URL — після activation workflow.
  • Перевіряйте signature на raw body, якщо provider використовує HMAC.
  • Швидко повертайте acknowledgement, а довгу роботу виконуйте асинхронно.
ПРАКТИЧНЕ ЗАВДАННЯ · НАВЧАЛЬНІ ДАНІ

Практика: контракт для POST-заявки

Визначте контракт до налаштування nodes: які поля приймає endpoint, хто має доступ і коли відповідь вважається успішною. Тестовий URL і опублікований URL мають різні режими роботи.

  1. Налаштуйте POST і автентифікацію, доступну у вашій версії. Для тесту запустіть очікування події та надішліть синтетичний JSON.
  2. Перевірте обов’язкові поля, типи й довжини. Повертайте зрозумілу помилку до будь-якого запису в CRM.
  3. Визначте значення success: подію прийнято в чергу чи вже записано. Не обіцяйте завершену операцію, якщо виклик тільки почався.
  4. Повторіть event_id, неправильний метод і запит без авторизації. Для production перевірте URL, режим публікації та налаштування reverse proxy.
{"event_id":"webhook-001","email":"demo@example.com","source":"contact_form"}

Що перевірити

ПрикладОчікуваний результат
POST з валідними полямиОчікуваний success-код
Немає авторизаціїВідмова до обробки
Повторна доставкаОдин бізнес-результат

Код 200 не доводить правильність запису. Перевіряйте кінцеву систему й не повторюйте небезпечну дію після timeout без перевірки результату.

Завантажити завдання
01

Test URL і production URL

Test URL потрібен для розробки й слухає один test execution. Production URL стабільний та працює після activation. Не підключайте зовнішній provider до test URL: після закриття editor events почнуть губитися.

WEBHOOK_URL має відповідати публічному HTTPS domain. За reverse proxy передавайте правильний protocol і host, інакше n8n покаже внутрішню адресу.

02

Authentication і signature

  • Використовуйте supported authentication або перевіряйте secret header.
  • Для HMAC зберігайте raw body до JSON transformation.
  • Порівнюйте signature constant-time способом у custom code/backend.
  • Перевіряйте timestamp, щоб обмежити replay window.
  • Не повертайте stack trace, credentials чи provider secret.
03

Idempotency і повторні доставки

Provider може повторити event після timeout або 5xx. Збережіть event_id у database чи data store перед незворотною дією. Якщо ID вже оброблено, поверніть success без повторного платежу, листа або CRM record.

Якщо provider не дає event_id, сформуйте key з business identifier і version. Timestamp сам по собі недостатній.

04

Коли відповідати webhook

Для короткого flow можна відповісти після завершення. Для AI, document processing або кількох API calls безпечніше перевірити запит, записати job і швидко повернути 202 або provider-compatible acknowledgement.

Встановіть timeout на зовнішні calls. Error path має відрізняти retryable failure від permanent validation error.

БЕЗКОШТОВНИЙ ASSET

10 стартових n8n workflow

Стартові схеми у JSON. Підключіть власні інтеграції, перевірте помилки й дублікати перед запуском.

ОФІЦІЙНІ ДЖЕРЕЛА
ЧАСТІ ПИТАННЯ
Чому n8n test webhook не працює постійно?

Test URL слухає під час test execution. Для постійного приймання активуйте workflow й використовуйте production URL.

Як захистити webhook?

Authentication, signature validation, replay window, schema validation, rate limit і мінімальні error responses.

Як уникнути подвійної обробки?

Зберігати provider event_id та робити незворотні дії idempotent.

ЯК СТВОРЕНО МАТЕРІАЛ

Підготовлено командою AI Insider на основі власних впроваджень і офіційної документації продуктів. Технічні умови й тарифи змінюються — перевіряйте їх перед production-рішенням.