Webhooky (Orchestrator)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Webhooky oznamují události externím službám, jako jsou chatovací klienty nebo externí API. Webhook může nastavit URL pro konkrétní událost.

Phrase Orchestrator poskytuje služba, která monitoruje a zpracovává oznámení ze systémů třetích stran. Tato služba umožňuje uživatelům propojit jejich pracovní postupy s širokou škálou externích systémů, které podporují požadavky HTTP.

Příchozí webhooky

Uživatelé mohou Vytvořit nový spouštěč pro příchozí webhooky z externích událostí, přičemž systém automaticky vygeneruje jedinečnou URL webhooku s API klíč pro nastavení webhooku třetí strany. Vygenerovaná URL webhooku je jedinečná a přímo spojená s uživatelský účet uživatele a pracovní postup, což znamená, že každý webhook je vázán pouze na jeden pracovní postup.

Konfigurovat příchozí webhook

Chcete-li konfigurovat příchozí webhook, postupujte podle těchto kroků:

Přetáhněte spuštění Webhook do pracovního postupu.

Spouštěč se zobrazí v pracovní postup.
Kliknutím na spoušť otevřete záložku Overview.
Vyberte záložku Webhook.
1. Zkopírujte Webhook URL.
  
  Tato URL by měla být považována za tajnou a neměla by být sdílena. Pokud je omylem sdílen, kliknutím na tlačítko Regenerate vytvořte nový a zneplatněte stávající.
2. Chcete-li odeslat datovou část (payload) s daty, která chcete použít v rámci pracovních postupů, poskytněte schéma této datové části.
  1. Pokud chcete vytvořit schéma, klikněte na Edit webhook.
  2. Vyberte Input type:
    
    Schémata JSON jsou standardem pro definování datových částí JSON. Pokud existující služba, která je používá, nebo externí služba pro připojení k Orchestratoru nějaké poskytuje, zkopírujte jej tak, jak je.
    - JSON
      
      Poskytněte ukázkovou datovou část JSON pro jednodušší nastavení, což umožní testování webhooku bez definování přesných pravidel.
    - JSON Schema
      
      Přesně definujte strukturu, datové typy a pravidla ověřování pro data JSON.
  3. Klikněte na Save payload schema.
    
    Zobrazí se náhled očekávané datové struktury pro spouštěč webhooku.
3. V případě potřeby otevřete záložku Filters a přidejte do triggeru filtry.

Chcete-li spustit pracovní postup poté, co byl publikován, odešlete požadavek POST na URL webhooku. U pracovních postupů, které nemají nakonfigurované schéma, musí být tělo prázdný. Pokud je použito nakonfigurované schéma, datová část musí odpovídat shoda se schématem.

Odchozí webhooky

Uživatelé mohou nastavit pracovní postupy, které nejen přijímají data, ale také automaticky odesílají aktualizace do externích systémů. Akce odchozího webhooku umožňuje uživatelům automaticky spouštět konkrétní akce v externích systémech.

Webhooky v jiných službách lze spouštět prostřednictvím akce Odeslat požadavek HTTP.

Konfigurovat odchozí webhook

Chcete-li konfigurovat odchozí webhook, postupujte podle těchto kroků:

Přetáhněte akci Send HTTP Request do pracovního postupu.
Kliknutím na akci otevřete konfiguraci.
Vyberte záložku Parameters a zadejte požadovaná nastavení.
Klikněte na Save parameters.