قبل أن تبدأ
- في Rumore، افتح الاتصالات وابحث عن البطاقة أي نظام حجوزات.
- اختر تفعيل رابط الحجوزات، ثم انسخ رابط الحجوزات والمفتاح السري. لا يظهر المفتاح السري إلا مرة واحدة، لذا أبقِ الصفحة مفتوحة حتى تحفظ الـ zap أو السيناريو.
أضعت المفتاح السري؟ اختر استبدال المفتاح السري في البطاقة نفسها. يبقى القديم صالحًا 24 ساعة، فلا يضيع شيء أثناء تحديثه.
إذا كان نظام الحجوزات لديك لا يستطيع بدء zap إلا عند إنشاء حجز، فهذا يصلح أيضًا. أرسل الزيارة مع أوقاتها، وإذا أُلغي الحجز لاحقًا، فأرسله مرة أخرى مع status بالقيمة cancelled ونفس externalId.
عبر Zapier
- أنشئ zap يبدأ عندما يكتمل حجز في نظام الحجوزات لديك.
- أضف خطوة Webhooks by Zapier، واختر POST، والصق رابط الحجوزات في خانة URL.
- اضبط Payload Type على JSON، ثم طابِق الحقول الموضحة أدناه.
- ضمن Headers، أضف Authorization بالقيمة Bearer، ثم مسافة، ثم المفتاح السري.
تحتاج Webhooks by Zapier إلى خطة Zapier مدفوعة.
عبر Make
- ابدأ السيناريو بمشغّل الحجز المكتمل في نظام الحجوزات لديك.
- أضف وحدة HTTP المسماة Make a request، بالطريقة POST، والصق رابط الحجوزات في خانة URL.
- أضف ترويسة باسم Authorization بالقيمة Bearer، ثم مسافة، ثم المفتاح السري.
- اجعل نوع جسم الطلب JSON، ثم طابِق الحقول الموضحة أدناه.
الحقول المطلوب إرسالها
- name: اسم الضيف (إلزامي)
- email أو phone: واحد منهما على الأقل. اكتب رقم الهاتف مع رمز الدولة، مثل +4512345678.
- visitAt: وقت بدء الزيارة مع المنطقة الزمنية، مثل 2026-10-05T19:30:00+02:00 (إلزامي)
- endAt أو durationMinutes: وقت انتهائها. إذا لم يُرسَل أي منهما، تُحسب مدة الزيارة 90 دقيقة.
- externalId: رقم الحجز في نظامك، حتى لا يُحسب الحجز المكرر مرتين أبدًا
- status: إحدى القيم completed أو no_show أو cancelled. إذا لم يُرسَل، تُعتبر القيمة completed.
مثال جاهز للنسخ
هكذا تبدو زيارة منتهية كما يتوقعها Rumore. طابِق حقول نظام حجوزاتك مع هذه الأسماء. المطلوب فقط name وvisitAt وبريد إلكتروني أو رقم هاتف.
{
"name": "Dana Levi",
"email": "dana@example.com",
"phone": "+4520123456",
"visitAt": "2026-10-05T19:30:00+02:00",
"endAt": "2026-10-05T21:00:00+02:00",
"externalId": "booking-1042",
"status": "completed"
}تحقّق من الرابط من الطرفية
للتحقق من الرابط والمفتاح السري قبل بناء أي شيء، الصق هذا في الطرفية وضع رابط الحجوزات والمفتاح السري الخاصين بك مكان الكلمات المكتوبة بأحرف كبيرة. الزيارة في المثال قديمة منذ أشهر، لذا يرد Rumore بـ too_old ولا يُطلب من أحد شيء. لكن Test Guest سيظهر في جهات الاتصال.
curl -X POST "YOUR_BOOKING_LINK" \
-H "Authorization: Bearer YOUR_SECRET" \
-H "Content-Type: application/json" \
-d '{"name":"Test Guest","email":"test@example.com","visitAt":"2026-01-15T12:00:00Z","durationMinutes":60,"externalId":"rumore-test-1"}'ماذا يحدث عند وصول زيارة
- يُرسل الطلب إلى الضيف بعد 3 ساعات من انتهاء الزيارة، ضمن ساعات الإرسال لديك. وإن ضبطت تأخيرًا خاصًا بك في Rumore، فهو المعتمد.
- من طلب منك ألا تتواصل معه لا يتلقى طلبًا أبدًا، ولا يتلقى أحد طلبًا جديدًا بعد وقت قصير جدًا من طلبه السابق.
- الزيارة المرسلة بالحالة cancelled أو no_show تُحفظ، ولا يُطلب من أحد شيء. أرسل الـ externalId نفسه مرة أخرى بالحالة الجديدة فيتوقف أي طلب ما زال ينتظر.
- لا يقرأ Rumore أبدًا حقول الموافقة أو التسويق من نظام حجوزاتك، فلا داعي لإرسالها.
بماذا يرد Rumore
يعرض Zapier وMake هذا الرد في سجل كل تشغيل. وهو أول مكان تنظر فيه إن لم تصل الزيارات.
202 acceptedوصلت الزيارة. إن كانت مؤهلة، يتلقى الضيف الطلب بعد 3 ساعات من انتهائها.202 duplicateكانت هذه الزيارة نفسها لدى Rumore من قبل، فلم يتغير شيء.202 too_oldحُفظت في سجل الضيف. انتهت الزيارة قبل أكثر من 7 أيام، فلا يُطلب من أحد شيء.401المفتاح السري خاطئ، أو رابط الحجوزات معطّل.422هناك حقل ناقص أو تتعذر قراءته. يذكر الرد أي حقل هو.429زيارات كثيرة جدًا في وقت قصير. انتظر دقيقة ثم أرسلها مرة أخرى.