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
Przygotuj endpoint
Adres URL na Twoim serwerze, który przyjmuje żądanie HTTPS POST z treścią w formacie JSON.
- 2
Dodaj adres URL do formularza
Wpisz adres webhooka w ustawieniach formularza lub użyj kroku webhook w automatyzacji.
- 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
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 →