Webhooks - Shifton Help

Webhooks umožňují Shifton odesílat oznámení v reálném čase do externích systémů při výskytu událostí ve vaší společnosti.

Postup krok za krokem

Přístup k záložce Webhooks

V levém bočním panelu klikněte na Integrace.

Přejděte na stránku Vývojář → záložka Webhooky.

Vytvoření nového webhook

Klikněte na «lisý webhook».

Vyplňte konfiguraci:

Pole	Popis
URL	Koncový bod pro příjem dat událostí
Události	Události Shifton, které aktivují webhook
Aktivní	Přepínač zapnutí/vypnutí

Uložte. Shifton bude odesílat HTTP POST požadavky na uvedenou URL.

Správa webhooks

Klikněte na webhook pro úpravu URL, aktualizaci událostí nebo změnu stavu aktivity.

Testování webhook

Vyvolejte příslušnou událost v Shifton (například vytvořte testovací směnu).

Zkontrolujte protokoly serveru — data by měla dorazit.

Související články

Často kladené otázky

Ot: V jakém Vytvořitátu směnaon odesílá data?
HTTP POST s tělem ve formátu JSON. Strukturu dat pro každý typ události najdete v dokumentaci API.

Ot: Lze vytvořit více Webhooky pro jednu událost?
Ano, s různými URL.

Ot: Co když je server nedostupný při spuštění webhook?
Doručení může selhat. Podrobnosti o pravidlech opakování najdete v dokumentaci API.

Ot: Webhook nefunguje — proč?
Ujistěte se, že přepínač Aktivní je zapnutý a URL je veřejně dostupná.

Ot: Jak ověřit, že webhook přijímá data?
Vytvořte testovací událost v Shifton (například přidejte směnu) a zkontrolujte protokoly vašeho serveru na příchozí POST požadavek.

Ot: Mohu nastavit autentifikaci webhook?
Ano. Přidejte tajný klíč nebo token do URL nebo záhlaví webhook. Podrobnosti v dokumentaci API.

Ot: Jak vypadá tělo webhook požadavku?
JSON objekt s daty události. Struktura závisí na typu události — viz dokumentace API pro příklady.

Ot: Může jeden webhook sledovat více událostí?
Ano. Při vytváření webhook vyberte více událostí — jedna URL bude přijímat oznámení o všech vybraných.

Ot: Co jsou «pravidla opakování» pro webhook?
Pokud server vrací chybu (ne 200), Shifton může požadavek opakovat. Podrobnosti závisí na konfiguraci platformy.

Ot: Existuje Omezit na počet Webhooky?
Omezení počtu není v dokumentaci uvedeno, ale doporučuje se vytvářet pouze nezbytné.

Ot: Je nutné používat HTTPS pro URL webhook?
Doporučuje se. HTTP adresy mohou fungovat, ale HTTPS zajišťuje bezpečný přenos dat.

Ot: Lze přijímat webhook oznámení při každé změně rozvrhu?
Ano. Přidejte události typu «Vytvořena směna» nebo «schedule updated» při nastavení webhook.

Ot: Kdo má přístup k vytváření Webhooky?
Pouze Owner. Manažeři a Zaměstnanci nevidí sekci Developer.

Ot: Lze vypnout webhook bez jeho smazání?
Ano. Vypněte přepínač Aktivní v nastavení webhook — přestane se spouštět, ale zachová konfiguraci.

Ot: ZazJménonávají se spuštění webhook v směnaon?
Podrobné protokoly doručení webhook nejsou v rozhraní poskytovány. Sledování je na straně vašeho serveru.

Ot: Lze filtrovat webhook podle projektu nebo rozvrhu?
Ne. Webhook se spouští na všechny události vybraného typu v celé společnosti. Filtrování je na straně přijímajícího serveru.

Ot: Co se stane s webhook při smazání společnosti?
Všechny webhooks se smažou spolu se společností.