Webhooks - Shifton Help

Webhooks umožňujú Shifton odosielať notifikácie v reálnom čase do externých systémov pri výskyte udalostí vo vašej spoločnosti.

Postup krok za krokom

Prístup k záložke Webhooks

Na ľavom bočnom paneli kliknite na Integrácie.

Prejdite na stránku Vývojár → záložka Webhooky.

Vytvorenie nového webhook

Kliknite na „Nový webhook”.

Vyplňte konfiguráciu:

Pole	Popis
URL	Koncový bod na prijímanie údajov udalostí
Události	Udalosti Shifton, ktoré aktivujú webhook
Aktívny	Prepínač zapnutia/vypnutia

Uložte. Shifton bude odosielať HTTP POST požiadavky na uvedenú URL.

Správa webhooks

Kliknite na webhook na úpravu URL, aktualizáciu udalostí alebo zmenu stavu aktivity.

Testovanie webhook

Vyvolajte príslušnú udalosť v Shifton (napríklad vytvorte testovaciu zmenu).

Skontrolujte protokoly servera — údaje by mali prísť.

Súvisiace články

Často kladené otázky

Ot.: V akom Vytvoriťáte smenaon odosiela údaje?
HTTP POST s telom vo formáte JSON. Štruktúru údajov pre každý typ udalosti nájdete v dokumentácii API.

Ot.: Dá sa vytvoriť viacero Webhooky pre jednu udalosť?
Áno, s rôznymi URL.

Ot.: Čo ak je server nedostupný pri spustení webhook?
Doručenie môže zlyhať. Podrobnosti o politike opakovaných pokusov — v dokumentácii API.

Ot.: Webhook sa nespustí — prečo?
Uistite sa, že prepínač Aktívny je zapnutý a URL je verejne dostupná.

Ot.: Ako overiť, že webhook prijíma údaje?
Vytvorte testovaciu udalosť v Shifton (napríklad pridajte zmenu) a skontrolujte protokoly vášho servera na prichádzajúcu POST požiadavku.

Ot.: Môžem nastaviť autentifikáciu webhook?
Áno. Pridajte tajný kľúč alebo token do URL alebo hlavičiek webhook. Podrobnosti v dokumentácii API.

Ot.: Ako vyzerá telo webhook požiadavky?
JSON objekt s údajmi udalosti. Štruktúra závisí od typu udalosti — pozrite si dokumentáciu API pre príklady.

Ot.: Môže jeden webhook sledovať viacero udalostí?
Áno. Pri vytváraní webhook vyberte viacero udalostí — jedna URL bude prijímať notifikácie za všetky vybrané.

Ot.: Čo je „politika opakovaných pokusov” pre webhook?
Ak server vráti chybu (nie 200), Shifton môže zopakovať požiadavku. Podrobnosti závisia od konfigurácie platformy.

Ot.: Je limit na počet Webhooky?
Obmedzenia počtu nie sú uvedené v dokumentácii, ale odporúča sa vytvárať len nevyhnutné.

Ot.: Treba pre URL webhook používať HTTPS?
Odporúča sa. HTTP adresy môžu fungovať, ale HTTPS zabezpečuje bezpečný prenos údajov.

Ot.: Dá sa prijímať webhook notifikácie pri každej zmene rozvrhu?
Áno. Pridajte udalosti typu „Posun vytvorený” alebo „schedule updated” pri konfigurácii webhook.

Ot.: Kto má prístup k vytváraniu Webhooky?
Len Owner. Manažéri a zamestnanci nevidia sekciu Developer.

Ot.: Dá sa vypnúť webhook bez vymazania?
Áno. Vypnite prepínač Aktívny v nastaveniach webhook — prestane sa spúšťať, ale zachová konfiguráciu.

Ot.: Protokolujú sa spustenia webhook v smenaon?
Podrobné protokoly doručenia webhook sa v rozhraní neposkytujú. Sledovanie — na strane vášho servera.

Ot.: Dá sa filtrovať webhook podľa projektu alebo rozvrhu?
Nie. Webhook sa spustí na všetky udalosti vybraného typu v celej spoločnosti. Filtrovanie — na strane prijímajúceho servera.

Ot.: Čo sa stane s webhook pri vymazaní spoločnosti?
Všetky webhooks sa vymažú spolu so spoločnosťou.