Formgong + Make: заявки з форми у сценарій

Що потрібно

• Formgong: будь-який тариф. На Free одна адреса вебхука на форму, на Pro і Business — п'ять.
• Make: підходить безкоштовний тариф: 1000 кредитів на місяць і два активні сценарії. Прийом даних із вебхука теж витрачає кредити.
• Час: близько десяти хвилин і одна тестова заявка.

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

Покроково

1. У Make створіть сценарій. Знайдіть Webhooks і оберіть Custom webhook.
2. Біля поля Webhook натисніть Add. Дайте назву, наприклад «Formgong – Контакти». Поле API Key authentication лишіть порожнім: Formgong не вміє слати заголовок x-make-apikey. Натисніть Save і скопіюйте адресу.
3. У Formgong відкрийте Мої форми → ваша форма → Налаштування форми → Вебхук. Вставте адресу і натисніть «Додати вебхук».
4. У Make натисніть Run once. Модуль чекає на дані.
5. Надішліть одну справжню заявку з сайту. Вона краща за «Надіслати тест», бо в тесті є лише поле message.
6. Make покаже знайдену структуру даних. Додайте наступний модуль, наприклад Google Sheets → Add a row, і зіставте поля.
7. Збережіть сценарій і ввімкніть його. Сценарії з вебхуком запускаються, щойно приходять дані.

Що отримує Make

Кожна справжня заявка приходить одним JSON-пакетом. Поля форми лежать у submission.fields під тими іменами, що у вашому HTML. Усі значення — текст.

{
  "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
  }
}

Службові поля на кшталт access_key, _redirect і botcheck вирізаються. Якщо форма приймає файли, додається список attachments з назвами, розмірами й посиланнями. Посилання відкриваються лише власнику форми після входу, тож Make файли не завантажить.

POST <your webhook URL>
Content-Type: application/json
User-Agent: Formgong-Webhook
X-Formgong-Event: submission.created
X-Signature: sha256=<64 hex characters>

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

У Make модуль 1 — це Custom webhook. Клацніть поле в панелі зіставлення або введіть шлях.

Додали поле у форму пізніше? Відкрийте модуль вебхука, натисніть Detect new values і надішліть ще одну заявку.

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

Хто дізнається адресу вебхука, може слати на неї фальшиві дані. Підпис від цього захищає. Formgong підписує сире тіло запиту HMAC-SHA256 «Секретом підпису» з вкладки «Вебхук».

1. Відредагуйте вебхук у Make: Get request headers — Yes, увімкніть JSON pass-through.
2. Після вебхука додайте фільтр з умовою нижче. Функція sha256 у Make повертає HMAC, якщо передати їй ключ.
3. Після фільтра додайте JSON → Parse JSON, щоб знову зіставляти поля.

Filter condition (Text operators: Equal to)

  sha256(<raw JSON text from module 1>; "hex"; "<your signing secret>")

  equals

  replace(first(map(1.headers; "value"; "name"; "x-signature")); "sha256="; "")

Звірте назви з першим пакетом: імена заголовків зазвичай приходять малими літерами. Перевірте на одній справжній заявці, перш ніж покладатися на фільтр. Секрет бачить кожен, хто може редагувати сценарій. Якщо натиснете «Оновити секрет» у Formgong, оновіть і фільтр.

Тестування і повтори

• Make відповідає 200 Accepted, щойно пакет потрапив у чергу. Formgong позначає доставку як успішну.
• У «Останніх доставках» Formgong видно кожну спробу з кодом відповіді. Починайте пошук проблеми звідти.
• Якщо Make відповів помилкою або думав довше 10 секунд, Formgong повторить через 30 секунд, 2, 10 і 30 хвилин.
• Повтор після повільної відповіді може принести ту саму заявку двічі. Відсіюйте дублі за submission.id.

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

• 410 Gone: Make вимикає вебхук, не прив'язаний до сценарію 5 днів. Прив'яжіть його знову або створіть новий і замініть адресу у Formgong.
• 400 Queue is full: сценарій вимкнено або скінчилися кредити, і черга заповнилася. Увімкніть сценарій чи докупіть кредити; Formgong повторює спроби близько 42 хвилин.
• 429: Make приймає до 300 запитів за 10 секунд на вебхук. Форма до цього майже не дійде.
• Немає полів: натисніть Detect new values і надішліть нову заявку.
• Група чекбоксів в одному полі: позначені пункти з однаковим ім'ям приходять одним рядком, наприклад Email, Телефон. Щоб отримати масив, використайте {{split(1.submission.fields.contact; ", ")}}.
• У «Останніх доставках» порожньо: заявку позначено як спам або утримано. Перевірте вхідні форми.