> 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-ji-cheng.md).
# Zapier 集成
Shade 的 Zapier 集成功能允许你将工作区连接到成千上万的外部工具和服务。你可以将 Shade 用作触发器——监听上传或转录完成等事件——也可以将其用作操作目标，在其他地方发生事件时在 Shade 中执行操作。这使你无需编写任何代码即可轻松构建自动化工作流。
## 入门
在将 Shade 连接到 Zapier 之前，你需要从工作区设置中获取三样东西：
* **Zapier 集成密钥** — 可在“设置”→“开发者”中找到。此密钥对你的工作区是唯一的。
* **应用 ID** — 也可在“开发者”部分中找到。这是你的工作区 ID。
* **API 密钥** — 通过“设置”→“API 密钥”单独生成。
当你在 Zapier 中连接 Shade 账户时，系统会提示你输入这三项内容。连接完成后，你的 Shade 工作区将可在所有 Zap 中同时作为触发源和操作目标使用。
## 配置 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/gong-zuo-qu-he-qu-dong-qi/zapier-ji-cheng.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.