Webhookami

Webhookami pozwalają Twoim własnym systemom być powiadomionymi w momencie, gdy coś się zdarzy w EventMann — rezerwacja potwierdzona, bilet skanowany, wypłata wypłacona — zamiast aby badać zmiany. Znajdują się pod tą samą linią Integracje na pasku bocznym, na karcie Webhookami.

Jak dodać punkt końcowy

1. Przejdź do Integracje → Webhookami → Dodaj
2. Daj mu nazwę i publiczny adres URL http(s), który powinien otrzymać połączenia — prywatny lub wewnętrzny adres jest odrzucany od razu, zarówno tutaj jak i za każdym razem, gdy webhook faktycznie uruchamia się
3. Zaznacz które typy zdarzeń chcesz otrzymywać
4. Zapisz. 64-znakowy tajny klucz podpisywania jest automatycznie generowany i pokazywany ukryty; użyj Pokaż/Ukryj aby go odkryć raz

Zdarzenia, na które możesz się zapisać

Zdarzenie	Uruchamia się gdy
booking.created	rezerwacja się zaczyna, przed płatnością
booking.confirmed	rezerwacja jest potwierdzona
booking.cancelled	rezerwacja jest anulowana
booking.refunded	rezerwacja ma zwrot
event.created	tworzysz nowe wydarzenie
event.published	wydarzenie idzie na żywo
event.cancelled	wydarzenie jest anulowane
event.updated	szczegóły wydarzenia się zmieniają
ticket.checked_in	bilet jest skanowany na wejściu
payment.received	płatność się osadza
payment.refunded	płatność ma zwrot
payout.created	wypłata jest tworzona
payout.paid	wypłata jest wypłacana
staff.assigned	pracownik jest przypisany do Twojego wydarzenia
staff.checked_in	pracownik się meldujesz przy zmianie
vendor.assigned	dostawca jest przypisany do Twojego wydarzenia
vendor.invoice_submitted	dostawca przesyła fakturę

Sama dostawa

Każde połączenie to POST JSON w kształcie takim:

{"event":"booking.confirmed","data":{"id":1,"reference":"BK-ABC123","status":"confirmed","total":49.99,"currency":"USD","attendee_name":"Jane Doe","attendee_email":"jane@example.com","event_id":10,"confirmed_at":"2026-03-01T12:05:00Z"},"timestamp":"2026-03-01T12:05:00Z","delivery_id":"..."}

Razem z nim otrzymujesz nagłówek X-Webhook-Event nazywający zdarzenie, X-Webhook-Delivery-Id, i nagłówek X-Webhook-Signature — HMAC-SHA256 surowej treści żądania, klucz z tajnym kluczem pokazanym na stronie punktu końcowego. Oblicz to na tej samej drodze na swoim końcu i porównaj zanim uwierzysz ładunkowi.

Ponowne próby i co się dzieje gdy odbiornik jest niedostępny

• Dostawa jest próbowana do 5 razy, czekając 10, potem 30, potem 60 sekund między próbami; tylko odpowiedź 2xx liczy się jako dostarczona
• Po tym jak wszystkie 5 prób dla jednego zdarzenia nie powiedzie się, licznik niepowodzeń punktu końcowego idzie do góry dokładnie o jeden — nie raz za próbę
• 10 nieudanych dostaw w ciągu godziny wznowienia wstrzymuje ten punkt końcowy na 5 minut; jeśli licznik niepowodzeń kiedykolwiek przejdzie 10, lub to wznowienie jest wyzwolone, punkt końcowy automatycznie się wyłącza i przestaje otrzymywać cokolwiek aż do tego czasu jak go naprawisz
• Otrzymasz powiadomienie w aplikacji w momencie gdy to się stanie, podając nazwę punktu końcowego
• Wyłączony punkt końcowy pokazuje powiadomienie “Ten punkt końcowy jest wyłączony”, z powodem, zarówno na liście punktu końcowego jak na jego własnej stronie — zmiana jego nazwy, adresu URL lub zdarzeń go nie przywraca. Napraw cokolwiek było źle z Twoim odbiornikiem, potem użyj przycisku Ponownie włącz; wyczyści licznik niepowodzeń i wznowi dostawę, utrzymując ten sam adres URL i tajny klucz podpisywania
• Historia dostaw — typ zdarzenia, status HTTP, czas trwania i czas — jest przechowywana przez 30 dni a potem jest automatycznie czyszczona

Warto wiedzieć

• Test, na stronie punktu końcowego, wysyła syntetyczne zdarzenie ping aby możliwe sprawdzić Twój odbiornik i weryfikację podpisu zanim zapiszesz się na cokolwiek rzeczywistego
• Ponów próbę na nieudanej dostawie ponownie wysyła to zdarzenie świeżo do Twoich aktualnie aktywnych punktów końcowych — to jest nowa dostawa, nie wznowienie oryginalnego łańcucha prób
• Wysyłki Webhookami działają na swojej własnej kolejce, oddzielonej od checkoutu i e-mailu, więc powolny lub uszkodzony odbiornik na Twoim końcu nie może spowolnić rezerwacji lub e-maili biletów
• Odznaczenie typu zdarzenia po cichu go zatrzymuje przed wysyłką — nie ma powiadomienia że przestałeś otrzymywać cokolwiek

Rozwiązywanie problemów

• Dostawy się zatrzymały bez widocznego błędu z mojej strony — otwórz punkt końcowy i sprawdź jego licznik niepowodzeń i status; jeśli pokazuje wyłączone, napraw Twój odbiornik i kliknij Ponownie włącz
• Podpis nigdy się nie zgadza — zahaszuj dokładną surową treść żądania, a nie ponownie serializowaną kopię, z tajnym kluczem pokazanym na stronie punktu końcowego
• Test się powiedzie ale rzeczywiste zdarzenia nigdy się nie pojawią — potwierdź że konkretny typ zdarzenia jest zaznaczony na tym punkcie końcowym; niezapisane typy są po prostu nigdy nie wysyłane

Powiązane

• Integracje
• Zamówienia
• Check-in
• Wypłaty