Webhookok

A webhook lehetővé teszi, hogy a FlexiProject abban a pillanatban értesítsen egy külső rendszert, amikor a szervezetben történik valami. Ahelyett, hogy az API-t újra és újra lekérdezné, hogy változott-e valami, a rendszere HTTP-kérést kap az esemény adataival közvetlenül az esemény bekövetkezte után.

Egy webhook egy esemény és egy fogadó cím összekapcsolására szolgál. Ha két különböző eseményt ugyanarra a címre, vagy ugyanazt az eseményt két rendszernek szeretne elküldeni, hozzon létre két webhookot.

A webhookok a Rendszerbeállítások menü Webhookok fülén konfigurálhatók. A fül a rendszergazdák számára érhető el (lásd: Felhasználók és jogosultságok). Az adatok más csatornán való olvasásához használja az API-t.

Események

A FlexiProject négy eseményt jelez. Minden webhook pontosan egyet figyel közülük, amelyet az Esemény listából választ ki.

Add webhook window with the Event list expanded and the available events highlighted

Esemény Mikor küldi el a FlexiProject a kérést Eseményspecifikus adatok
Projekt létrehozva Új projekt jött létre, bármilyen módon: nulláról, sablonból, klónozással, MS Project- vagy Excel-fájl importálásával, vagy mesterséges intelligencia segítségével. ProjectId, ProjectName, CreatedAt
Projekt törölve Egy projektet töröltek. ProjectId, ProjectName
Jóváhagyás elindítva Egy alaptervmódosítást jóváhagyásra beküldtek, és elindult a jóváhagyási útvonala. ChangeRequestId, ChangeRequestName, ProjectId, ProjectName, Date
Jóváhagyás befejezve A jóváhagyási útvonal eredménnyel zárult: jóváhagyással, elutasítással, javításra visszaadással vagy visszavonással. Archivált projekt esetén a kérés nem megy ki. ChangeRequestId, ChangeRequestName, ProjectId, ProjectName, DecisionDate, Status

A Status mező értéke Approved (jóváhagyás), Rejected (elutasítás), NeedsRevision (javításra visszaadás) vagy Pending (visszavonás).

Minden kérés tartalmazza továbbá:

  • az esemény nevét (Event)
  • a létrehozásának időpontját (Timestamp)
  • annak a felhasználónak az azonosítóját (UserId) és e-mail-címét (UserEmail), akinek a művelete kiváltotta

A teljes kérés formátumát a A HTTP-kérés formátuma rész írja le. A jóváhagyásokról a Jóváhagyások oldalon olvashat.

Webhook konfigurálása

A webhookok listája

A Webhookok fül a szervezet összes webhookját három oszlopban mutatja: Esemény, Fogadó URL és Leírás. Ha semmi sincs megadva, a rendszer a Nincsenek webhookok üzenetet jeleníti meg.

Add webhook window with the Event and Receiver URL fields highlighted

Webhook hozzáadása

  1. A főmenüben válassza a Rendszerbeállítások lehetőséget, lépjen a Webhookok fülre, és kattintson a Hozzáadás gombra. Megnyílik a Webhook hozzáadása ablak.
  2. Válassza ki az Esemény értékét. Alapértelmezés szerint a Projekt létrehozva van beállítva.
  3. Adja meg a Fogadó URL értékét, vagyis azt a címet, amelyre a FlexiProject a kérést küldi. A mező kötelező, és a teljes címet kéri a protokollal együtt, például https://example.com/hooks/flexiproject.
  4. Ha szeretné, adjon meg Leírást, vagyis a csapatnak szóló megjegyzést, amely csak a beállításokban látható.
  5. Kattintson a Mentés gombra. A webhook megjelenik a listán, közvetlenül utána pedig megnyílik a Titkos kulcs ablak.

Titkos kulcs

A Titkos kulcs ablak ezt az üzenetet tartalmazza: A webhook létrejött. Alább található a titkos kulcs, amely csak egyszer jelenik meg. Másolja ki és őrizze biztonságos helyen.

Kattintson a Másolás gombra. Az érték a vágólapra kerül (a rendszer ezt az üzenetet jeleníti meg: Vágólapra másolva), onnan pedig elmenti a fogadó rendszerben.

