
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
- Automatizacija izloži jedinstvenu URL adresu (webhook adresu).
- U sajtu, na primjer u formi, upišete tu adresu kao odredište.
- Kad posjetilac pošalje formu, sajt pošalje HTTP zahtjev (obično POST) s podacima na tu adresu.
- 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
- Prvo koristite testnu adresu i pogledajte tačno šta stiže.
- Pošaljite probni zahtjev alatom kao što je curl ili Postman.
- Ako ništa ne stiže, provjerite da li je tok aktivan, da li je adresa tačna i da li metoda odgovara.
- 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.