Skip to main content

Webhooky

Záložka Webhooky slúži na správu webhookov, ktoré umožňujú prepojiť Siesta AI s externými systémami a aplikáciami. Webhook poskytuje unikátnu URL adresu, na ktorú môže externá služba odosielať HTTP požiadavky a tým spúšťať alebo ovplyvňovať správanie systému.

Každý webhook:

  • má vlastný názov,
  • je viazaný na konkrétny API kľúč,
  • môže byť aktívny alebo neaktívny,
  • má jedinečnú URL adresu.

Webhooky sa často používajú ako triggery pre Workflows, ktoré je možné spúšťať z externých systémov.

Prehľad webhookov

Na hlavnej obrazovke záložky Webhooky je zobrazený zoznam všetkých vytvorených webhookov v tabuľke.

Zobrazené stĺpce:

  • Názov – názov webhooku zadaný používateľom
  • URL – automaticky generovaná URL adresa webhooku
  • Stav – aktuálny stav webhooku (Aktívny / Neaktívny)
  • Akcia – ďalšie možnosti správy webhooku (napr. úprava)

V hornej časti stránky je dostupné:

  • vyhľadávanie webhookov,
  • tlačidlo Pridať webhook.

Prehľad webhookov

Vytvorenie nového webhooku

Kliknutím na Pridať webhook sa otvorí dialóg na vytvorenie nového webhooku.

Pole formulára

  • Názov – povinné pole na zadanie názvu webhooku (napr. Webhook)
  • Aktívny – prepínač, ktorým je možné webhook pri vytvorení rovno aktivovať alebo ponechať neaktívny
  • API kľúč – výber API kľúča, pomocou ktorého bude webhook autorizovaný (napr. API key for my python script)

Akcie

  • Zrušiť – zavrie dialóg bez vytvorenia webhooku
  • Vytvoriť – vytvorí nový webhook a vygeneruje jeho URL

Vytvorenie webhooku

Detail webhooku

Po otvorení konkrétneho webhooku sa zobrazí jeho detailná stránka.

Zobrazené informácie:

  • názov webhooku,
  • stav (aktívny / neaktívny),
  • URL webhooku – unikátna adresa, ktorú je možné skopírovať jedným kliknutím.

Z detailu webhooku je možné:

  • upraviť nastavenia webhooku,
  • meniť jeho aktívny stav,
  • používať URL webhooku v externých aplikáciách alebo vo Workflows.

Detail webhooku

Stav webhooku

Stav webhooku určuje, či je webhook pripravený prijímať požiadavky:

  • Aktívny – webhook je zapnutý a dostupný
  • Neaktívny – webhook je vypnutý a požiadavky nie sú spracované

Stav je viditeľný ako v prehľade webhookov, tak aj v detaile webhooku.

Typické využitie webhookov

Webhooky sa používajú predovšetkým na:

  • integráciu Siesta AI s externými aplikáciami,
  • spúšťanie automatizovaných procesov,
  • napojenie vlastných skriptov (napr. Python),
  • prenos dát medzi systémami v reálnom čase.

Zhrnutie

Webhooky v Siesta AI poskytujú jednoduchý a bezpečný spôsob, ako prepojiť platformu s externými systémami. Vďaka prehľadnej správe, väzbe na API kľúče a možnosti aktivácie či deaktivácie je možné webhooky jednoducho kontrolovať a spravovať. Ak webhook používate ako trigger, odporúčame jeho použitie naviazať na Workflows.