A titkos kulcs minden kérést aláír, így a fogadó megerősítheti, hogy a kérés a FlexiProject rendszertől érkezik (lásd: A HTTP-kérés formátuma).

Fontos: Az ablak bezárása után a teljes érték sehol sem érhető el az alkalmazásban.

Egy később megnyitott webhookban a Titkos kulcs mező csak az első és az utolsó négy karaktert mutatja, közöttük csillagokkal. A mező nem szerkeszthető.

Webhook szerkesztése

Webhook módosításához kattintson az esemény nevére a listán. A Webhook szerkesztése ablakban módosíthatja az eseményt, a fogadó címét és a leírást, majd kattintson a Mentés gombra.

A szerkesztés nem változtatja meg a titkos kulcsot, és nem hoz létre újat.

Webhook tesztelése

Webhook ellenőrzéséhez kattintson a Tesztelés gombra a mentett webhook szerkesztőablakában. A beállított címre a kiválasztott esemény formátumában, mintaadatokkal kitöltött kérés megy (például egy Test Project nevű projekttel). A rendszer ezt az üzenettel erősíti meg: A tesztkérés sikeresen elküldve

Fontos: Az üzenet azt erősíti meg, hogy a kérést elküldték, nem azt, hogy a fogadó elfogadta. Az eredményt a fogadó oldalon ellenőrizze.

Webhook törlése

Webhook törléséhez kattintson a Törlés gombra a webhook ablakában, és erősítse meg. Ettől kezdve az esemény többé nem megy ki arra a címre.

Figyelem: A törlés nem vonható vissza. A kézbesítés újraindításához új webhookot kell létrehozni, amelynek új titkos kulcsa van.

A HTTP-kérés formátuma

A FlexiProject JSON törzsű POST kérést küld a beállított címre.

Fejlécek

Fejléc Tartalom
X-FlexiProject-Event Az esemény neve: ProjectCreated, ProjectDeleted, AcceptanceStarted vagy AcceptanceCompleted.
X-FlexiProject-Delivery A kézbesítés azonosítója. Ugyanazon esemény minden újrapróbálkozásánál ugyanaz marad, így ebből felismerhetők az ismétlődések.
X-FlexiProject-Timestamp A kérés elküldésének időpontja.
X-FlexiProject-Signature A kérés törzsének aláírása sha256=<value> formában.

Az aláírás ellenőrzése

Az aláírás a kérés nyers törzsének HMAC-SHA256 értéke, amelyet a webhook titkos kulcsával mint kulccsal számítanak ki, és kisbetűs hexadecimális formában írnak le.

A fogadó ugyanezt az értéket kiszámítja a kapott törzsből, és összehasonlítja az X-FlexiProject-Signature fejléc sha256= utáni részével. Ha az értékek eltérnek, a kérést el kell utasítani, mert nem a FlexiProject ezen szervezetétől érkezett.

Minta törzs

{
  "ProjectId": "6712f0a1c3d4e5f601234567",
  "ProjectName": "Warehouse modernization",
  "CreatedAt": "2026-09-21T08:14:02Z",
  "UserId": "a3f1c7de-1b20-4f9e-9a55-0c2d8e7b41aa",
  "UserEmail": "anna.kowalska@example.com",
  "Event": "ProjectCreated",
  "Timestamp": "2026-09-21T08:14:02Z"
}

Válasz és újrapróbálkozások

A fogadó sikeres állapotkóddal (2xx) válaszol, amint elfogadja a kérést. Minden más válasz, vagy a válasz hiánya sikertelen kézbesítésnek számít.

A sikertelen kézbesítést a rendszer növekvő időközökkel automatikusan megismétli: 1, 2, 4, 8, 16, 32, 64, 128, 256 és 512 perc után. Az összes próbálkozás nagyjából tizenhét órát vesz igénybe, így az a fogadó, amely egy ideig nem érhető el, nem veszíti el az eseményt.

Fontos: Minden próbálkozás ugyanazt az X-FlexiProject-Delivery értéket ismétli, ezért a fogadónak kezelnie kell, hogy ugyanazt az eseményt többször is megkaphatja.