Webhooks - Shifton Help

Webhooks omogućuju Shiftonu slanje obavijesti u stvarnom vremenu vašim vanjskim sustavima svaki put kad se dogode određeni događaji u vašoj tvrtki.

Što je ovo?

Kartica Webhooks na stranici za razvojne programere omogućuje vam kreiranje webhook krajnjih točaka koje primaju automatske obavijesti iz Shiftona. Kada se događaji dogode u vašem računu — poput kreiranja smjene, prijave zaposlenika ili objavljivanja rasporeda — Shifton šalje podatkovni paket na vašu navedenu URL adresu. To eliminira potrebu da vaši sustavi neprestano prozivaju Shifton za ažuriranja, čineći integracije bržima i učinkovitijima.

Preduvjeti

Zahtjev	Detalji
Uloga	Vlasnik ili
Krajnja točka	Javno dostupna URL adresa na vašem poslužitelju za primanje webhook paketa
Znanje	Osnovno razumijevanje HTTP zahtjeva i webhooks (ili pristup razvojnom programeru)

Upute korak po korak

Pristup kartici Webhooks

Na lijevoj bočnoj traci kliknite Integracije.

Idite na stranicu Razvojni programeri.

Kliknite karticu Webhookovi.

Ako još nisu kreirani webhooks, vidjet ćete prazno stanje s ilustracijom slagalice.

Kreiranje novog webhooka

Kliknite gumb “Stui webhook”.

Ispunite konfiguraciju webhooka:

Polje	Opis
URL	URL adresa krajnje točke na koju će Shifton slati podatke o događajima
Događaji	Odaberite koje događaje Shiftona treba aktivirati ovaj webhook
Aktivan	Uključite ili isključite webhook

Spremite webhook.

Shifton će sada slati HTTP POST zahtjeve na vašu URL adresu svaki put kad se odabrani događaji dogode.

Upravljanje postojećim webhooksima

Na kartici Webhooks vidjet ćete popis svih kreiranih webhooksa.

Kliknite na webhook za uređivanje njegove konfiguracije.

Možete promijeniti URL adresu, ažurirati odabir događaja ili uključiti/isključiti aktivni status.

Za uklanjanje webhooka koristite opciju brisanja.

Testiranje webhooka

Nakon kreiranja webhooka, aktivirajte relevantni događaj u Shiftonu (na primjer, kreirajte testnu smjenu).

Provjerite dnevnike vašeg poslužiteljskog servera kako biste potvrdili da je paket webhooka primljen.

Ako paket nije stigao, provjerite je li URL adresa ispravna i javno dostupna.

Prava pristupa

Uloga	Pregled Webhooksa	Kreiranje/Uređivanje Webhooksa	Brisanje Webhooksa
Vlasnik	Da	Da	Da
	Da	Da	Da
Voditelj	Ne	Ne	Ne
Zaposlenik	Ne	Ne	Ne

Česta pitanja

P: Koji format Shifton koristi za webhook pakete?
O: Webhooks se šalju kao HTTP POST zahtjevi s JSON tijelom. Pogledajte dokumentaciju API-ja za točnu strukturu paketa za svaku vrstu događaja.

P: Mogu li postaviti više webhooksa za isti događaj?
O: Da, možete kreirati više webhooksa koji prate isti događaj, a svaki pokazuje na drugu URL adresu.

P: Što se dogodi ako je moj poslužitelj nedostupan kada se webhook aktivira?
O: Ako vaša krajnja točka nije dostupna, isporuka webhooka može ne uspjeti. Pogledajte dokumentaciju API-ja za detalje o pravilima ponovnog pokušaja i rukovanju greškama.

P: Mogu li filtrirati webhooks kako bi se aktivirali samo za određene zaposlenike ili projekte?
O: Odabir webhook događaja je tipično na razini vrste događaja. Morate filtrirati dolazne podatke na strani vašeg poslužitelja kako biste rukovodili određenim zaposlenicima ili projektima.

P: Kako zaštititi svoju webhook krajnju točku?
O: Razmislite o korištenju tajnog tokena ili provjere potpisa za validaciju da dolazni zahtjevi zaista dolaze iz Shiftona. Pogledajte dokumentaciju API-ja za sigurnosne preporuke.

Mogući problemi i rješenja

Problem	Mogući uzrok	Rješenje
Webhook se ne aktivira	Webhook je postavljen na neaktivan	Uredite webhook i osigurajte da je uključen prekidač Aktivan
Krajnja točka vraća greške	URL adresa je neispravna ili poslužitelj nije dostupan	Provjerite je li URL adresa ispravna te je li vaš poslužitelj pokrenut i javno dostupan
Paket nije primljen	Vatrozid blokira dolazne zahtjeve	Provjerite postavke vatrozida vašeg poslužitelja kako biste dopustili dolazne POST zahtjeve iz Shiftona
Webhook se aktivira, ali podaci su nepotpuni	Odabrana je pogrešna vrsta događaja	Uredite webhook i provjerite jesu li odabrani ispravni događaji
Prikazuje se prazno stanje unatoč postojećim webhooksima	Stranica nije osvježena	Osvježite karticu Webhooks za učitavanje najnovijih podataka
Gumb “Novi webhook” nije vidljiv	Nedovoljne ovlasti	Osigurajte da imate ulogu Vlasnika ilia