طلبات الحجز

يمكن لزائر إحدى خرائطك المنشورة أن يرسل إلى نشاطك التجاري طلبًا بشأن مكان عليها: حجز في منشأة، أو جولة في عقار، أو موعد في متجر، أو استلام عند محطة. يصل الطلب إلى صندوق الوارد في مؤسستك في Kaleidr Booking على booking.kaleidr.com، وبالبريد الإلكتروني إن اخترت ذلك، وإلى أنظمتك الخاصة عبر webhooks. وتردّ عليه من صندوق الوارد.

الطلب طلب وليس حجزًا مؤكدًا. لا يُحجز شيء ولا يُحتفظ به ولا يُدفع ثمنه: يؤكده نشاطك التجاري بالبريد الإلكتروني أو كما يفعل عادةً.

تفعيل الطلبات

1. في Kaleidr Booking، افتح الإعدادات، عام وفعّل استقبال الطلبات. ما دام متوقفًا، لا يستطيع أي زائر إرسال طلب إلى مؤسستك، ولا تظهر أزرار الطلب.
2. في Kaleidr Studio، أضف إجراء طلب إلى مجموعة: افتح المجموعة، ثم البطاقة وعوامل التصفية، إجراءات المكان، وأضف طلب. تسميته هي الزر الذي يراه الزوار؛ ولكل مجموعة جاهزة تسميتها الافتراضية:

نوع المجموعة	التسمية الافتراضية	ما يطلبه الزائر
المتاجر	Request an Appointment	موعد أو استلام أو إجابة عن سؤال
العقارات المعروضة	Schedule a Tour	جولة حضورية أو بالفيديو، أو مزيد من المعلومات
المنشآت	Reserve	حجز أو إجابة عن سؤال
المحطات	Request Pickup	استلام أو طلب مسبق أو إشعار

3. انشر خريطة تعرض المجموعة. عندها تحمل بطاقات الأماكن فيها وتخطيطات الأماكن والأماكن الواردة في إجابات Ask Kaleidr الزر.

• إجراء طلب واحد لكل مجموعة. إضافته تفعّل الطلبات لكل أماكن المجموعة. تبدأ مجموعة المنشآت الجديدة بـ Reserve، ومجموعة المحطات الجديدة بـ Request Pickup.
• مجموعات المركبات والمجموعات المخصصة لا تقبل الطلبات.
• الأماكن في الدردشة. يتيح إعداد الطلبات للخريطة في Studio، قبول الطلبات لأي مكان، للزوار أيضًا إرسال طلب بشأن مكان يذكره Kaleidr AI في إجاباته، مثل مطعم قرب فندقك. وهو متوقف افتراضيًا. يحدد هذا الطلب المكان باسمه وعنوانه. ولا يحمل موقعًا على الخريطة إلا إذا وُجد العنوان في بيانات العناوين الخاصة بـ Kaleidr.
• يمكن لـ Kaleidr AI ملء النموذج، لكنه لا يرسله أبدًا. عندما يُطلب منه "احجز طاولة لأربعة في السابعة"، تُعدّ لوحة Ask Kaleidr النموذج بما قاله الزائر وتعرض المراجعة والإرسال. يراجعه الزائر ويضيف بياناته ويرسله. لا يرى Kaleidr AI أبدًا اسم الزائر أو بريده الإلكتروني أو هاتفه.

النموذج

يرى الزائر النموذج فوق الخريطة: حقول المجموعة الجاهزة للمجموعة، واسمه وبريده الإلكتروني وهاتفًا اختياريًا، ورسالة، وسطر الموافقة. يبقى إرسال الطلب معطّلًا حتى تُملأ الحقول المطلوبة ويُحدَّد مربع الموافقة. بعد الإرسال يرى الزائر تم إرسال الطلب ومرجعًا مثل K-7XQ2MD. وللنموذج نفسه، راجع نموذج الطلب.

في Kaleidr Booking، تضم الإعدادات، نماذج الطلبات علامة تبويب لكل مجموعة جاهزة. لكل حقل تختار ما إذا كان يُعرض، وما إذا كان مطلوبًا، وتسميته، ويمكنك إضافة ما يصل إلى خمسة أسئلة خاصة بك. وتعرض المعاينة المجاورة النموذج كما سيراه الزوار.

المجموعة الجاهزة	الحقول القياسية
المتاجر	الغرض من الطلب، التاريخ، الفترة من اليوم، الأصناف
العقارات المعروضة	الغرض من الطلب، جولة حضورية أو بالفيديو، حتى ثلاثة تواريخ، الفترة من اليوم، التمويل
المنشآت	الغرض من الطلب، التاريخ، الوقت، عدد الأشخاص (1 إلى 50)، عدد الليالي (1 إلى 60)
المحطات	الغرض من الطلب، نقطة الاستلام، الوجهة، التاريخ، الوقت، عدد الأشخاص (1 إلى 20)، الأصناف

