Zapier 與 Make 的 Webhook 使用教學

1. 準備事項

一個由您擁有的 QR Wait 帳號（管理員與服務人員看不到整合功能）、一個 Zapier 或 Make 帳號，並在另一個分頁開啟管理後台的整合畫面。

2. Zapier

1. 在 Zapier 中建立一個 Zap，以 Webhooks by Zapier 作為觸發條件，並選擇 Catch Hook 作為事件。複製 Zapier 顯示的 Webhook 網址。
2. 在 QR Wait 的整合中，將網址貼到端點網址（https），勾選您需要的事件，然後按下新增 Webhook。請保存只會顯示一次的簽署密鑰。
3. 用手機加入您的隊伍一次，或在服務人員面板中新增一位顧客，讓真正的 ticket.joined 事件送達。傳送測試事件只會傳送不含號碼牌欄位的 ping：只能確認網址有回應。
4. 回到 Zapier，測試觸發條件並選擇該事件。新增一個動作，例如 Google Sheets › Create Spreadsheet Row，並對應下列欄位：type、queue.name、ticket.no、ticket.size、ticket.joined_at。
5. 發布 Zap。從現在起，每個事件都會新增一列。

3. Make

1. 在 Make 中建立一個情境（scenario），第一個模組為 Webhooks › Custom webhook。新增一個 Webhook 並複製其網址。
2. 依上述方式將網址貼到 QR Wait 的整合中，然後按下新增 Webhook。
3. Make 會等待以了解資料結構：請加入您的隊伍一次，或在服務人員面板中新增一位顧客。
4. 新增下一個模組，例如 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 標頭，例如在程式碼步驟中進行。
• 金鑰只授予所需的權限，不再使用時請在整合畫面中撤銷；該畫面會顯示每組金鑰上次使用的時間。