Topyn

Hogyan küldök értesítést egy külső rendszernek a jegyek eseményeiről?

A Webhookok oldalon megadod a cél URL-t és az eseményeket; a rendszer minden eseménynél aláírt HTTP-kérést küld, a kézbesítési naplóban pedig követed és újraküldöd a hívásokat.

Frissítve: 2026. október 2.

A webhook egy külső rendszer címe, amelyre a Service Desk értesítést küld, amikor egy jegyen történik valami – például létrejön, állapotot vált, vagy az ügyfél válaszol. A Admin fül Webhookok oldalán hozod létre.

Új webhook

Az Új webhook ablak kulcs-, név- és URL-mezője
  1. Nyisd meg a Webhookok oldalt, és kattints az Új webhook gombra.
  2. Add meg a Kulcs mezőt 1 – erre hivatkozik az automatizálás webhook-művelete, és később nem módosítható.
  3. Add meg a Név és az URL 2 mezőt. Csak nyilvánosan elérhető http vagy https cím adható meg – belső hálózati címre a rendszer nem küld.
  4. Jelöld be az Események közül, mikor kapjon értesítést. Ha egyet sem jelölsz be, a webhook csak akkor hívódik, amikor egy automatizálási szabály kifejezetten meghívja.
  5. Ha a belső jegyzeteknek is el kell jutniuk a külső rendszerbe, jelöld be ezt: Belső jegyzetek is
  6. Kattints a Létrehozás gombra, és másold ki a megjelenő aláíró titkot.
Az aláíró titkot csak most, egyszer látod. Ha elveszett, a webhook oldalán a Titkos kulcs cseréje gombbal újat generálhatsz – a régi azonnal érvénytelen lesz.

Hogyan ellenőrzi a fogadó oldal?

Minden kérés JSON-törzzsel, POST módszerrel érkezik, és ezekkel a fejlécekkel:

  • X-Topyn-Event – az esemény neve;
  • X-Topyn-Delivery – a kézbesítés egyedi azonosítója;
  • X-Topyn-Signature – t=<időbélyeg>,v1=<aláírás> alakban, ahol az aláírás az <időbélyeg>.<törzs> szöveg HMAC-SHA256 lenyomata az aláíró titokkal.

A fogadó rendszer számolja ki ugyanezt a lenyomatot, és csak akkor fogadja el a kérést, ha egyezik.

Kézbesítési napló és hibák

A webhook Kézbesítések listája sikeres, újrapróbált és sikertelen hívásokkal
  • A webhook oldalán a Kézbesítések listában minden hívás látszik az állapotával (Sikeres, Újrapróbálkozás, Sikertelen és a többi), a próbálkozások számával és az utolsó HTTP-státusszal. A Újraküldés gombbal 1 újraküldheted.
  • A Teszt küldése gombbal próbahívást indítasz.
  • Sikertelen hívásnál a rendszer egyre ritkábban újrapróbálja: 1, 5, 30 perc, majd 2, 6, 12 és 24 óra múlva.
  • Ha a cím tartósan nem fogad – sok egymást követő hiba és három nap siker nélkül –, a webhook letiltódik (Letiltva (ismételt hiba)). A Folytatás gombbal indítod újra.
A webhookok Pro és Enterprise csomagban érhetők el: Pro csomagban legfeljebb 10, Enterprise-ban 50 webhook hozható létre.

Kapcsolódó

Hasznos volt?