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žbu monitorování a zpracování oznámení ze systémů třetích stran. Tato služba umožňuje uživatelům propojit své pracovní postupy s širokou škálou externích systémů, které podporují požadavky HTTP.

Příchozí webhooky

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

Konfigurace příchozího webhooku

Příchozí webhook nakonfigurujete takto:

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

Spouštěč se zobrazí v pracovním postupu.
Kliknutím na spoušť otevřete záložku Overview.
Vyberte záložku Webhook.
1. Zkopírujte Webhook URL.
  
  Adresa 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 datové zatížení s daty, která použijete v rámci pracovních postupů, zadejte schéma tohoto datového zatížení.
  1. Pokud chcete vytvořit schéma, klikněte na Edit webhook.
  2. Vyberte Input type:
    
    Schémata JSON jsou standardem pro definici datového obsahu JSON. Pokud je poskytuje existující služba, která je používá, nebo externí služba pro připojení k Orchestratoru, zkopírujte ji tak, jak je.
    - JSON
      
      Zadejte vzorový datový obsah JSON pro jednodušší nastavení, což umožní testování webhooku bez definování přesných pravidel.
    - JSON Schema
      
      Přesně definovat strukturu, typy dat a ověřovací pravidla pro data JSON.
  3. Klikněte na Save payload schema.
    
    Zobrazí se náhled očekávané datové struktury pro spuštění webhooku.
3. V případě potřeby otevřete záložku Filters a přidejte do triggeru filtry.

Chcete-li spustit pracovní postup po jeho zveřejnění, odešlete požadavek POST na URL webhooku. U pracovních postupů, které nemají nakonfigurované schéma, musí být tělo empty. Je-li použito nakonfigurované schéma, musí mít datový obsah shodu se schématem.

Odchozí webhooky

Uživatelé mohou nastavit pracovní postupy, které nejen přijímají data, ale také automaticky zasílají aktualizace do externích systémů. Odchozí akce webhooku umožňuje uživatelům automaticky spouštět určité 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.

Konfigurace odchozího webhooku

Odchozí webhook nakonfigurujete takto:

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.