Webhookovi objašnjeni: kako vaš sajt razgovara s automatizacijama

Kako webhook radi, po čemu se razlikuje od pollinga, šta se šalje u zahtjevu i kako ga zaštititi i testirati.

Network cables connected to a switch
Foto: Albert Stoynov na Unsplash

Webhook je način da jedan sistem odmah javi drugom da se nešto desilo. Umjesto da vaša automatizacija svako malo pita sajt “ima li šta novo”, sajt sam pošalje poruku čim se događaj desi. To je osnova većine integracija između sajtova i alata kao što je n8n.

Kako radi

  1. Automatizacija izloži jedinstvenu URL adresu (webhook adresu).
  2. U sajtu, na primjer u formi, upišete tu adresu kao odredište.
  3. Kad posjetilac pošalje formu, sajt pošalje HTTP zahtjev (obično POST) s podacima na tu adresu.
  4. Automatizacija primi podatke i odmah pokrene tok.

Webhook ili polling

Webhook Polling
Ko inicira Izvor šalje poruku Vi periodično pitate izvor
Brzina Gotovo trenutno Zavisi od intervala provjere
Opterećenje Samo kad se nešto desi Stalni zahtjevi, čak i bez promjena
Kad ga birati Kad izvor to podržava Kad izvor nema webhook

Šta se nalazi u zahtjevu

  • Metoda, najčešće POST.
  • Zaglavlja (headers) s tipom sadržaja i često potpisom ili tajnim ključem.
  • Tijelo, obično JSON s podacima događaja.

Primjer tijela za kontakt formu:

{"name": "Ana", "email": "ana@example.com", "message": "Treba mi nova web stranica"}

Sigurnost

Webhook adresa je javna, pa je treba zaštititi:

  • Koristite dugu, nasumičnu putanju koju je nemoguće pogoditi.
  • Provjeravajte tajni ključ ili potpis u zaglavlju i odbijte sve bez njega.
  • Provjerite podatke prije upotrebe: obavezna polja, format mejla, dužina teksta.
  • Ne vraćajte osjetljive podatke u odgovoru.
  • Koristite HTTPS.

Testiranje i otklanjanje grešaka

  1. Prvo koristite testnu adresu i pogledajte tačno šta stiže.
  2. Pošaljite probni zahtjev alatom kao što je curl ili Postman.
  3. Ako ništa ne stiže, provjerite da li je tok aktivan, da li je adresa tačna i da li metoda odgovara.
  4. Pregledajte istoriju izvršenja da vidite šta je stiglo i gdje je tok stao.

Pouzdanost

Pošiljalac često ponovi zahtjev ako ne dobije brz odgovor, pa se isti događaj može pojaviti dvaput. Čuvajte jedinstveni ID svake obrađene poruke i preskočite duplikate. Odgovorite brzo, a dugotrajan posao ostavite za kasnije korake.

Ukratko

Webhook je poruka “desilo se ovo” koju sajt šalje vašoj automatizaciji. Zaštitite ga tajnim ključem, provjerite podatke i pripremite se na ponovljene zahtjeve.