Webhooki

Webhook to najszybszy sposób, by odpowiedź z formularza trafiła do Twojego systemu. Nie musisz pytać: „czy coś nowego przyszło?”. Gatherino wywołuje Twój endpoint w chwili, gdy nadejdzie odpowiedź.

Warto wiedzieć: edytor Gatherino i konto są dostępne po angielsku lub czesku. Formularze wypełniane przez respondentów mogą być wyświetlane w 18 językach, w tym po polsku.

Typowe zastosowania

Zapis do własnego systemu

Zamówienie prosto do sklepu, lead do CRM, zgłoszenie do wewnętrznej bazy danych.

Połączenie z narzędziami do automatyzacji

Skieruj webhook do dowolnej usługi, która przyjmuje przychodzące webhooki — najczęściej Zapier, Make lub n8n.

Własne powiadomienia

Wiadomość do wewnętrznego czatu, bramki SMS lub własnego panelu.

Jak to skonfigurować

  1. 1

    Przygotuj endpoint

    Adres URL na Twoim serwerze, który przyjmuje żądanie HTTPS POST z treścią w formacie JSON.

  2. 2

    Dodaj adres URL do formularza

    Wpisz adres webhooka w ustawieniach formularza lub użyj kroku webhook w automatyzacji.

  3. 3

    Przetwórz dane

    Treść zawiera odpowiedź wraz z wartościami pól. Kluczami są identyfikatory pól formularza — ich etykiety pobierzesz ze szczegółów formularza przez API.

  4. 4

    Przetestuj

    Wyślij testową odpowiedź i sprawdź, czy Twój system odebrał i przetworzył żądanie.

Przykład odbiornika (Node.js)

Minimalny odbiornik, który zapisuje zgłoszenie po Twojej stronie:

app.post('/gatherino-hook', express.json(), (req, res) => {
  const submission = req.body;
  // submission.data holds the form field values
  saveToDatabase(submission);
  res.sendStatus(200);   // respond fast, do the work in the background
});

Bezpieczeństwo: webhooki docierają wyłącznie do publicznych adresów HTTPS — wywołania do wewnętrznych i prywatnych zakresów IP są blokowane, aby webhooka nie dało się wykorzystać do sondowania Twojej sieci wewnętrznej. Zabezpiecz endpoint tajnym tokenem w adresie URL i sprawdzaj, czy dane mają oczekiwaną postać.

FAQ

W jakim formacie są dane?

JSON opisujący zgłoszenie — identyfikator, znacznik czasu, status oraz obiekt z wartościami pól.

Co, jeśli mój serwer chwilowo nie działa?

Przyjmij żądanie szybko, a przetwarzanie przenieś do działania w tle. Brakujące dane zawsze możesz uzupełnić przez REST API.

Czy mogę mieć więcej niż jeden webhook?

Tak — oprócz webhooka na poziomie formularza możesz dodać kroki webhook w automatyzacjach, z warunkami.

Czy działa z Zapier lub Make?

Tak, wystarczy wkleić do formularza adres URL przychodzącego webhooka wygenerowany przez te usługi.

Powiązane

Wypróbuj Gatherino za darmo

Plan darmowy: 3 formularze i 100 odpowiedzi miesięcznie. Bez karty kredytowej, dane hostowane w UE.

Zacznij za darmo →