Webhooks (Orchestrator)

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

Webhooky oznamují externím službám, například chatovacím klientům nebo jiným externím API, že došlo k události. Webhook může nastavit URL, když nastane konkrétní událost.

Phrase Orchestrator poskytuje službu, která monitoruje a zpracovává oznámení z 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í 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 vygeneruje jedinečnou URL webhooku s API klíčem pro nastavení webhooku třetí strany. Vygenerované URL webhooku je unikátní a přímo spojeno s uživatelským účtem a pracovním postupem, což znamená, že každý webhook je spojen pouze s jedním pracovním postupem.

Nakonfiguruj příchozí webhook

Pro nakonfigurování příchozího webhooku postupuj podle těchto kroků:

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

Spouštěč 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.
  
  Toto URL považuj za tajné a nesdílej ho. 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ů zadej schéma payloadu.
  1. Pokud chcete vytvořit schéma, klikněte na Edit webhook.
  2. Vyberte Input type:
    
    JSON Schemas jsou standardem pro definování JSON payloadů. Jestliže existující služba, která je používá, nebo externí služba pro připojení k Orchestratoru poskytne jedno, zkopíruj ho tak, jak je.
    - JSON
      
      Pro jednodušší nastavení zadej ukázkový JSON payload, který ti umožní otestovat webhook bez definování přesných pravidel.
    - JSON Schema
      
      Přesně definuj strukturu, datové typy a validační pravidla pro JSON data.
  3. Klikněte na Save payload schema.
    
    Náhled očekávané struktury dat pro spouštěč webhooku se zobrazí.
3. V případě potřeby otevřete záložku Filters a přidejte do triggeru filtry.

Pro spuštění pracovního postupu po jeho publikování pošli POST požadavek na URL webhooku. Pro pracovní postupy bez nakonfigurovaného schématu nech tělo prázdné. Pokud je použito 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 konkrétní 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.

Nakonfiguruj odchozí webhook

Chceš-li nakonfigurovat odchozí webhook, postupuj podle těchto kroků:

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