نقطة الاستلام والوجهة نص يكتبه الزائر. في التخطيط المباشر، تضيف مجموعة المحطات التي يتيح إجراء الطلب فيها للزوار اختيارهما النقطتين، اللتين يُعثر عليهما بالبحث عن عنوان أو بالنقر على الخريطة. وهما ما اختاره الزائر لتتصرف بناءً عليه.

الروبوتات. يجتاز الزائر غير المسجّل الدخول إلى Kaleidr تحققًا بشريًا قصيرًا قبل إرسال الطلب.

صندوق الوارد

الطلبات في Kaleidr Booking لوحة بأعمدة جديد ومقبول ومكتمل ومرفوض. اسحب بطاقة لتغيير حالتها، أو استخدم قائمة نقل إلى الخاصة بها. يعرض إظهار الطلبات المزعجة الطلبات المحددة كمزعجة. صفِّ حسب الخريطة والمكان والمجموعة الجاهزة والتاريخ، أو ابحث بالمرجع أو الاسم أو البريد الإلكتروني أو المكان.

افتح طلبًا لترى بيانات الزائر وإجاباته، والموافقة التي أعطاها، والمكان على خريطة، وسجل الطلب. ومن هناك:

الإجراء	ما يفعله
قبول، رفض، تحديد كمكتمل، تحديد كمزعج، إعادة فتح	يغيّر الحالة. يمكن قبول الطلب الجديد أو رفضه أو تحديده كمزعج؛ ويمكن تحديد الطلب المقبول كمكتمل أو رفضه؛ ويمكن إعادة فتح الطلب المرفوض أو المزعج. المكتمل نهائي.
الرد	يرسل ردك إلى الزائر بالبريد الإلكتروني. ويصل جوابه إلى عنوان بريدك الإلكتروني.
إضافة ملاحظة	ملاحظة لفريقك فقط. لا تُرسل أبدًا.
إسناد إلى	يسند الطلب إلى عضو في مؤسستك.
محو بيانات مقدّم الطلب	يحذف كل الطلبات من عنوان البريد الإلكتروني ذلك في مؤسستك. راجع الاحتفاظ والمحو.

من يستطيع ماذا يتبع أدوار مؤسستك: يمكن للمالكين والمسؤولين والأعضاء والمشاهدين قراءة الطلبات؛ ويمكن للمالكين والمسؤولين والأعضاء تغييرها والرد عليها وإسنادها؛ ويدير المالكون والمسؤولون الإعدادات والنماذج وwebhooks والإشعارات، ويحذفون الطلبات ويمحونها ويصدّرونها بصيغة CSV.

البريد الإلكتروني. ضمن الإعدادات، الإشعارات، يرسل إرسال الطلبات الجديدة بالبريد الإلكتروني رسالة إلى الأعضاء المفعّلين ضمن الفريق عند وصول طلب. تذكر الرسالة المكان ونوع الطلب وترتبط به؛ ولا تحمل أيًّا من بيانات الزائر. ويرسل إرسال إيصالات إلى الزائر نسخة تتضمن المرجع.

الطلبات التجريبية. يُوسم الطلب الذي ترسله بنفسك من Studio بـ تجريبي، ولا يُحتسب ضمن حد خطتك.

الموافقة

يقول سطر الموافقة في النموذج: "أوافق على أن يستخدم نشاطك التجاري هذه البيانات للرد على طلبي. تعالجها Kaleidr نيابةً عن نشاطك التجاري."، مع اسم نشاطك التجاري مكان نشاطك التجاري: وهو اسم النشاط التجاري ضمن الإعدادات، عام، وإلا فاسم مؤسستك. اضبط رابط سياسة الخصوصية على عنوان https:// لسياستك الخاصة، فيرتبط السطر بها. يبدأ المربع غير محدد، ويُرفض الطلب بدونه. ويحتفظ كل طلب بإصدار السطر الذي وافق عليه الزائر ووقت الموافقة.

الاحتفاظ والمحو

• يحذف مدة الاحتفاظ بالطلبات الطلب بعد تلك المدة دون نشاط: 365 يومًا ما لم تغيّرها، من 30 إلى 730 يومًا. ويُحذف الطلب المحدد كمزعج بعد 30 يومًا.
• يحذف محو بيانات مقدّم الطلب كل طلبات عنوان بريد إلكتروني واحد في مؤسستك، مع الرسائل المرسلة بشأنها. استخدمه عندما يطلب منك شخص حذف بياناته.
• حذف طلب يحذفه مع الرسائل المرسلة بشأنه.
• عندما يحذف شخص حسابه في Kaleidr، تُحذف طلباته في كل المؤسسات.
• عندما تُحذف مؤسستك، تُحذف طلباتها معها.

Webhooks

يرسل webhook كل حدث طلب إلى عنوان تملكه فور وقوعه، ليتصرف بناءً عليه نظام حجوزاتك أو نظام إدارة علاقات العملاء أو أتمتة جداول البيانات لديك. أضف واحدًا في Kaleidr Booking ضمن الإعدادات، Webhooks. تتوفر webhooks في خطتي Pro وEnterprise.

