Jako administrátor organizace můžete webhooky vytvářet, upravovat a monitorovat i jednoduše přímo z prostředí aplikace DigiSign.
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.
Funkcionalita webhooku spadá pod placený modul API. Pokud jej nemáte dostupný ve vašem tarifu, můžete nás kontaktovat pro samostatné objednání na podpora@digisign.cz.
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.
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.
💡 TIP: Pokud vás zajímá výsledek pro konkrétní entitu (např. obálku), tak zadejte její ID do vyhledávacího pole nad výpis pokusů. Tím se vám zobrazí pouze pokusy spojené s danou obálkou.
Správa existujících webhooků
U každého záznamu ve výpisu webhooků 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. Smazaný webhook již nelze obnovit.
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.