Przejdź do głównej zawartości
TicketingHub Help

Jak skonfigurować webhooki

Webhooki wysyłają wybrane zdarzenia z TicketingHub do innego systemu w momencie ich wystąpienia.

Zanim rozpoczniesz

  • Webhooki muszą być włączone na Twoim koncie TicketingHub. Skontaktuj się z TicketingHub, jeśli brakuje sekcji Webhooki.
  • Potrzebujesz uprawnień administratora lub menedżera.
  • System odbierający musi udostępniać publiczny adres URL HTTPS.

Dodawanie webhooka

  1. Przejdź do Ustawienia → Zaawansowane.
  2. Znajdź sekcję Webhooki i wybierz Edytuj.
  3. Wybierz Nowy webhook.
  4. Wprowadź adres URL HTTPS, na który będą wysyłane zdarzenia.
  5. Wybierz typy zdarzeń, które mają być wysyłane, na przykład potwierdzenie lub anulowanie rezerwacji.
  6. Opcjonalnie: wprowadź silny sekret, aby system odbierający mógł zweryfikować każde żądanie.
  7. Utwórz webhook, a następnie wykonaj jedno z wybranych zdarzeń, aby go przetestować.

Jeśli dodasz sekret, TicketingHub podpisuje każde żądanie i wysyła podpis w nagłówku X-TicketingHub-Signature-256. Twój programista powinien zweryfikować ten podpis przed zaakceptowaniem danych.

Utrzymywanie aktywności webhooka

System odbierający powinien szybko odpowiadać statusem powodzenia 2xx. TicketingHub ponawia próby dostarczenia danych, jeśli żądanie przekroczy limit czasu lub system zwróci niepomyślną odpowiedź. Punkt końcowy, który nadal nie działa poprawnie, zostaje automatycznie wyłączony. Napraw system odbierający, a następnie wróć do strony Webhooki i włącz webhook ponownie.

TicketingHub wysyła zdarzenia wyłącznie na adresy publiczne. Jeśli adres URL wskazuje prywatny adres sieciowy, na przykład serwer w Twojej własnej sieci, TicketingHub nie wysyła zdarzenia i natychmiast wyłącza webhook. Na stronie Webhooki pojawi się komunikat „Adres URL wskazuje prywatny adres sieciowy”, a administratorzy Twojego konta otrzymają wiadomość e-mail. Zmień adres URL na publiczny adres HTTPS, a następnie włącz webhook ponownie.

Wybieraj tylko potrzebne zdarzenia i unikaj używania testowego adresu URL na koncie produkcyjnym. Aby wysyłać zdarzenia do Zapier bez tworzenia własnego odbiornika, zapoznaj się z artykułem Jak połączyć TicketingHub z Zapierem. Aby utworzyć integrację, która dodatkowo pobiera dane z TicketingHub, zapoznaj się z artykułem Jak utworzyć i używać tokenu API.