Webhookok beállítása

A webhookok a kiválasztott TicketingHub-eseményeket azok bekövetkezésekor továbbítják egy másik rendszerbe.

Mielőtt elkezdi

• A webhookokat engedélyezni kell TicketingHub-fiókjában. Ha hiányzik a Webhookok szakasz, lépjen kapcsolatba a TicketingHub ügyfélszolgálatával.
• Rendszergazdai vagy menedzseri hozzáférésre van szüksége.
• A fogadó rendszernek nyilvánosan elérhető HTTPS-URL-t kell biztosítania.

Webhook hozzáadása

1. Lépjen a Beállítások → Speciális menübe.
2. Keresse meg a Webhookok lehetőséget, majd válassza a Szerkesztés lehetőséget.
3. Válassza az Új webhook lehetőséget.
4. Adja meg azt a HTTPS-URL-t, amely fogadni fogja az eseményeket.
5. Válassza ki a küldendő eseménytípusokat, például a megerősített vagy lemondott foglalást.
6. Opcionális: adjon meg egy erős titkos kulcsot, hogy a fogadó rendszer ellenőrizhesse az egyes kéréseket.
7. Hozza létre a webhookot, majd a teszteléséhez hajtsa végre a kiválasztott események egyikét.

Ha megad egy titkos kulcsot, a TicketingHub minden kérést aláír, és az aláírást az X-TicketingHub-Signature-256 fejlécben küldi el. A fejlesztőnek az adatok elfogadása előtt ellenőriznie kell ezt az aláírást.

Tartsa aktívan a webhookot

A fogadó rendszernek haladéktalanul sikeres 2xx állapotkóddal kell válaszolnia. A TicketingHub újra megpróbálja kézbesíteni azokat az eseményeket, amelyeknél időtúllépés történik, vagy a rendszer sikertelen választ ad. A folyamatosan sikertelen végpont automatikusan letiltásra kerül; javítsa ki a fogadó rendszert, majd térjen vissza a Webhookok oldalára, és engedélyezze újra.

A TicketingHub csak nyilvános címekre küld eseményeket. Ha az URL egy privát hálózati címre, például a saját hálózatán belüli szerverre mutat, a TicketingHub nem küldi el az eseményt, és azonnal letiltja a webhookot. A Webhookok oldalon a „Az URL privát hálózati címre mutat” üzenet jelenik meg, a fiók adminisztrátorai pedig e-mailt kapnak. Módosítsa az URL-t egy nyilvános HTTPS-címre, majd engedélyezze újra a webhookot.

Csak a szükséges eseményeket válassza ki, és éles fiókban ne használjon tesztelési URL-t. Ha saját fogadó rendszer fejlesztése nélkül szeretne eseményeket küldeni a Zapierbe, tekintse meg a TicketingHub csatlakoztatása a Zapierhez című cikket. Ha olyan integrációt szeretne létrehozni, amely adatokat is lekér a TicketingHubból, tekintse meg az API-token létrehozása és használata című cikket.