Jako administrátor organizace můžete webhooky vytvářet, upravovat a monitorovat i jednoduše přímo z prostředí aplikace DigiSign.
1. Kde najdu nastavení webhooků?
V aplikaci přejděte do sekce Nastavení> Pro vývojáře> Webhooky. Zde uvidíte přehled všech vytvořených webhooků, jejich cílové URL adresy a aktuální stav.
2. Vytvoření nového webhooku
Pro přidání nového propojení klikněte v pravém horním rohu na tlačítko Nový webhook. Otevře se dialogové okno s následujícími poli:
Event (Událost): Z rozbalovací nabídky vyberte konkrétní událost, na kterou má DigiSign upozorňovat (např. Obálka odeslána, Obálka dokončena, Příjemce podepsal atd.).
URL: Zadejte cílovou adresu vašeho serveru nebo endpointu, kam má být zasláno oznámení.
Zabezpečit pomocí OAuth 2.0: Pokud váš systém vyžaduje autorizaci, zaškrtněte toto pole. Následně se vám zobrazí formulář pro zadání Token Endpointu, Client ID, Client Secret a případně Scopes.
3. Detail a monitoring webhooku
Kliknutím na konkrétní webhook v seznamu se dostanete do jeho detailu, kde můžete sledovat historii všech proběhlých pokusů o doručení.
Historie pokusů: V levé části uvidíte seznam volání s HTTP kódy s možností filtrovat dle úspěšných či neúspěšných pokusů.
Detail pokusu: Po kliknutí na konkrétní pokus se v pravé části zobrazí přesná data, která DigiSign odeslal (Request), a odpověď, kterou vrátil váš server (Response) včetně případných chybových hlášení.
Ruční opakování: Pokud volání selhalo, můžete v detailu pokusu využít tlačítko Opakovat, kterým vynutíte nový pokus o provolání dané události.
4. Správa existujících webhooků
U každého záznamu v přehledu najdete vpravo ikonu tří teček (menu), která umožňuje:
Deaktivovat/Obnovit: Ručně ovlivnit, zda je webhook v provozu.
Smazat: Úplně odstranit webhook ze seznamu.
V detailu webhooku je pak navíc možné:
Upravit: Změnit nastavení nebo cílovou URL.
Zobrazit Secret: Pro technické ověření integrity dat na straně vašeho serveru.
💡Tip: Pokud se vám v historii zobrazují chyby (např. 404), zkontrolujte v logu Response zprávu od vašeho serveru. Často jde o chybně nastavený endpoint nebo neplatný autorizační token.