Přeskočit na hlavní obsah

Webhooky

Záložka Webhooky slouží ke správě webhooků, které umožňují propojit Siesta AI s externími systémy a aplikacemi. Webhook poskytuje unikátní URL adresu, na kterou může externí služba odesílat HTTP požadavky a tím spouštět nebo ovlivňovat chování systému.

Každý webhook:

  • má vlastní název,
  • je svázaný s konkrétním API klíčem,
  • může být aktivní nebo neaktivní,
  • má jedinečnou URL adresu.

Webhooky se často používají jako triggery pro Workflows, které lze spouštět z externích systémů.

Přehled webhooků​

Na hlavní obrazovce záložky Webhooky je zobrazen seznam všech vytvořených webhooků v tabulce.

Zobrazené sloupce:

  • Název – název webhooku zadaný uživatelem
  • URL – automaticky generovaná URL adresa webhooku
  • Stav – aktuální stav webhooku (Aktivní / Neaktivní)
  • Akce – další možnosti správy webhooku (např. úprava)

V horní části stránky je dostupné:

  • vyhledávání webhooků,
  • tlačítko Přidat webhook.

Přehled webhooků

Vytvoření nového webhooku​

Kliknutím na Přidat webhook se otevře dialog pro vytvoření nového webhooku.

Pole formuláře

  • Název – povinné pole pro zadání názvu webhooku (např. Webhook)
  • Aktivní – přepínač, kterým lze webhook při vytvoření rovnou aktivovat nebo ponechat neaktivní
  • API klíč – výběr API klíče, pomocí kterého bude webhook autorizován (např. API key for my python script)

Akce

  • Zrušit – zavře dialog bez vytvoření webhooku
  • Vytvořit – vytvoří nový webhook a vygeneruje jeho URL

Vytvoření webhooku

Detail webhooku​

Po otevření konkrétního webhooku se zobrazí jeho detailní stránka.

Zobrazené informace:

  • název webhooku,
  • stav (aktivní / neaktivní),
  • URL webhooku – unikátní adresa, kterou lze zkopírovat jedním kliknutím.

Z detailu webhooku je možné:

  • upravit nastavení webhooku,
  • měnit jeho aktivní stav,
  • používat URL webhooku v externích aplikacích nebo ve Workflows.

Detail webhooku

Stav webhooku​

Stav webhooku určuje, zda je webhook připraven přijímat požadavky:

  • Aktivní – webhook je zapnutý a dostupný
  • Neaktivní – webhook je vypnutý a požadavky nejsou zpracovány

Stav je viditelný jak v přehledu webhooků, tak v detailu webhooku.

Typické využití webhooků​

Webhooky se používají zejména pro:

  • integraci Siesta AI s externími aplikacemi,
  • spouštění automatizovaných procesů,
  • napojení vlastních skriptů (např. Python),
  • přenos dat mezi systémy v reálném čase.

Shrnutí​

Webhooky v Siesta AI poskytují jednoduchý a bezpečný způsob, jak propojit platformu s externími systémy. Díky přehledné správě, vazbě na API klíče a možnosti aktivace či deaktivace lze webhooky snadno kontrolovat a spravovat. Pokud webhook používáte jako trigger, doporučujeme jeho použití navázat na Workflows.