สูตร webhook สำหรับ Zapier และ Make

1. สิ่งที่ต้องมี

บัญชี QR Wait ที่คุณเป็นเจ้าของ (ผู้จัดการและพนักงานไม่เห็นการเชื่อมต่อ) บัญชี Zapier หรือ Make และหน้าจอ การเชื่อมต่อ ของหน้าจัดการที่เปิดไว้ในอีกแท็บหนึ่ง

2. Zapier

1. ใน Zapier ให้สร้าง Zap โดยใช้ Webhooks by Zapier เป็นทริกเกอร์ และ Catch Hook เป็นเหตุการณ์ คัดลอก URL ของ webhook ที่ Zapier แสดง
2. ใน QR Wait ที่ การเชื่อมต่อ ให้วาง URL ลงใน ที่อยู่ปลายทาง (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 และคัดลอกที่อยู่ของ webhook นั้น
2. วางที่อยู่ลงใน การเชื่อมต่อ ของ QR Wait ตามด้านบน แล้วกด เพิ่ม webhook
3. Make จะรอเพื่อเรียนรู้โครงสร้างของข้อมูล: เข้าคิวของคุณหนึ่งครั้งหรือเพิ่มคนในหน้าจอพนักงาน
4. เพิ่มโมดูลถัดไป เช่น Google Sheets › Add a Row หรือข้อความไปยังแชตของคุณ จับคู่ฟิลด์ แล้วเปิดใช้ scenario

4. ข้อมูลที่ได้รับ

แต่ละเหตุการณ์เป็นเนื้อหา JSON แบบนี้ เลือกเฉพาะเหตุการณ์ที่ต้องการใน QR Wait หรือกรองตาม type ใน Zapier หรือ Make

{
  "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" }
}

ชื่อ คำตอบในแบบฟอร์มเข้าคิว และรหัสการจองจะถูกส่งเฉพาะเมื่อคุณเลือก รวมชื่อ คำตอบในแบบฟอร์มเข้าคิว และรหัสการจอง สำหรับที่อยู่นั้น หากไม่เลือก เหตุการณ์จะมีเพียงหมายเลขและเวลา

การส่งที่ล้มเหลวจะถูกลองใหม่ประมาณ 9 ชั่วโมงด้วย id เดิม หากข้อมูลซ้ำมีผลกระทบ ให้ตรวจสอบ id ก่อนเพิ่มแถว (ด้วยขั้นตอนค้นหา)

5. อีกทางหนึ่ง: เพิ่มคนจาก Zapier หรือ Make

หากต้องการให้เครื่องมืออื่นเพิ่มคนเข้าคิว (แบบฟอร์มบนเว็บไซต์ เครื่องมือจอง) ให้สร้างคีย์ใน คีย์ API ที่มีสิทธิ์ อ่านและเขียน แล้วส่งคำขอจาก Webhooks by Zapier › POST หรือ HTTP › Make a request ของ Make:

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

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

การตอบกลับคือหมายเลขคิวใหม่ เช่น { "no": 43 } รหัสคิวได้จาก GET /api/v1/queues การเรียกกลุ่มถัดไป การทำเครื่องหมายรับบริการแล้ว และทุกฟิลด์อยู่ในเอกสารอ้างอิง API (ภาษาอังกฤษ)

6. รักษาความปลอดภัย

• ที่อยู่ที่ Zapier หรือ Make ให้มาเพียงพอสำหรับการส่งข้อมูลเข้า Zap หรือ scenario ของคุณ: อย่าแชร์ที่อยู่นี้
• Zapier และ Make ไม่ตรวจสอบลายเซ็นของ QR Wait เอง หากฝั่งผู้รับต้องมั่นใจว่าเหตุการณ์มาจาก QR Wait ให้ตรวจสอบเฮดเดอร์ X-QRWait-Signature ตามที่เอกสารอ้างอิง APIแสดง เช่น ในขั้นตอนโค้ด
• ให้สิทธิ์แก่คีย์เท่าที่จำเป็นเท่านั้น และเพิกถอนคีย์ที่หน้าจอ การเชื่อมต่อ เมื่อไม่ใช้แล้ว หน้าจอนี้แสดงว่าแต่ละคีย์ถูกใช้ครั้งล่าสุดเมื่อใด