Webhook 以及 Slack、Microsoft Teams 或 Discord 通知
简短回答
在 Pro 和 Team 中,打开 控制台 > 集成,即可把 Pandafile 事件发送到 Slack、Microsoft Teams 或 Discord 频道,或作为带签名的 Webhook 发送到你自己的服务器。选择事件,发送测试,并查看投递日志。
在 Pro 和 Team 中,一旦有事发生,Pandafile 会立即通知你的其他工具:在 Slack、Microsoft Teams 或 Discord 频道中发一条消息,或者发送 Webhook,即向你自己的服务器发出一个带签名的 HTTPS 请求。
可选择的事件
- 传输已就绪:上传完成,链接可以使用。
- 传输已下载:每位收件人仅第一次下载时通知。你也可以改为每次下载都通知。
- 传输已过期。
- 收件人的批准或修改请求。
- 有人上传到你的文件请求。
- 所有人均已签署文档(Pandafile Sign)。
添加集成
- 在 Slack、Microsoft Teams 或 Discord 中为频道创建一个传入 Webhook,并复制其 URL。如果是你自己的系统,请使用服务器上的 HTTPS 地址。
- 登录 Pandafile,打开 控制台 > 集成。
- 在“添加集成”下选择类型,粘贴 URL,按需填写名称,并勾选你想要的事件。
- 点击“添加集成”,然后点击“发送测试事件”检查是否送达。
你最多可以添加 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 订阅”下。