Webhooki
Webhook wysyła dane o tym, co dzieje się w wydarzeniu: nowe zamówienie, nowy uczestnik, odprawa przy wejściu. Trafiają one żądaniem POST na podany przez Ciebie adres URL. Tak przekażesz je do CRM, listy mailingowej albo narzędzia do automatyzacji.
Jak to działa
Dodaj webhook w wydarzeniu
W wydarzeniu, w sekcji Webhooki, klikasz Dodaj webhook i wpisujesz URL webhook. To adres, który przyjmie dane: Twój serwer albo narzędzie do automatyzacji, które potrafi odebrać webhook, np. Make, Zapier, n8n.
Wybierz typy zdarzeń
Do wyboru jest 13 typów w czterech grupach. Produkty: utworzony, zaktualizowany, usunięty. Zamówienia: utworzone, zaktualizowane, oznaczone jako opłacone, zwrócone, anulowane. Uczestnicy: utworzony, zaktualizowany, anulowany. Odprawy: utworzona i usunięta.
Odbierz dane w formacie JSON
Każde powiadomienie to żądanie POST z treścią JSON: typ zdarzenia, czas wysłania i dane obiektu. Przy zamówieniu dostajesz też jego uczestników i odpowiedzi na pytania przy zakupie. Nagłówek X-Webhook-Source pokazuje, że żądanie wysłał GoJammin.
Sprawdzaj dostarczenia i wstrzymuj
W tabeli webhooków widzisz status, kiedy webhook był ostatnio uruchomiony i jaką odpowiedź dał Twój serwer. W Dziennikach webhook przejrzysz ostatnie dostarczenia z treścią i kodem odpowiedzi. Webhook przełączysz w każdej chwili na Wstrzymany albo usuniesz.
Co warto wiedzieć
- Webhooki ustawiasz osobno w każdym wydarzeniu. Nie ma jednego webhooka dla całego konta.
- Integracja działa w jedną stronę: GoJammin wysyła dane, a panel nie udostępnia kluczy API do odczytu ani zmiany danych z zewnątrz.
- Twój serwer powinien odpowiedzieć w ciągu 3 sekund. Dłuższe przetwarzanie przenieś do kolejki po swojej stronie.
- Dziennik przechowuje 20 ostatnich dostarczeń każdego webhooka.
- Panel nie pokazuje klucza do weryfikacji podpisu żądań. Jeśli Twój system wymaga uwierzytelnienia, użyj adresu z trudnym do odgadnięcia tokenem.
- Webhooki konfiguruje Administrator lub Organizator. Współpracownik wydarzenia ich nie widzi.
Najczęściej zadawane pytania
Kiedy przychodzi zdarzenie o nowym zamówieniu?
Gdy zamówienie zostanie potwierdzone: po udanej płatności, od razu przy darmowym zamówieniu, a przy płatności offline, gdy zamówienie zaczyna czekać na wpłatę. Razem z nim przychodzi zdarzenie o nowym uczestniku dla każdej osoby z zamówienia.
Czy mogę podłączyć Make, Zapier albo n8n?
Tak, jeśli narzędzie potrafi odebrać webhook. Utwórz w nim adres do odbioru webhooka, wklej go jako URL webhook w wydarzeniu i wybierz typy zdarzeń. Dalej narzędzie przekaże dane do CRM, arkusza albo listy mailingowej.