🔍 Co to je

Webhooky umožňují, aby Speybl sám poslal zprávu do vašeho systému (např. mzdového nebo ERP), když se v docházce něco stane — v reálném čase, bez nutnosti se Speyblu pravidelně dotazovat. Integrace je dostupná všem firmám.

🧭 Kde je najdete

Nastavení → Integrace → kategorie „Ostatní“ → karta „Webhooky“.

Nastavení zobrazí uživatel s oprávněním „Nastavení firmy“ (zobrazit); měnit ho může jen uživatel s oprávněním „Nastavení firmy“ (upravit).

Okno má tři záložky: „Nastavení“, „Události“ a „Historie“. Hlavní přepínač „Odesílat webhooky“ zapíná a vypíná celé odesílání. V hlavičce vidíte stav („Aktivní“ / „Vypnuto“), čas posledního odeslání, úspěšnost doručení za poslední období a počet neúspěšných odeslání.

⚙️ Nastavení

Koncový bod

  • Do pole „Cílová URL“ zadáte adresu, na kterou má Speybl zprávy posílat. Adresa musí používat zabezpečené spojení (https) a musí být veřejně dostupná.

  • Tlačítkem „Otestovat“ pošlete testovací událost. Docházka se tím nijak nezmění a v historii se odeslání označí jako testovací.

Podpis a zabezpečení

  • Každá zpráva je podepsaná „Podpisovým klíčem“, podle kterého váš systém pozná, že zprávu opravdu poslal Speybl.

  • Klíč vygeneruje Speybl sám. Celý se zobrazí jen jednou — „Zkopírujte teď – podruhé se nezobrazí“.

  • Tlačítkem „Vygenerovat nový“ klíč vyměníte; starý ještě chvíli platí, aby výměna proběhla bez výpadku. Pokud chcete starý klíč zrušit okamžitě, použijte „Zneplatnit starý klíč hned“.

  • Návod „Jak na své straně ověřit podpis“ ukazuje, jak podpis ověřit ve vašem systému.

Když váš systém neodpoví

Pokud se zprávu nepodaří doručit, Speybl odeslání několikrát automaticky zopakuje. Když neuspěje ani poslední pokus, zpráva dostane stav „Chyba“ a můžete ji ručně odeslat znovu z historie.

Změny nastavení i výběru událostí platí pro události, které vzniknou po uložení.

📋 Události

Na záložce „Události“ vyberete, které události z modulu Docházka se mají posílat. Pomoci si můžete tlačítky „Vybrat vše“ a „Zrušit výběr“. U vybraného řádku se zobrazí ukázka obsahu zprávy.

Záznam docházky

  • „Záznam vytvořen“ — vznikl nový záznam docházky

  • „Záznam změněn“ — u existujícího záznamu se změnil čas, typ, projekt nebo poznámka

  • „Záznam smazán“ — záznam byl smazán

  • „Záznam schválen“ — schvalovatel záznam potvrdil

  • „Záznam zamítnut“ — schvalovatel záznam zamítl

Měsíční uzávěrka

  • „Žádost o potvrzení měsíční docházky“ — zaměstnanec je vyzván, aby potvrdil svou docházku za měsíc

  • „Měsíc uzavřen“ — docházku za měsíc už nejde upravovat; typicky signál pro mzdy

  • „Měsíc znovu otevřen“ — uzávěrka byla zrušena a docházka se vrátila k úpravám

Události „Měsíc uzavřen“ a „Měsíc znovu otevřen“ jsou ve výchozím stavu vypnuté. Události schvalovacího procesu docházkového listu, náboru ani dokumentů se zatím neposílají.

🕘 Historie

Záložka „Historie“ ukazuje všechna odeslání ve sloupcích „Stav“, „Událost“, „Zdroj“, „Čas“ a „Odpověď“. Sloupec „Zdroj“ říká, odkud změna pochází (např. uživatel, API nebo import).

Stavy odeslání:

  • „Čeká“ — zpráva čeká na odeslání

  • „Doručeno“ — váš systém zprávu přijal

  • „Opakuje se“ — doručení se nepovedlo a Speybl ho automaticky zkouší znovu

  • „Chyba“ — nepovedl se ani poslední pokus; zprávu lze odeslat ručně

  • odznak „Test“ označuje testovací odeslání

Historii lze filtrovat. V detailu odeslání uvidíte „Co jsme poslali“ a „Co odpověděl váš systém“ a tlačítkem „Odeslat znovu“ zprávu pošlete znovu. Historii lze stáhnout tlačítkem „Stáhnout CSV“.

⏸️ Vypnutí

Po vypnutí přepínače „Odesílat webhooky“ zůstane celé nastavení uložené (adresa, klíč i výběr událostí). Události, které vzniknou během vypnutí, se neodešlou ani po opětovném zapnutí.

💡 Tipy

  • Než webhooky zapnete naostro, ověřte spojení tlačítkem „Otestovat“.

  • Pokud potřebujete data ze Speyblu číst nebo do něj zapisovat, použijte API; webhooky slouží k tomu, aby se váš systém o změně v docházce dozvěděl sám.