8 min 阅读intermediate最后更新: 2026年11月9日

如何将活动的 RSVP、签到和照片发送到其他应用

Webhooks 能让您的活动在事情发生的瞬间告知其他应用。当宾客回复 RSVP、在门口签到,或相册中出现新照片时,Fotify 会向您指定的地址发送一条简短的消息。之后它可以进入您的 CRM、Google 表格、Slack 频道、邮件序列或您自己的服务器。

您可以通过两种方式连接:

  • Zapier 或 Make,无需代码:使用 API 密钥连接,然后选择要触发的操作。
  • 您自己的 Webhook 网址:Fotify 会向它发送一条带签名的 JSON 消息。

Webhooks、Zapier 和 Make 从 Professional 方案起包含,并且适用于所有活动订阅下的活动。

Fotify 可以发送什么

每个 Webhook 可以监听以下一种或多种时刻:

  • 收到 RSVP:有宾客回复或更改了 RSVP。包含其姓名、邮箱、电话、回复、人数、备注以及您自定义问题的答案。
  • 宾客已签到:有宾客在门口完成签到,包含同行人员和到场的人。
  • 新照片或视频:相册中出现了新内容。照片附带一个 7 天内有效的图片链接。等待审核的照片会在您批准后发送,私密相册中的照片绝不会发送。
  • 活动已开始:您已开始活动,宾客可以上传。
  • 活动已结束:您结束了活动,或其上传窗口已关闭。

第 1 步:连接 Zapier 或 Make

  1. 在 Fotify 仪表板中,打开账户设置 → 集成。
  2. 为密钥输入一个名称,例如“Zapier”,然后点击创建密钥。
  3. 立即复制该密钥。出于安全考虑,它只会显示一次。
  4. 通过以下链接在 Zapier 或 Make 中打开 Fotify 应用(它尚未上架这两个平台的应用目录),在提示连接时粘贴该密钥。
  5. 选择一个触发器,例如新的 RSVP 回复或新照片或视频,然后从列表中选择您的活动。

活动列表会显示您管理的、方案包含 Webhooks 的活动。您启用的每个 Zap 或场景都会显示在该活动的 Webhooks 页面上,并标注为 Zapier 或 Make。

您也可以使用 Zapier 的 Webhooks by Zapier → Catch Hook 或 Make 的 Custom webhook 来代替 Fotify 应用:复制它们提供的地址,并按第 2 步将其添加为 Webhook 网址。

第 2 步:添加 Webhook 网址

  1. 在仪表板中打开您的活动,向下滚动到 Webhooks、Zapier 与 Make 卡片。
  2. 点击设置 Webhooks,然后点击添加 Webhook。
  3. 粘贴用于接收消息的地址。它必须以 https:// 开头,并且可从互联网访问。
  4. 勾选要发送的内容,也可以添加标签,然后点击添加 Webhook。
  5. 复制新 Webhook 上方显示的签名密钥,并将其保存到您的接收端。
  6. 点击发送测试事件,检查一切是否正常送达。

只有能够管理该活动的人才能添加或更改它的 Webhooks,并且每种时刻都需要有权访问对应的数据:宾客相关的时刻需要有权访问宾客名单,照片相关的时刻需要有权访问相册。

消息长什么样

每条消息都是带有 JSON 正文的 POST 请求:

{
  "id": "4f1c2e9a-7b2d-4c1e-9a8f-2d3b4c5e6f70",
  "type": "rsvp.responded",
  "createdAt": "2026-06-01T18:24:05.000Z",
  "event": { "id": "…", "name": "Ana & Leo's Wedding" },
  "data": {
    "rsvp": {
      "firstName": "Alex",
      "lastName": "Rivera",
      "email": "alex@example.com",
      "status": "accepted",
      "confirmedGuests": 2
    }
  }
}

RSVP 的 status 为 accepted、declined、not_answered、attended、pending_approval(等待您的审批)或 waitlisted 之一。等待审批或在候补名单中的宾客,其 confirmedGuests 为 0,所申请的人数在 requestedGuests 中;当您批准或拒绝他们时,rsvp.responded 会再次触发。

消息重新发送时,id 保持不变,因此您的接收端可以跳过重复消息。请求头会注明是哪种时刻(Fotify-Event)以及是哪条消息(Fotify-Delivery)。

活动本身的日期,例如 eventDate 和 eventTime,采用举办地的时区,与您的宾客看到的一致。

验证消息确实来自 Fotify

每条消息都带有 Fotify-Signature 请求头,形如 t=1780000000,v1=5257a8…。验证方法:

  1. 取出 t(发送时间)和原始请求正文。
  2. 使用该 Webhook 的签名密钥,对 t + . + 正文计算 HMAC-SHA256。
  3. 将结果与 v1 比较,并拒绝 t 距今超过 5 分钟的消息。

在 Node.js 中:

const crypto = require("crypto");

function isFromFotify(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${parts.t}.${rawBody}`)
    .digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}

您可以在该 Webhook 的卡片上再次显示密钥,或创建新密钥。新密钥会立即取代旧密钥。

重试、发送记录与自动关闭的 Webhook

  • 请在 10 秒内返回 2xx 状态码以确认收到消息。
  • 发送失败的消息会被重试 8 次,持续约 4 小时。
  • 每个 Webhook 的发送记录会显示最近 30 天内的每条消息,包括其状态、响应和完整正文。点击重新发送即可再发一次。
  • Webhook 会在以下情况下自动关闭:其网址连续失败 50 次;接收端返回 410 Gone(Zapier 和 Make 以此表示某个 Zap 或场景已被删除);或添加它的人不再有权访问该活动。其卡片上会说明原因。问题解决后可重新开启:此后它将以您的身份运行。

使用 AI 助手设置 Webhooks

如果您已连接 AI 助手(如 Claude),可以让它列出活动的 Webhooks、添加、发送测试或删除。网址需要由您提供,签名密钥只会向您显示一次。

常见问题

Q: 我需要哪种方案? A: Webhooks、Zapier 和 Make 从 Professional 方案起包含,并且适用于所有活动订阅。在其他方案中,Webhooks 卡片会告诉您哪个方案包含它们。

Q: 我需要 Zapier 或 Make 账户吗? A: 需要,使用 Zapier 或 Make 需要在那里拥有账户。发送到您自己网址的 Webhooks 则无需其他账户。

Q: 一个活动最多可以有多少个 Webhook? A: 最多 25 个,包括由 Zapier 和 Make 创建的。

Q: 为什么有张照片没有送达我的 Webhook? A: 照片会在出现在相册时发送。等待审核的照片会在您批准后发送,私密相册中的照片绝不会发送。

Q: 我可以使用自己电脑上的网址来测试吗? A: 不可以。Fotify 只会向公开的 https:// 地址发送。请使用隧道服务或请求检查工具,从您的电脑进行测试。

Q: 如果我撤销了 API 密钥,我的 Webhooks 会怎样? A: Zapier 和 Make 将无法再使用该密钥创建或移除订阅。请在活动的 Webhooks 页面中删除您不再需要的订阅。

这篇文章对您有帮助吗?

相关文章