ウェブフック（オーケストレーター）

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

ウェブフックは、チャットクライアントや他の外部APIなどの外部サービスにイベントを通知します。ウェブフックは、特定のイベントが発生したときにURLを設定できます。

Phrase Orchestratorは、サードパーティシステムからの通知を監視および処理するサービスを提供します。このサービスにより、ユーザーはHTTPリクエストをサポートするさまざまな外部システムとワークフローを接続できます。

受信ウェブフック

ユーザーは、外部イベントからの受信ウェブフックの新しいトリガーを作成でき、システムはサードパーティのウェブフック設定のためにAPIキーを持つユニークなウェブフックURLを自動的に生成します。生成されたウェブフックURLはユニークで、ユーザーのアカウントとワークフローに直接関連付けられており、各ウェブフックは1つのワークフローにのみ結び付けられています。

受信ウェブフックの設定

受信ウェブフックを設定するには、次の手順に従います：

Webhookトリガーをワークフローにドラッグアンドドロップします。

トリガーがワークフローに表示されます。
トリガーをクリックしてOverviewタブを開きます。
Webhookタブを選択します。
1. Webhook URLをコピーします。
  
  このURLは秘密と見なされ、共有しないでください。誤って共有した場合は、Regenerateをクリックして新規作成し、既存の共有を無効にします。
2. ワークフロー内で使用するデータを含むペイロードを送信するには、そのペイロードのスキーマを提供します。
  1. スキーマを提供するには、Edit webhookをクリックします。
  2. Input Typeの選択：
    
    JSON Schemasは、JSONペイロードを定義するための標準です。既存のサービスがそれを使用している場合、またはOrchestratorに接続する外部サービスが提供している場合は、そのままコピーします。
    - JSON
      
      より簡単なセットアップのためにサンプルJSONペイロードを提供し、正確なルールを定義せずにウェブフックのテストを可能にします。
    - JSON Schema
      
      JSONデータの構造、データ型、および検証ルールを正確に定義します。
  3. Save payload schemaをクリックします。
    
    ウェブフックトリガーの期待されるデータ構造のプレビューが表示されます。
3. 必要に応じて、Filtersタブを開いてトリガーにフィルタを追加します。

ワークフローが公開された後にトリガーするには、ウェブフックURLにPOSTリクエストを送信します。構成されたスキーマがないワークフローの場合、ボディは空でなければなりません。構成されたスキーマが適用されている場合、ペイロードはスキーマと一致しなければなりません。

送信ウェブフック

ユーザーは、データを受信するだけでなく、外部システムに自動的に更新を送信するワークフローを設定できます。送信ウェブフックアクションにより、ユーザーは外部システムで特定のアクションを自動的にトリガーできます。

他のサービスのウェブフックは、HTTPリクエストを送信するアクションを通じてトリガーできます。

送信ウェブフックを構成する

送信ウェブフックを構成するには、次の手順に従います：

Send HTTP Requestアクションをワークフローにドラッグアンドドロップします。
アクションをクリックして構成を開きます。
Parametersタブを選択し、必要な設定を行います。
Save parametersをクリックします。