Formgong + n8n: приймаємо заявки через Webhook node

Що потрібно

• n8n Cloud: платні тарифи від 20 € на місяць при оплаті за рік, є пробний період. За словами n8n, дані Cloud зберігаються у Франкфурті.
• Власний сервер: Community Edition безкоштовна. Formgong шле запити лише на HTTPS, порт 443 і публічний домен. Адресу http://localhost:5678 чи IP з локальної мережі він не прийме. Поставте n8n за reverse proxy із TLS-сертифікатом і вкажіть цю публічну адресу в змінній WEBHOOK_URL.
• Formgong: на Free один вебхук на форму, на Pro і Business — п'ять. Заміна тестової адреси на робочу займає той самий слот.

Інтерфейс n8n англійською, тож назви полів нижче англійські.

Покроково

1. Створіть workflow і додайте тригер Webhook.
2. HTTP Method — POST. Path зробіть зрозумілим, наприклад formgong-contact.
3. Authentication лишіть None: Formgong не передає Basic, заголовки чи JWT. Замість цього перевіряйте підпис (нижче). IP allowlist теж не підійде: Formgong шле запити з мережі Cloudflare, а не з фіксованих адрес.
4. Respond — Immediately. Formgong чекає відповіді лише 10 секунд.
5. Скопіюйте Test URL. У Formgong відкрийте Налаштування форми → Вебхук, вставте адресу і натисніть «Додати вебхук».
6. У n8n натисніть Listen for test event і надішліть справжню заявку з сайту.
7. Додайте наступні вузли і зіставте поля. Коли все працює, видаліть тестову адресу у Formgong і додайте Production URL.
8. Опублікуйте workflow. Робочі запуски видно у вкладці Executions, а не на полотні.

Що видає Webhook node

Вузол повертає headers, params, query і body. JSON від Formgong лежить у body.

{
  "event": "submission.created",
  "form": {
    "id": "6f1c2a9e-4b7d-4e0a-9c3f-2d8b5e7a1f40",
    "name": "Контакти"
  },
  "submission": {
    "id": "b3e04c51-8a2f-4d6e-9f17-0c5a3b8d2e96",
    "created_at": "2026-10-03T09:15:00.000Z",
    "page_url": "https://example.com/contact",
    "fields": {
      "name": "Олена Коваль",
      "email": "olena@example.com",
      "phone": "+380501234567",
      "message": "Порахуйте, будь ласка, 20 одиниць",
      "utm_source": "google"
    },
    "is_spam": false
  }
}

Імена заголовків приходять малими літерами: $json.headers["x-signature"] і $json.headers["x-formgong-event"].

Зіставлення полів

Щоб пропускати тестові доставки, в опціях Webhook node вкажіть Only Run If: {{ $json.body.event === 'submission.created' }}. Запити, що не підійшли, все одно отримують 200, тож Formgong їх не повторює.

За бажанням: перевірка підпису

Підпис — це HMAC-SHA256 від сирого тіла з ключем «Секрет підпису» з вкладки «Вебхук». У n8n його можна перевірити без коду:

1. В опціях Webhook node увімкніть Raw Body. Тіло прийде як бінарні дані.
2. Додайте вузол Crypto: дія Hmac, Binary File увімкнено, бінарна властивість із Webhook node, тип SHA256, кодування HEX. Секрет підпису вкажіть у полі Hmac Secret облікових даних Crypto.
3. Додайте вузол If: sha256= плюс результат Crypto має дорівнювати {{ $('Webhook').item.json.headers['x-signature'] }}.
4. На гілці true вузол Extract from File (Extract From JSON) знову перетворить сире тіло на поля.

SECRET='<your signing secret>'
URL='<your webhook URL>'
BODY='{"event":"webhook.test","form":{"id":"x","name":"Test"},"submission":{"id":"test","created_at":"2026-10-03T09:15:00.000Z","page_url":null,"fields":{"message":"Formgong test"},"is_spam":false}}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
curl -sS -X POST "$URL" \
  -H 'content-type: application/json' \
  -H 'x-formgong-event: webhook.test' \
  -H "x-signature: sha256=$SIG" \
  --data "$BODY"

Якщо щось не працює

• 404 в «Останніх доставках»: Test URL працює лише один раз і лише поки n8n слухає. Production URL працює лише в опублікованому workflow.
• Formgong не приймає адресу: вона має починатися з https://, використовувати порт 443 і вести на публічний домен.
• Тайм-аути й дублі: із Respond = When Last Node Finishes повільний workflow може перевищити 10 секунд. Тоді Formgong повторить запит, і workflow запуститься знову. Відповідайте одразу і перевіряйте submission.id перед створенням записів.
• Статус 3xx: proxy, що робить редирект (http на https чи без кінцевого слеша), — це помилка. Вставляйте адресу точно так, як її показує n8n.
• Група чекбоксів в одному полі: позначені пункти з однаковим ім'ям приходять одним рядком, наприклад Email, Телефон. Щоб отримати масив, використайте {{ $json.body.submission.fields.contact.split(', ') }}.