Zapier ve Make webhook tarifi

1. Gerekenler

Sahibi olduğunuz bir QR Wait hesabı (yöneticiler ve görevliler entegrasyonları görmez), bir Zapier ya da Make hesabı ve başka bir sekmede açık yönetim sayfasının Entegrasyonlar ekranı.

2. Zapier

1. Zapier'de tetikleyicisi Webhooks by Zapier, olayı Catch Hook olan bir Zap oluşturun. Zapier'in gösterdiği webhook adresini kopyalayın.
2. QR Wait'te Entegrasyonlar altında adresi Uç nokta adresi (https) alanına yapıştırın, istediğiniz olayları işaretleyin ve Webhook ekle'ye basın. Bir kez gösterilen imza sırrını saklayın.
3. Gerçek bir ticket.joined olayı gelsin diye telefondan sıranıza bir kez girin ya da görevli panelinden birini ekleyin. Test olayı gönder yalnızca bilet alanları olmayan bir ping gönderir: adresin cevap verdiğini gösterir.
4. Zapier'e dönüp tetikleyiciyi test edin ve o olayı seçin. Bir eylem ekleyin, örneğin Google Sheets › Create Spreadsheet Row, ve alanları eşleyin: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Zap'i yayınlayın. Bundan sonra her olay bir satır ekler.

3. Make

1. Make'te ilk modülü Webhooks › Custom webhook olan bir senaryo oluşturun. Bir webhook ekleyip adresini kopyalayın.
2. Adresi yukarıdaki gibi QR Wait'in Entegrasyonlar ekranına yapıştırın ve Webhook ekle'ye basın.
3. Make verinin yapısını öğrenmek için bekler: sıranıza bir kez girin ya da görevli panelinden birini ekleyin.
4. Sonraki modülü ekleyin, örneğin Google Sheets › Add a Row ya da sohbetinize bir mesaj; alanları eşleyip senaryoyu açın.

4. Ne gelir

Her olay buna benzer bir JSON gövdesidir. QR Wait'te yalnızca ihtiyacınız olan olayları işaretleyin ya da Zapier veya Make'te type alanına göre süzün.

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

İsimler, katılım formu yanıtları ve randevu kodları yalnızca o adres için Adları, katılım formu yanıtlarını ve randevu kodlarını ekle işaretliyse gönderilir. İşaretli değilse olaylar yalnızca numara ve zaman taşır.

Başarısız bir gönderim aynı id ile yaklaşık 9 saat yeniden denenir. Mükerrer satır sorun olacaksa satırı eklemeden önce bunu kontrol edin (bir arama adımıyla).

5. Ters yön: Zapier ya da Make'ten sıraya kişi eklemek

Başka bir aracın sıraya kişi eklemesi için (web sitesindeki bir form, bir rezervasyon aracı) API anahtarları altında Okuma ve yazma yetkili bir anahtar oluşturun ve Webhooks by Zapier › POST ya da Make'in HTTP › Make a request modülünden şu isteği gönderin:

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

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

Cevap yeni numaradır, örneğin { "no": 43 }. Kuyruk kimlikleri GET /api/v1/queues ile gelir. Sıradakini çağırma, hizmet verildi işaretleme ve tüm alanlar API başvuru belgesinde (İngilizce).

6. Güvenli tutun

• Zapier'in ya da Make'in verdiği adres, Zap'inize ya da senaryonuza veri göndermeye yeter: paylaşmayın.
• Zapier ve Make QR Wait'in imzasını kendiliğinden kontrol etmez. Alıcı tarafın olayın QR Wait'ten geldiğinden emin olması gerekiyorsa X-QRWait-Signature başlığını API başvuru belgesindeki gibi, örneğin bir kod adımında doğrulayın.
• Bir anahtara yalnızca gereken yetkiyi verin ve artık kullanılmayınca Entegrasyonlar ekranından iptal edin; ekran her anahtarın en son ne zaman kullanıldığını gösterir.