Słownik AI

Webhook

webhook

Powiadomienie, które system sam wysyła pod wskazany adres, gdy zajdzie zdarzenie. Dzięki niemu przepływ startuje od razu, bez ciągłego odpytywania.

Webhook to żądanie HTTP, które system wysyła sam, gdy coś się w nim wydarzy: wpłynie zamówienie, ktoś wypełni formularz, zmieni się status płatności. Odbiorca podaje wcześniej adres, pod który takie powiadomienia mają trafiać.

Webhook a odpytywanie API

Bez webhooka przepływ musiałby co kilka minut pytać API, czy jest coś nowego. To marnuje zapytania i wprowadza opóźnienie. Webhook odwraca kierunek: to źródło daje znać, że jest zmiana. W n8n czy Make węzeł "Webhook" jest najczęstszym wyzwalaczem przepływu.

Z webhooków korzystają też platformy agentowe. W OpenAI Agents API postęp długiego zadania agenta można śledzić właśnie przez webhooki.

Jak odbierać webhooki, żeby nie gubić danych

  • Odpowiadaj od razu kodem 200, a przetwarzanie odłóż do kolejki. Nadawca, który czeka zbyt długo, uznaje próbę za nieudaną.
  • Sprawdzaj podpis żądania. Adres webhooka bywa publiczny, a bez weryfikacji każdy może wysłać fałszywe zdarzenie.
  • Zakładaj, że to samo zdarzenie przyjdzie dwa razy. Obsługa musi być idempotentna, na przykład sprawdzać identyfikator zdarzenia przed zapisem.

Zobacz też: webhooki, kolejki i ponowienia w praktyce.

Rozwiń temat