• يجب أن يكون العنوان https على المنفذ 443، وأن يكون كل عنوان يُحَل إليه اسمه عامًا. يُرفض أي منفذ آخر أو عنوان خاص عند الحفظ ومرة أخرى عند كل إرسال.
• يُعرض السر مرة واحدة، عند إضافة webhook. يُصدر تدوير المفتاح السري سرًا جديدًا؛ ويستمر القديم في التوقيع 24 ساعة لتتمكن من الانتقال.
• يرسل إرسال اختبار حدث webhook.test.

الحدث	يُرسل عندما
request.created	يرسل زائر طلبًا.
request.status_changed	تتغير حالة طلب. يحمل data.from_status الحالة السابقة.
request.replied	يرد شخص ما على الزائر. يحمل data.reply القيمة { body, created_at }.
webhook.test	تختار إرسال اختبار.

كل إرسال هو POST بنص JSON وهذه الترويسات:

الترويسة	القيمة
Kaleidr-Signature	t=<unix seconds>,v1=<hex HMAC-SHA256(secret, "<t>.<raw body>")>
Kaleidr-Event-Id	معرّف الحدث، وهو نفسه في كل إعادة محاولة. استخدمه لتجاهل التكرار.
Kaleidr-Event-Type	الحدث، كما في الجدول أعلاه.
Kaleidr-Delivery-Attempt	من 1 إلى 7.

{
  "id": "8a1c2b9e-0000-4000-8000-000000000001",
  "type": "request.created",
  "api_version": "2026-10-22",
  "created_at": "2026-10-22T15:04:05Z",
  "org_id": "…",
  "data": {
    "request": {
      "id": "…",
      "ref": "K-7XQ2MD",
      "kit": "venues",
      "status": "new",
      "place": { "name": "Sample Venue", "line": "…", "lat": 40.7411, "lng": -73.9897 },
      "requester": { "name": "…", "email": "…", "phone": null, "locale": "en", "signed_in": false },
      "fields": { "kind": "reservation", "date": "2026-10-30", "time": "19:00", "party_size": 4 },
      "message": "…"
    }
  }
}

الطلب الخاص بمكان في الدردشة لم يُعثر على عنوانه في بيانات العناوين الخاصة بـ Kaleidr يحمل place.lat وplace.lng بقيمة null.

التحقق من التوقيع

تحقق من النص الخام قبل تحليله، وارفض أي طابع زمني أقدم من خمس دقائق. أثناء التدوير تحمل الترويسة v1= ثانية موقّعة بالسر السابق؛ اقبل أيًّا منهما.

import hashlib, hmac, time

def verify(header: str, secret: str, body: bytes, tolerance: int = 300) -> bool:
    parts = [p.split("=", 1) for p in header.split(",")]
    t = next((v for k, v in parts if k == "t"), "")
    if not t.isdigit() or abs(time.time() - int(t)) > tolerance:
        return False
    expected = hmac.new(secret.encode(), f"{t}.".encode() + body, hashlib.sha256).hexdigest()
    return any(k == "v1" and hmac.compare_digest(v, expected) for k, v in parts)

اختبر شيفرتك بهذا المتجه:

المُدخل	القيمة
السر	whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw
t	1761091200
النص	{"id":"8a1c2b9e-0000-4000-8000-000000000001","type":"webhook.test"}
v1	3e55a2f93ac990282b95fd9140f8290ffaddc5d41969831e4234b164d613bd72

الإرسال وإعادة المحاولة

• أجب بأي حالة 2xx خلال 10 ثوانٍ. لا تُتبع عمليات إعادة التوجيه.
• مرة واحدة على الأقل. يُعاد الإرسال الفاشل بعد دقيقة و5 دقائق و30 دقيقة وساعتين و6 ساعات و24 ساعة: سبع محاولات خلال نحو 32 ساعة. قد يصل الحدث نفسه مرتين؛ تجاهل أي Kaleidr-Event-Id سبق أن رأيته.
• النص هو الطلب كما هو عند الإرسال، لذا تحمل إعادة المحاولة أحدث حالة له. ولا يُرسل طلب مُحي في الأثناء.
• عشر عمليات إرسال متتالية تفشل كل محاولاتها توقف webhook. وتفعيله من جديد يعيد ضبط العدّ.
• تعرض عمليات الإرسال ضمن كل webhook محاولات آخر 30 يومًا مع حالتها ورمز الاستجابة والمدة، دون النصوص. ويعيد إعادة المحاولة إرسال العملية الفاشلة.

الحدود

الحد	Free	Pro	Enterprise
الطلبات شهريًا	50	1,000	يُحدد في اتفاقيتك
Webhooks	لا شيء	5	يُحدد في اتفاقيتك

الشهر هو فترة الفوترة لمؤسستك. لا تُحتسب الطلبات التجريبية. عند بلوغ الحد تُرفض الطلبات الجديدة حتى الفترة التالية، ويعرض النموذج بدلًا من ذلك هاتف المكان أو رابطه إن وُجد.

ذات صلة

• نموذج الطلب
• مكتبة الأماكن
• مرجع Viewer: تخطيطات الأماكن
• التتبع المباشر