> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# プラグイントリガー

## はじめに

<Info>
  トリガーは Workflow アプリケーションでのみ利用可能です。
</Info>

プラグイントリガーは、外部システムで特定のイベントが発生したときに自動的にワークフローを開始します。必要なのは、トリガープラグインを通じてこれらのイベントをサブスクライブし、対応するプラグイントリガーをワークフローに追加することだけです。

例えば、GitHub トリガープラグインをインストールしたとします。これは、`Pull Request`、`Push`、`Issue` を含む、サブスクライブできる GitHub イベントのリストを提供します。`Pull Request` イベントをサブスクライブし、`Pull Request` プラグイントリガーをワークフローに追加すると、指定されたリポジトリで誰かがプルリクエストを開くたびに自動的に実行されます。

## プラグイントリガーの追加と設定

1. ワークフローキャンバスで右クリックし、**ブロックを追加** > **始める** を選択してから、利用可能なプラグイントリガーの中から選択するか、[Dify Marketplace](https://marketplace.dify.ai/?language=ja-JP\&category=trigger) でさらに検索します。

   <Tip>
     * 対象の外部システムに適切なトリガープラグインがない場合は、[コミュニティにリクエスト](https://github.com/langgenius/dify-plugins/issues/new?template=plugin_request.yaml)したり、[自分で開発](https://docs.dify.ai/ja/develop-plugin/dev-guides-and-walkthroughs/trigger-plugin)したり、代わりに [Webhook トリガー](/ja/3.10.x/use/nodes/trigger/webhook-trigger)を使用したりできます。

     * 1 つのワークフローに複数のプラグイントリガーを含めることができます。これらのトリガーブランチが同じ下流ノードを共有する場合、[変数集約器](/ja/3.10.x/use/nodes/variable-aggregator) を追加してそれらを集約し、各ブランチでノードを重複させないようにします。
   </Tip>

2. 既存のサブスクリプションを選択するか、[新しいサブスクリプションを作成](#新しいサブスクリプションを作成)します。

   <Tip>
     **プラグイン** 配下のプラグイン詳細パネルから、特定のサブスクリプションを使用しているワークフローの数を確認できます。
   </Tip>

3. その他の必要な設定を行います。

<Info>
  プラグイントリガーの出力変数は、そのトリガープラグインによって定義されており、変更できません。
</Info>

## 新しいサブスクリプションを作成

<Info>
  トリガープラグインは、ワークスペースごとに最大 10 個のサブスクリプションをサポートします。
</Info>

各サブスクリプションは Webhook 上に構築されています。サブスクリプションを作成する際、実際には外部システムからのイベントをリッスンする Webhook を設定しています。

<Accordion title="Webhook とは？">
  Webhook を使用すると、あるシステムが別のシステムにリアルタイムでデータを自動的に送信できます。特定のイベントが発生すると、ソースシステムはイベントの詳細を HTTP リクエストにパッケージ化し、宛先システムが提供する指定された URL に送信します。
</Accordion>

<Note>
  **前提条件：コールバック URL のベースプレフィックスを設定する**

  Dify は、`TRIGGER_URL` 環境変数とプラグイン固有のパスを組み合わせて、各サブスクリプションのコールバック URL を生成します。デフォルトは `http://localhost` で、外部システムからは到達できません。

  サブスクリプションを作成する前に、デプロイ環境の `TRIGGER_URL` を外部システムから到達可能な公開ドメインまたは IP アドレスに設定し、Dify を再起動してください。
</Note>

Dify は以下の 2 つの方法でサブスクリプション（Webhook）を作成することをサポートしていますが、各プラグインで利用可能なオプションは、そのプラグインの設計方法によって異なります。

* **自動作成**：サブスクライブしたいイベントを選択すると、Dify が外部システムで対応する Webhook を自動的に作成します。これには、Dify が Webhook のセットアップを代行できるように、 **OAuth** または **API キー** による事前の認証が必要です。

* **手動作成**：Dify が提供する Webhook コールバック URL を使用して、自分で Webhook を作成します。認証は不要です。

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workflow/create-subscription-method.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=e86472430507ea6291c09a4d6463c212" alt="サブスクリプションの作成方法" width="770" height="626" data-path="images/use-dify/workflow/create-subscription-method.png" />
</Frame>

<Tip>
  サブスクリプションを作成する際は、利用可能なすべてのイベントを選択することをお勧めします。

  プラグイントリガーは、対応するイベントがリンクされたサブスクリプションに含まれている場合にのみ機能します。利用可能なすべてのイベントを選択すると、後でワークフローに追加するプラグイントリガーが同じサブスクリプションを使用でき、サブスクリプションを更新したり新しく作成したりする必要がなくなります。
</Tip>

<Tabs>
  <Tab title="OAuth 経由（自動）">
    1. **OAuth 経由** > **カスタム**を選択します。

    2. 外部システムで、Dify が提供するコールバック URL を使用して新しい OAuth アプリケーションを作成します。

    3. Dify に戻り、新しく作成した OAuth アプリケーションのクライアント ID とクライアントシークレットを入力してから、**保存と承認** をクリックします。

           <Info>
             保存後、同じクライアント認証情報を今後のサブスクリプションで再利用できます。
           </Info>

    4. サブスクリプション名を指定し、サブスクライブするイベントを選択し、その他の必要な設定を行います。

           <Tip>
             利用可能なすべてのイベントを選択することをお勧めしますが、後から **プラグイン** 配下のプラグイン詳細パネルでいつでも選択を変更できます。
           </Tip>

    5. **作成** をクリックします。

    <Info>
      表示されている **コールバック URL** は、Dify が外部システムで Webhook を作成する際に内部的に使用されます。このため、ユーザー側でこの URL に対して操作を行う必要はありません。
    </Info>
  </Tab>

  <Tab title="API キーで作成（自動）">
    1. **API キーで作成** を選択します。

    2. 必要な認証情報を入力してから、**検証** をクリックします。

    3. サブスクリプション名を指定し、サブスクライブするイベントを選択し、その他の必要な設定を行います。

           <Tip>
             利用可能なすべてのイベントを選択することをお勧めしますが、後から **プラグイン** 配下のプラグイン詳細パネルでいつでも選択を変更できます。
           </Tip>

    4. **作成** をクリックします。

    <Info>
      表示されている **コールバック URL** は、Dify が外部システムで Webhook を作成する際に内部的に使用されます。このため、ユーザー側でこの URL に対して操作を行う必要はありません。
    </Info>
  </Tab>

  <Tab title="URL を貼り付けて新しいサブスクリプションを作成（手動）">
    1. **URL を貼り付けて新しいサブスクリプションを作成** を選択します。

    2. サブスクリプション名を指定し、提供されたコールバック URL を使用して外部システムで手動で Webhook を作成します。

    3. （オプション）作成した Webhook をテストします。

           <Info>
             ほとんどの外部システムは、作成時に Dify に ping リクエストを送信することで、新しい Webhook を自動的にテストします。
           </Info>

       1. サブスクライブしたイベントをトリガーして、外部システムがコールバック URL に HTTP リクエストを送信するようにします。

       2. **手動設定** ページに戻り、ページ下部の**リクエストログ** セクションを確認します。Webhook が正しく機能している場合、受信したリクエストと Dify のレスポンスが表示されます。

              <Frame>
                <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workflow/plugin-trigger-manual-setup-request-logs.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=98d0bb804d62ecb554f67d26d67233a2" alt="リクエストログ" width="1218" height="518" data-path="images/use-dify/workflow/plugin-trigger-manual-setup-request-logs.png" />
              </Frame>

    4. **作成** をクリックします。
  </Tab>
</Tabs>

## プラグイントリガーをテストする

未公開のプラグイントリガーをテストするには、まず **このステップ実行** をクリックするか、ワークフロー全体をテスト実行する必要があります。これによりトリガーがリスニング状態になり、外部イベントを監視できるようになります。そうしないと、イベントが発生してもトリガーはサブスクライブしたイベントをキャプチャしません。