Fogalomtár › Fejlesztői alapszavak
webhook
A webhook automatikus értesítés két program között: amikor az egyiknél történik valami, az azonnal szól a másiknak egy előre megadott webcímen.
Érthetően
Képzeld el, hogy csomagot vársz. Hívogathatod óránként a futárcéget, hogy megjött-e már, vagy megadhatod a telefonszámodat, és ők szólnak, amikor a futár elindult. A webhook a második megoldás, csak programok között: nem neked kell kérdezgetned, hanem a másik fél jelez, amint van újság.
A gyakorlatban ez egy webcím, amelyet az egyik szolgáltatásnál megadsz, például a webáruházad fizetési rendszerénél. Amikor ott megtörténik egy esemény (befizetés, új megrendelés, feltöltött fájl), a rendszer erre a címre küld egy rövid, géppel olvasható üzenetet arról, hogy mi történt.
Azért hasznos, mert így a különböző szoftverek emberi közreműködés nélkül, szinte azonnal reagálnak egymásra. Az AI-agentek világában azért fontos, mert egy webhook el is indíthat egy agentet: beérkezik egy panaszlevél, mire az agent magától munkához lát.
Hogyan működik
- A fogadó oldalon létrehoznak egy webcímet (URL-t), amely mögött egy program várja a beérkező üzeneteket.
- Ezt a címet beállítod a küldő szolgáltatásnál, és kiválasztod, mely eseményekről kérsz értesítést, például „sikeres fizetés” vagy „új hozzászólás”.
- Amikor az esemény bekövetkezik, a küldő rendszer egy webes (HTTP-) kérést indít a megadott címre, benne az esemény adataival, többnyire JSON formátumban.
- A fogadó program ellenőrzi, hogy az üzenet valóban a várt feladótól jött-e (általában egy közös titkos kulccsal készült aláírás alapján), majd gyorsan visszaigazolja az átvételt.
- Ezután elvégzi a saját feladatát: számlát állít ki, üzenetet küld, vagy elindít egy agentet. Ha a visszaigazolás elmarad, a küldő rendszerint többször újrapróbálkozik.
Példa a mindennapokból
Online rendelsz egy könyvet, és bankkártyával fizetsz. Amint a fizetés sikerült, a fizetési szolgáltató webhookon szól a webáruháznak, amely ettől a jelzéstől küldi ki a visszaigazoló e-mailt, és indítja el a csomagolást. Ezért kapod meg a levelet másodperceken belül.
Kit érint
Gyakori félreértés
Korlátok és kockázatok
- A webhook címe az internetről elérhető webcím, ezért aláírás-ellenőrzés nélkül bárki küldhet rá hamis üzenetet, aki megismeri vagy kitalálja.
- Az üzenet elveszhet, késhet, rossz sorrendben vagy kétszer is megérkezhet, ezért a fogadó programot úgy kell megírni, hogy ugyanazt az eseményt ne dolgozza fel duplán.
- Egyirányú jelzés, és sokszor csak az esemény legfontosabb adatait tartalmazza; a részletekért gyakran külön le kell kérdezni az adatokat API-n keresztül.
- Ha egy webhook agentet indít el, a beérkező üzenet szövege megtévesztő utasítást is tartalmazhat (prompt injection), ezért az agent ne kezelje azt megbízható parancsként.
Hasonló, de nem ugyanaz
- API – Az API-t te szólítod meg, amikor adatra van szükséged, a webhook viszont magától értesít, amikor esemény történik.
- lekérdezgetés (polling) – A lekérdezgetésnél a programod rendszeres időközönként rákérdez, van-e újdonság, a webhooknál nincs felesleges kérdezgetés, csak a tényleges eseménykor érkezik üzenet.
- push értesítés – A push értesítés embernek szól a telefonján vagy böngészőjében, a webhook viszont programnak küldött, gépi feldolgozásra szánt üzenet.
Kapcsolódó fogalmak
API, integráció, automatizálás, eseményvezérelt architektúra
bejövő webhook, kimenő webhook, webhook-aláírás
végpont, JSON, HTTP-kérés, munkafolyamat-automatizálás, AI-agent
Röviden a története
A kifejezést Jeff Lindsay amerikai fejlesztő alkotta meg 2007-ben, a programozásban régóta használt „hook” (kampó, beakasztási pont) szó webes változataként. Széles körben a kódtároló és fizetési szolgáltatások révén terjedt el a 2010-es években.
Hol tart most
2026 végén a webhook a webes szolgáltatások összekötésének alapeszköze, szinte minden fizetési, kódtároló, csevegő- és automatizáló platform kínálja. Az agentes rendszerekben új szerepet kapott: gyakran webhook indítja el az agentet, vagy az jelzi vissza egy hosszan futó feladat elkészültét.
Más nevei
webhook · web hook · webhookok · webes visszahívás · HTTP callback · web callback · fordított API · reverse API
Források
A szócikk gépi szerkesztéssel készült és gépi szakmai lektoráláson ment át; a „hírekben” rész az Agent Age sztorijaiból automatikusan frissül.