وصفة Webhook لـ Zapier وMake

1. ما تحتاجونه

حساب QR Wait تملكونه (لا يرى المديرون والموظفون التكاملات)، وحساب Zapier أو Make، وشاشة التكاملات في صفحة الإدارة مفتوحة في تبويب آخر.

2. Zapier

1. في Zapier، أنشئوا Zap يكون مشغّله Webhooks by Zapier وحدثه Catch Hook. انسخوا عنوان الـ webhook الذي يعرضه Zapier.
2. في QR Wait، ضمن التكاملات، الصقوه في عنوان الاستقبال (https)، وحددوا الأحداث التي تريدونها، ثم اضغطوا إضافة ويب هوك. احتفظوا بسرّ التوقيع الذي يظهر مرة واحدة فقط.
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، أنشئوا سيناريو تكون وحدته الأولى Webhooks › Custom webhook. أضيفوا webhook وانسخوا عنوانه.
2. الصقوه في التكاملات في QR Wait كما سبق، واضغطوا إضافة ويب هوك.
3. ينتظر Make ليتعرّف على بنية البيانات: انضموا إلى طابوركم مرة واحدة أو أضيفوا شخصًا من لوحة الموظف.
4. أضيفوا الوحدة التالية، مثل Google Sheets › Add a Row أو رسالة إلى محادثتكم، واربطوا الحقول وشغّلوا السيناريو.

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. تحققوا منه قبل إضافة صف (بخطوة بحث) إن كان التكرار يسبب مشكلة.

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 }. تأتي معرّفات الطوابير من GET /api/v1/queues. استدعاء المجموعة التالية وتسجيل إتمام الخدمة وكل الحقول موجودة في مرجع الـ API (بالإنجليزية).

6. حافظوا على الأمان

• العنوان الذي يمنحكم إياه Zapier أو Make يكفي لإرسال بيانات إلى الـ Zap أو السيناريو: لا تشاركوه.
• لا يتحقق Zapier وMake من توقيع QR Wait من تلقاء نفسيهما. إن احتاج الطرف المستقبِل إلى التأكد من أن الحدث جاء من QR Wait، فتحققوا من الترويسة X-QRWait-Signature كما يبيّن مرجع الـ API، مثلًا في خطوة شيفرة.
• امنحوا كل مفتاح الصلاحية التي يحتاجها فقط، وألغوه من شاشة التكاملات حين يتوقف استخدامه؛ تعرض الشاشة آخر مرة استُخدم فيها كل مفتاح.