Resep webhook untuk Zapier dan Make

1. Yang Anda perlukan

Akun QR Wait milik Anda (manajer dan petugas tidak melihat integrasi), akun Zapier atau Make, dan layar Integrasi di halaman admin yang terbuka di tab lain.

2. Zapier

1. Di Zapier, buat Zap dengan Webhooks by Zapier sebagai pemicu dan Catch Hook sebagai peristiwanya. Salin URL webhook yang ditampilkan Zapier.
2. Di QR Wait, pada Integrasi, tempelkan ke Alamat endpoint (https), centang peristiwa yang diinginkan, lalu tekan Tambah webhook. Simpan rahasia penandatanganan yang hanya ditampilkan sekali.
3. Ikut antrean Anda sekali dari ponsel, atau tambahkan seseorang di panel petugas, agar peristiwa ticket.joined sungguhan masuk. Kirim peristiwa uji hanya mengirim ping tanpa kolom tiket: itu hanya menunjukkan bahwa alamatnya menjawab.
4. Kembali ke Zapier, uji pemicunya dan pilih peristiwa itu. Tambahkan tindakan, misalnya Google Sheets › Create Spreadsheet Row, lalu petakan kolomnya: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Terbitkan Zap. Mulai sekarang setiap peristiwa menambah satu baris.

3. Make

1. Di Make, buat skenario yang modul pertamanya Webhooks › Custom webhook. Tambahkan webhook lalu salin alamatnya.
2. Tempelkan di Integrasi QR Wait seperti di atas, lalu tekan Tambah webhook.
3. Make menunggu untuk mempelajari struktur data: ikut antrean Anda sekali atau tambahkan seseorang di panel petugas.
4. Tambahkan modul berikutnya, misalnya Google Sheets › Add a Row atau pesan ke chat Anda, petakan kolomnya, lalu aktifkan skenario.

4. Apa yang masuk

Setiap peristiwa berupa isi JSON seperti ini. Centang di QR Wait hanya peristiwa yang Anda perlukan, atau saring berdasarkan type di Zapier atau 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" }
}

Nama, jawaban formulir, dan kode pemesanan hanya dikirim jika Anda mencentang Sertakan nama, jawaban formulir bergabung, dan kode pemesanan untuk alamat itu. Tanpanya, peristiwa hanya berisi nomor dan waktu.

Pengiriman yang gagal dicoba ulang selama sekitar 9 jam dengan id yang sama. Periksa dulu sebelum menambah baris (dengan langkah pencarian) jika duplikat akan jadi masalah.

5. Arah sebaliknya: menambahkan orang dari Zapier atau Make

Agar alat lain dapat memasukkan orang ke antrean (formulir di situs web, alat pemesanan), buat kunci dengan akses Baca dan tulis di bagian Kunci API, lalu kirim permintaan dari Webhooks by Zapier › POST atau modul HTTP › Make a request di Make:

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

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

Jawabannya adalah nomor baru, misalnya { "no": 43 }. ID antrean didapat dari GET /api/v1/queues. Memanggil grup berikutnya, menandai sudah dilayani, dan semua kolom ada di referensi API (bahasa Inggris).

6. Tetap aman

• Alamat dari Zapier atau Make sudah cukup untuk mengirim data ke Zap atau skenario Anda: jangan dibagikan.
• Zapier dan Make tidak memeriksa tanda tangan QR Wait dengan sendirinya. Jika pihak penerima harus yakin bahwa suatu peristiwa berasal dari QR Wait, verifikasi header X-QRWait-Signature seperti ditunjukkan referensi API, misalnya di langkah kode.
• Beri setiap kunci hanya akses yang dibutuhkan, dan cabut di layar Integrasi begitu tidak dipakai lagi; layar itu menunjukkan kapan setiap kunci terakhir digunakan.