> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-zh/gong-zuo-qu-he-qu-dong-qi/zapier-integration.md).
# Zapier 集成
Shade 的 Zapier 集成可让你将工作区连接到成千上万种外部工具和服务。你可以将 Shade 用作触发器——监听上传或转录完成等事件——也可以将其用作操作目标，在其他地方发生事件时在 Shade 中执行操作。这让你无需编写任何代码，就能轻松构建自动化工作流。
## 开始使用
在将 Shade 连接到 Zapier 之前，你需要从工作区设置中获取三项内容：
* **Zapier 集成密钥** — 在“设置 → 开发者”中找到。此密钥对你的工作区是唯一的。
* **应用程序 ID** — 同样可在“开发者”部分找到。这是你的工作区 ID。
* **API 密钥** — 通过“设置 → API 密钥”单独生成。
当你在 Zapier 中连接 Shade 账户时，系统会提示你输入这三项信息。连接成功后，你的 Shade 工作区将在所有 Zaps 中同时可作为触发源和操作目标使用。
## 配置 Webhook
Webhook 仪表板（设置 → 开发者）用于管理 Shade 向外部服务发送的事件。在此页面中，你可以配置一个端点 URL（例如 Zapier 的 webhook URL）来接收你的工作区发出的事件。
关键工作流节点会触发事件，例如文件上传或转录完成时。每个事件都包含有关相关资源的元数据，下游服务可以利用这些信息执行进一步操作。
## 触发器和操作
在 Zapier 中，Shade 同时支持触发器和操作，让你在构建工作流时更具灵活性。
*触发器* 监听 Shade 中的事件，并在发生某些情况时启动一个 Zap，例如上传了新文件或转录完成。
*操作* 让其他应用驱动 Shade 内部的活动，例如为特定资源生成分享链接。
## 示例工作流
* **在上传时生成分享链接：** 当文件上传到 Shade 时，自动生成并共享一个公开链接，这对于无需手动步骤即可将资源分发给外部相关方非常有用。
* **将转录发送到外部服务：** 当转录完成时，将转录内容转发到其他工具，例如文档编辑器、CRM 或通知服务。
## 在 Zapier 工作流中查找资源
当文件首次上传到 Shade 时，其资源 ID 不会立即被外部系统知晓。若要在后续操作中引用特定资源，请使用该资源的 **路径**，它包含在上传 webhook 负载中。路径可唯一标识资源在你的云盘中的位置，并可在 Zap 中用于在 Shade 内查找该资源或对其执行操作。你也可以在单独的操作中使用该资源的 ID。
## 注意事项
* 你的 Zapier 集成密钥与工作区相关联。若你管理多个 Shade 工作区，每个工作区都会有各自的密钥。
* API 密钥与集成密钥分开管理，可通过“设置 → API 密钥”生成或撤销。
* 在 Shade 开始向外部服务发送事件之前，必须先在 Webhook 仪表板中配置 webhook 端点。
有关如何配置 Zapier 自动化的更多信息，请参阅此处的 Zapier 文档：
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/gong-zuo-qu-he-qu-dong-qi/zapier-integration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
