Webhooky (Orchestrátor)

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í klienti nebo externí API. Webhook může nastavit URL pro konkrétní událost.

Phrase Orchestrátor poskytuje službu, která monitoruje a zpracovává oznámení z 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í HTTP požadavky.

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 generuje unikátní URL webhooku s API klíčem pro nastavení webhooku třetí strany. Vygenerovaná URL webhooku je unikátní a přímo spojena s uživatelským účtem a pracovním postupem, což znamená, že každý webhook je vázán pouze na jeden pracovní postup.

Nastavit příchozí webhook

Pro nastavení příchozího webhooku postupujte podle těchto kroků:

Přetáhněte spoušť Webhook do pracovního postupu.

Spoušť se objeví v pracovním postupu.
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. Pro odeslání payloadu s daty k použití uvnitř pracovních postupů poskytněte schéma tohoto payloadu.
  1. Pokud chcete vytvořit schéma, klikněte na Edit webhook.
  2. Vyberte Input Type:
    
    JSON Schémata jsou standardem pro definování JSON payloadů. Pokud existující služba, která je používá, nebo externí služba, která se připojuje k Orchestrátoru, poskytuje jedno, zkopírujte ho tak, jak je.
    - JSON
      
      Poskytněte vzorový JSON payload pro jednodušší nastavení, které umožní testování webhooku bez definování přesných pravidel.
    - JSON Schema
      
      Přesně definujte strukturu, datové typy a validační pravidla pro JSON data.
  3. Klikněte na Uložit schéma payloadu.
    
    Náhled očekávané struktury dat pro spouštěč webhooku je zobrazen.
3. V případě potřeby otevřete záložku Filtry a přidejte do spouštěče filtry.

Pro spuštění pracovního postupu, jakmile byl publikován, odešlete POST požadavek na URL webhooku. Pro pracovní postupy, které nemají nakonfigurované schéma, musí být tělo prázdné. Pokud je aplikováno nakonfigurované schéma, payload musí odpovídat schématu.

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 specifické akce v externích systémech.

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

Nakonfigurujte odchozí webhook

Pro nakonfigurování odchozího webhooku postupujte podle těchto kroků:

Přetáhněte akci Odeslat HTTP požadavek do pracovního postupu.
Klikněte na akci pro otevření konfigurace.
Vyberte záložku Parameters a zadejte požadovaná nastavení.
Klikněte na Save parameters.