Webhooks

Webhookovi su za tehnički napredne trgovce koji žele povezati WebShopHR s vlastitim sustavom — kad se nešto dogodi u tvojoj trgovini, WebShopHR odmah pošalje obavijest (HTTP POST) na URL koji zadaš. Korisno za automatizaciju: vlastito skladištenje, fakturiranje, CRM, Slack/e-mail obavijesti i slično.

Popis registriranih webhookova u WebShopHR CMS-u

Ekran nalaziš u lijevoj navigaciji, u grupi Sustav → Webhooks. Svaki webhook prikazuje URL, događaje na koje je pretplaćen (chipovi), status (Aktivan) i oznaku da je tajni ključ postavljen. Ako je WebShopHR već pokušala isporučiti obavijest, uz webhook stoji i badge zadnjeg rezultata (Isporučeno / Neuspjelo / U tijeku).

Registracija webhooka

Gumb "Novi webhook" otvara dijalog gdje unosiš:

URL — adresa tvog servera koja prima obavijesti (mora početi s http:// ili https://)
Događaji — na koje evente se pretplaćuješ (odaberi barem jedan)

Dijalog za dodavanje novog webhooka

Dostupni događaji:

Događaj	Kad se šalje
`order.created`	nova narudžba je zaprimljena
`order.paid`	narudžba je označena kao plaćena
`order.refunded`	narudžba je (djelomično ili potpuno) refundirana
`return.requested`	kupac je zatražio povrat

Tajni ključ i provjera potpisa

Prilikom kreiranja webhooka WebShopHR generira tajni ključ (secret) i prikazuje ga samo jednom — odmah ga zabilježi (u dijalogu je gumb za kopiranje), kasnije ga više nećeš moći vidjeti u CMS-u (isti princip kao kod poklon bonova). U popisu se zato vidi samo oznaka da je ključ postavljen, nikad sama vrijednost.

Svaki zahtjev koji WebShopHR pošalje na tvoj URL nosi X-Wshr-Signature header — HMAC-SHA256 potpis sadržaja poruke, izračunat tvojim tajnim ključem. Na svojoj strani izračunaj isti potpis nad primljenim podatkom i usporedi s headerom — ako se ne poklapaju, zahtjev nije stigao od WebShopHR-a (netko drugi ga je poslao ili je sadržaj usput promijenjen) i trebaš ga odbaciti.

Format poruke

Svaka poruka je JSON s dva polja: event (naziv događaja) i data (podaci narudžbe ili zahtjeva za povrat — iznosi su u centima, npr. 1250 = 12,50 €).

Log isporuka

Ispod popisa webhookova CMS prikazuje zadnjih 50 isporuka svih tvojih webhookova — status, broj pokušaja i zadnju grešku ako isporuka nije uspjela. Koristi ovo za dijagnosticiranje kad obavijesti ne stižu na tvoj server.

Brisanje

Ikona kante na retku webhooka otvara potvrdu prije brisanja. Nakon brisanja WebShopHR više neće slati obavijesti na taj URL — radnja je nepovratna, pa ako ti isti URL zatreba, registriraj webhook ponovno (dobit ćeš novi tajni ključ).