> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-docs-new-agent-experience.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 集成触发器

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/cloud/use-dify/nodes/trigger/plugin-trigger)。

<Info>
  触发器仅适用于工作流应用。
</Info>

集成触发器可在外部系统发生特定事件时自动运行工作流。你通过触发器集成订阅这些事件，再将对应的触发器添加到工作流中即可。

例如，安装 GitHub 触发器集成后，你可以订阅 `Pull Request`、`Push`、`Issue` 等事件。订阅 `Pull Request` 并添加对应的触发器后，每当有人在指定仓库中创建 pull request，工作流就会自动运行。

## 添加和配置集成触发器

1. 在工作流画布上，单击右键并选择 **添加节点** > **开始**，然后选择要启动工作流的集成触发器事件。如需更多集成，可在 [市场](https://marketplace.dify.ai/?language=zh-Hans\&category=trigger) 中搜索。

   <Tip>
     * 若目标系统没有可用的触发器集成，可 [向社区请求](https://github.com/langgenius/dify-plugins/issues/new?template=plugin_request.yaml)、[自行开发](/zh/develop-plugin/dev-guides-and-walkthroughs/trigger-plugin)，或改用 [Webhook 触发器](/zh/cloud/use-dify/nodes/trigger/webhook-trigger)。
     * 一个工作流可包含多个集成触发器。如果这些触发器分支共享下游节点，可添加 [变量聚合器](/zh/cloud/use-dify/nodes/variable-aggregator) 将它们汇聚。
   </Tip>

2. 选择一个现有订阅或 [创建新订阅](/zh/cloud/use-dify/nodes/trigger/plugin-trigger#创建订阅)。触发器需要订阅才能接收事件。

3. 配置其他必需设置。

<Info>
  集成触发器的输出变量由触发器集成定义，无法修改。
</Info>

## 创建订阅

订阅是一个用于监听外部系统事件的 webhook。每个触发器集成在每个工作空间中最多支持 10 个订阅。

<Accordion title="什么是 webhook？">
  Webhook 允许一个系统自动向另一个系统发送实时数据。当某个事件发生时，源系统将事件详情打包为 HTTP 请求，发送至目标系统提供的 URL。
</Accordion>

Dify 支持两种创建订阅的方式，具体取决于触发器集成支持的选项。

* **自动**：你选择要订阅的事件，Dify 在外部系统中自动创建 webhook。这需要先通过 OAuth 或 API key 授权，以便 Dify 代表你完成配置。
* **手动**：你使用 Dify 提供的回调 URL 自行在外部系统中创建 webhook，无需授权。

<Tabs>
  <Tab title="OAuth（自动）">
    在 Dify Cloud 上，许多主流触发器集成都预配置了默认 OAuth 客户端，你无需注册自己的 OAuth 应用即可一键授权。如需改用自己的 OAuth 应用，则选择 **自定义**。

    **默认**

    1. 选择 **通过 OAuth 创建** > **默认**，然后点击 **保存并授权**。
    2. 在弹出的授权页面上，授予 Dify 访问权限。
    3. 填写订阅名称，选择要订阅的事件，并配置其他必需设置。
           <Tip>
             建议订阅所有可用事件。触发器只会响应订阅中涵盖的事件，因此一个涵盖广泛的订阅可被后续添加的触发器复用，无需再创建新订阅。
           </Tip>
    4. 点击 **创建**。

    **自定义**

    1. 选择 **通过 OAuth 创建** > **自定义**。
    2. 在外部系统中，使用 Dify 提供的回调 URL 创建一个 OAuth 应用。
    3. 返回 Dify，输入应用的客户端 ID 和客户端密钥，然后点击 **保存并授权**。
       <Info>保存后，同一凭据可在后续订阅中复用。</Info>
    4. 填写订阅名称，选择要订阅的事件，并配置其他必需设置。
           <Tip>
             建议订阅所有可用事件。触发器只会响应订阅中涵盖的事件，因此一个涵盖广泛的订阅可被后续添加的触发器复用，无需再创建新订阅。
           </Tip>
    5. 点击 **创建**。
  </Tab>

  <Tab title="API Key（自动）">
    1. 选择 **通过 API Key 创建**。
    2. 输入所需的验证信息，然后点击 **验证**。
    3. 填写订阅名称，选择要订阅的事件，并配置其他必需设置。
           <Tip>
             建议订阅所有可用事件。触发器只会响应订阅中涵盖的事件，因此一个涵盖广泛的订阅可被后续添加的触发器复用，无需再创建新订阅。
           </Tip>
    4. 点击 **创建**。
  </Tab>

  <Tab title="粘贴 URL 创建新订阅（手动）">
    1. 选择 **粘贴 URL 以创建新订阅**。
    2. 填写订阅名称，并使用 Dify 提供的回调 URL 在外部系统中创建 webhook。
    3. （可选）测试：触发一个已订阅的事件，然后在 **手动设置** 页面底部的 **请求日志** 中查看接收到的请求和 Dify 的响应。
           <Frame>
             <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/jyDkeP_GDYJzJ81D/images/use-dify/workflow/plugin-trigger-manual-setup-request-logs.png?fit=max&auto=format&n=jyDkeP_GDYJzJ81D&q=85&s=4da7116f701fb5f20b40ce501a096d08" alt="请求日志" width="1218" height="518" data-path="images/use-dify/workflow/plugin-trigger-manual-setup-request-logs.png" />
           </Frame>
    4. 点击 **创建**。
  </Tab>
</Tabs>

## 管理订阅

在 **集成** > **触发器** 中管理触发器集成的订阅。打开某个触发器集成后，可查看其所有订阅（包括每个订阅被多少个工作流使用），并进行编辑或删除。

## 测试集成触发器

如需测试未发布的触发器，先点击 **运行此步骤** 或测试运行整个工作流，使触发器进入监听状态。否则，即使订阅的事件发生，也不会被捕获。