Topyn

Hogyan értesít a Munka egy külső rendszert webhookkal?

A Beállítások › Munka oldal Webhookok kártyáján egy URL-t és eseményeket adsz meg; a Munka aláírt kérést küld, ha egy elem indíthatóvá válik, állapotot vált, felelőst kap vagy elakad.

Frissítve: 2026. október 2.

A webhookkal egy külső rendszer azonnal értesül, ha valami történik a Munkában. A Beállítások › Munka oldal Webhookok kártyáján kattints az Új webhook gombra, add meg a fogadó címet és az eseményeket – a Munka ezután minden eseményről egy aláírt HTTP kérést küld oda.

Webhook létrehozása

Az Új webhook ablak kitöltött URL mezővel, a négy eseménnyel és a Projektek résszel
  1. A Webhookok kártyán kattints az Új webhook gombra.
  2. Add meg a fogadó címet (URL) 1. Nyilvános, interneten elérhető címnek kell lennie.
  3. Válaszd ki az Események közül, miről kérsz értesítést 2: Elem indulásra kész lett, Állapot változott, Kiosztva vagy Elakadt. Alapból mind be van jelölve.
  4. A Projektek részben 3 szűkítheted projektekre; üresen hagyva minden projektre vonatkozik.
  5. Kattints a Webhook létrehozása gombra, és a következő ablakban másold ki az aláíró titkot. Ez csak egyszer látszik.

Mit kap a fogadó rendszer?

Minden eseményről egy JSON-törzsű POST kérést, ezekkel a fejlécekkel:

  • X-Work-Event – az esemény neve, például work.item.status_changed;
  • X-Work-Delivery – a kézbesítés egyedi azonosítója;
  • X-Work-Signature – sha256= után a törzs HMAC-SHA256 aláírása az aláíró titokkal. Ezzel ellenőrizheted, hogy a kérés tényleg a Munkától jött.

Ha a kézbesítés nem sikerül

  • A 2xx válasz sikeres kézbesítés.
  • Más válasznál vagy hibánál a Munka újrapróbálja: 1, 5, 30, 120 és 480 perc múlva. Ha az utolsó is sikertelen, a kézbesítés elmarad.
  • 20 egymást követő sikertelen kézbesítés után, illetve azonnal, ha a cím 410-es választ ad, a Munka leállítja a webhookot.

A listában minden webhooknál látod, aktív-e, mely eseményekre szól, mikor volt az utolsó kézbesítés, és hány sikertelen volt egymás után.

Műveletek a listában

  • Szüneteltetés és Folytatás – ideiglenesen leállítod vagy újraindítod a kézbesítést.
  • Titok cseréje – új aláíró titkot kapsz; ami a régit ellenőrzi, onnantól elbukik.
  • Törlés – megerősítés után a kézbesítés azonnal leáll.
A Webhookok kártyát a Tulajdonos és a Menedzser éri el.

Kapcsolódó

Hasznos volt?