Webhook 以及 Slack、Microsoft Teams 或 Discord 通知

阅读需 4 分钟 · 更新于 2026-11-15

简短回答

在 Pro 和 Team 中,打开 控制台 > 集成,即可把 Pandafile 事件发送到 Slack、Microsoft Teams 或 Discord 频道,或作为带签名的 Webhook 发送到你自己的服务器。选择事件,发送测试,并查看投递日志。

在 Pro 和 Team 中,一旦有事发生,Pandafile 会立即通知你的其他工具:在 Slack、Microsoft Teams 或 Discord 频道中发一条消息,或者发送 Webhook,即向你自己的服务器发出一个带签名的 HTTPS 请求。

可选择的事件

  • 传输已就绪:上传完成,链接可以使用。
  • 传输已下载:每位收件人仅第一次下载时通知。你也可以改为每次下载都通知。
  • 传输已过期。
  • 收件人的批准或修改请求。
  • 有人上传到你的文件请求。
  • 所有人均已签署文档(Pandafile Sign)。

添加集成

  1. 在 Slack、Microsoft Teams 或 Discord 中为频道创建一个传入 Webhook,并复制其 URL。如果是你自己的系统,请使用服务器上的 HTTPS 地址。
  2. 登录 Pandafile,打开 控制台 > 集成。
  3. 在“添加集成”下选择类型,粘贴 URL,按需填写名称,并勾选你想要的事件。
  4. 点击“添加集成”,然后点击“发送测试事件”检查是否送达。

你最多可以添加 5 个集成。聊天消息使用你账户的语言。

面向开发者的 Webhook

  • 每次投递都是一个 JSON POST,包含事件类型、ID 和详情:ID、标题、链接、计数和收件人邮箱地址。其中绝不包含文件内容、密码或个人下载链接。
  • 每个请求都带有 Pandafile-Signature 请求头,其中包含时间戳(t)以及用你的签名密钥对时间戳和正文计算出的 HMAC-SHA256 签名(v1)。密钥以 whsec_ 开头,只显示一次。
  • 点击“新密钥”会生成新的签名密钥。旧密钥在 24 小时内仍然有效,因此你可以平滑切换,不会漏掉事件。
  • 请在 10 秒内以 2xx 状态码响应。否则我们会在 1 分钟、5 分钟、30 分钟、2 小时和 12 小时后重试。
  • 投递日志显示每个集成最近 50 次投递及其结果。

团队、测试模式和 Zapier

在团队中,每个人管理自己的集成,只接收自己传输的事件。使用测试 API 密钥创建的测试传输,其事件会以 livemode 为 false 发送到 Webhook,绝不会发送到 Slack、Teams 或 Discord。Zapier 和 Make 通过 Pandafile API 连接,显示在“API 订阅”下。

准备好发送了吗?

每次传输最大 50 GB 免费,无需账号。

发送文件