Formgong + Make: zgłoszenia z formularza w scenariuszu

Zanim zaczniesz

• Formgong: dowolny plan. Formularz na Free może mieć jeden webhook, na Pro i Business pięć.
• Make: wystarczy darmowy plan: 1000 kredytów miesięcznie i dwa aktywne scenariusze. Odczyt danych z webhooka też zużywa kredyty.
• Czas: około dziesięciu minut i jedno zgłoszenie testowe.

Interfejs Make jest po angielsku, dlatego nazwy przycisków podajemy po angielsku.

Krok po kroku

1. W Make utwórz scenariusz. Wyszukaj Webhooks i wybierz Custom webhook.
2. Obok pola Webhook kliknij Add. Nadaj nazwę, np. „Formgong – Kontakt”. Pole API Key authentication zostaw puste: Formgong nie wysyła nagłówka x-make-apikey. Kliknij Save i skopiuj adres.
3. W Formgong otwórz Moje formularze → Twój formularz → Ustawienia formularza → Webhook. Wklej adres i kliknij „Dodaj webhook”.
4. W Make kliknij Run once. Moduł czeka na dane.
5. Wyślij jedno prawdziwe zgłoszenie ze strony. Jest lepsze niż „Wyślij test”, bo test ma tylko pole message.
6. Make pokaże wykrytą strukturę danych. Dodaj kolejny moduł, np. Google Sheets → Add a row, i zmapuj pola.
7. Zapisz scenariusz i włącz go. Scenariusze z webhookiem startują, gdy tylko przyjdą dane.

Co dostaje Make

Każde prawdziwe zgłoszenie przychodzi jako jeden pakiet JSON. Pola formularza są w submission.fields, pod nazwami z Twojego HTML. Wszystkie wartości to tekst.

{
  "event": "submission.created",
  "form": {
    "id": "6f1c2a9e-4b7d-4e0a-9c3f-2d8b5e7a1f40",
    "name": "Kontakt"
  },
  "submission": {
    "id": "b3e04c51-8a2f-4d6e-9f17-0c5a3b8d2e96",
    "created_at": "2026-10-03T09:15:00.000Z",
    "page_url": "https://example.com/contact",
    "fields": {
      "name": "Anna Nowak",
      "email": "anna@example.com",
      "phone": "+48501234567",
      "message": "Proszę o wycenę 20 sztuk",
      "utm_source": "google"
    },
    "is_spam": false
  }
}

Pola techniczne, takie jak access_key, _redirect czy botcheck, są usuwane. Jeśli formularz przyjmuje pliki, dochodzi lista attachments z nazwami, rozmiarami i linkami. Linki otwiera tylko zalogowany właściciel formularza, więc Make nie pobierze plików.

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

Mapowanie pól

W Make moduł 1 to Custom webhook. Kliknij pole w panelu mapowania albo wpisz ścieżkę.

Dodałeś później pole do formularza? Otwórz moduł webhooka, kliknij Detect new values i wyślij jeszcze jedno zgłoszenie.

Opcjonalnie: weryfikacja podpisu

Kto pozna adres webhooka, może wysyłać na niego fałszywe dane. Podpis to blokuje. Formgong podpisuje surową treść żądania HMAC-SHA256 „Sekretem podpisu” z zakładki Webhook.

1. Edytuj webhook w Make: Get request headers na Yes i włącz JSON pass-through.
2. Za webhookiem dodaj filtr z warunkiem poniżej. Funkcja sha256 w Make zwraca HMAC, gdy podasz klucz.
3. Za filtrem dodaj JSON → Parse JSON, żeby znowu mapować pola.

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="; "")

Sprawdź nazwy w pierwszym pakiecie: nagłówki zwykle przychodzą małymi literami. Przetestuj na jednym prawdziwym zgłoszeniu, zanim zaczniesz na tym polegać. Sekret widzi każdy, kto może edytować scenariusz. Po kliknięciu „Odnów sekret” w Formgong zaktualizuj też filtr.

Testy i ponowienia

• Make odpowiada 200 Accepted, gdy pakiet trafi do kolejki. Formgong oznacza doręczenie jako udane.
• „Ostatnie doręczenia” w Formgong pokazują każdą próbę z kodem odpowiedzi. Tam zacznij szukać, gdy brakuje danych.
• Jeśli Make odpowie błędem albo myśli dłużej niż 10 sekund, Formgong ponowi próbę po 30 sekundach, 2, 10 i 30 minutach.
• Ponowienie po wolnej odpowiedzi może przynieść to samo zgłoszenie dwa razy. Odsiewaj duplikaty po submission.id.

Gdy coś nie działa

• 410 Gone: Make wyłącza webhook, który przez 5 dni nie jest przypięty do scenariusza. Przypnij go znowu albo utwórz nowy i zmień adres w Formgong.
• 400 Queue is full: scenariusz jest wyłączony albo skończyły się kredyty, a kolejka się zapełniła. Włącz scenariusz lub dokup kredyty; Formgong ponawia próby przez około 42 minuty.
• 429: Make przyjmuje do 300 żądań na 10 sekund na webhook. Formularz rzadko to osiągnie.
• Brak pól: kliknij Detect new values i wyślij nowe zgłoszenie.
• Grupa checkboxów w jednym polu: zaznaczone pola o tej samej nazwie przychodzą jako jeden tekst, np. Email, Telefon. Aby dostać tablicę, użyj {{split(1.submission.fields.contact; ", ")}}.
• Puste „Ostatnie doręczenia”: zgłoszenie oznaczono jako spam albo wstrzymano. Sprawdź skrzynkę formularza.