Zapier 与 Make Webhook 教程

最后更新: 2026年10月19日

无需编程，即可把每个排队事件发送到 Google 表格、CRM 或团队聊天。QR Wait 会把每个事件发送到一个网址；Zapier 和 Make 为您提供这个网址，并把事件传给下一步。

1. 准备工作

一个您作为所有者的 QR Wait 账户（经理和工作人员看不到集成），一个 Zapier 或 Make 账户，以及在另一个标签页中打开的管理页面集成界面。

2. Zapier

在 Zapier 中新建一个 Zap，触发器选 Webhooks by Zapier，事件选 Catch Hook。复制 Zapier 显示的 Webhook 网址。
在 QR Wait 的集成中，把它粘贴到接收地址（https），勾选所需事件，然后点击添加 Webhook。请保存只显示一次的签名密钥。
用手机加入一次您的队列，或在工作人员面板中添加一人，让真实的 ticket.joined 事件到达。发送测试事件只发送一个不含票据字段的 ping：它只能说明该地址有响应。
回到 Zapier，测试触发器并选择该事件。添加一个操作，例如 Google Sheets › Create Spreadsheet Row，并映射字段：type、queue.name、ticket.no、ticket.size、ticket.joined_at。
发布该 Zap。此后每个事件都会添加一行。

3. Make

在 Make 中新建一个场景，第一个模块为 Webhooks › Custom webhook。添加一个 Webhook 并复制其地址。
像上面一样把它粘贴到 QR Wait 的集成中，然后点击添加 Webhook。
Make 会等待以了解数据结构：加入一次您的队列，或在工作人员面板中添加一人。
添加下一个模块，例如 Google Sheets › Add a Row 或发往聊天的消息，映射字段后开启场景。

4. 会收到什么

每个事件都是类似下面这样的 JSON 正文。在 QR Wait 中只勾选需要的事件，或在 Zapier、Make 中按 type 筛选。

{
  "id": "d_3f9a1c0b7e2d4a61",
  "type": "ticket.joined",
  "created": "2026-10-10T09:12:30.010Z",
  "account": "antalyabb",
  "queue": { "id": "a1b2c3d4e5", "name": "Konyaaltı Beach", "slug": "konyaalti" },
  "ticket": { "no": 42, "size": 2, "source": "qr", "joined_at": "2026-10-10T09:12:30.004Z" }
}

只有为该地址勾选了包含姓名、加入表单回答和预约码，才会发送姓名、表单回答和预约码。否则事件只包含号码和时间。

发送失败时会用同一个 id 重试约 9 小时。如果重复行会造成问题，请在添加行之前先检查（用查找步骤）。

5. 反方向：从 Zapier 或 Make 添加访客

如需让其他工具把人加入队列（网站表单、预订工具），请在 API 密钥下创建一个读写权限的密钥，并从 Webhooks by Zapier › POST 或 Make 的 HTTP › Make a request 发送请求：

POST https://qrwait.app/api/v1/queues/<queue id>/tickets
Authorization: Bearer qrw_…
Content-Type: application/json

{ "size": 2, "note": "Website" }

返回的是新号码，例如 { "no": 43 }。队列 ID 可通过 GET /api/v1/queues 获取。叫下一组、标记已服务以及所有字段，请见 API 参考（英文）。

6. 注意安全

Zapier 或 Make 给您的地址足以向您的 Zap 或场景发送数据：请勿分享。
Zapier 和 Make 不会自行校验 QR Wait 的签名。如果接收方必须确认事件来自 QR Wait，请按 API 参考所示校验 X-QRWait-Signature 请求头，例如在代码步骤中。
只给密钥所需的权限，不再使用时在集成界面撤销；界面会显示每个密钥最近一次的使用时间。