نموذج الطلب
نموذج الطلب هو ما يُفتح عندما ينقر الزائر على إجراء طلب، مثل Reserve أو Schedule a Tour أو Request Pickup، على خريطة Kaleidr، أو على المراجعة والإرسال في طلب أعدّه Kaleidr AI. يرسل الطلب إلى صندوق الوارد في مؤسستك. ويُشرح إعداد الطلبات في طلبات الحجز.
أين يعمل
يعمل النموذج على مواقع Kaleidr الخاصة فقط. فهو ليس نصًا برمجيًا تضيفه إلى صفحتك. على موقعك، يُفتح داخل خريطة منشورة تضمّنها باستخدام <kaleidr-map product="viewer">: الـ viewer صفحة من Kaleidr داخل iframe، ويُفتح النموذج فوق خريطتها. ويعمل أيضًا في Kaleidr Studio، وفي Kaleidr Map ما دامت تعرض الخريطة الأساسية الخاصة بـ Kaleidr.
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer" share-id="YOUR_MAP_ID" layout="guide"
style="display:block; height:640px"></kaleidr-map>
- لا شيء تضيفه إلى Content Security Policy الخاصة بك. يُحمَّل النموذج والتحقق البشري الخاص به داخل iframe الخاص بالـ viewer، لذا لا تحتاج صفحتك إلا إلى إدخالات
script-srcوframe-srcالخاصة بالـ viewer نفسه. - يُحمَّل عند النقرة الأولى. الخريطة التي لا يفتح زوارها النموذج أبدًا لا تحمّله أبدًا.
- لا يظهر الزر إلا للأماكن التي تقبل الطلبات. وتُحدَّد هذه الأماكن في Studio وKaleidr Booking؛ راجع تفعيل الطلبات.
ما يراه الزائر
- النموذج، وعنوانه تسمية الإجراء: حقول المجموعة الجاهزة كما أعدّتها مؤسستك، والاسم، والبريد الإلكتروني، وهاتف اختياري، ورسالة، وسطر الموافقة الذي يتضمن اسم نشاطك التجاري ورابط سياسة الخصوصية.
- إرسال الطلب، ويُفعَّل بمجرد ملء الحقول المطلوبة وتحديد مربع الموافقة. يبدأ المربع غير محدد. ويجتاز الزائر غير المسجّل الدخول إلى Kaleidr تحققًا بشريًا قصيرًا.
- تم إرسال الطلب، مع المرجع، مثل
K-7XQ2MD، ورسالة بأننا أرسلنا نسخة إلى بريد الزائر الإلكتروني عندما ترسل مؤسستك إيصالات.
لا يملأ النموذج أي شيء عن الزائر. والطلب الذي أعدّه Kaleidr AI لا يتضمن إلا ما قاله الزائر، مثل تاريخ وعدد أشخاص، ويراجعه الزائر قبل الإرسال.
| يرى الزائر | متى |
|---|---|
| "هذا المكان لا يستقبل الطلبات عبر الإنترنت." | الطلبات متوقفة للمكان أو لمؤسستك. |
| العبارة نفسها، مع هاتف المكان أو رابطه | بلغت مؤسستك حد الطلبات الشهري. |
| جملة بجانب الحقل | حقل مطلوب فارغ أو إجابة خارج النطاق. |
تتبع تسميات النموذج لغة الخريطة، بالإنجليزية والإسبانية والفرنسية والألمانية والبرتغالية واليابانية والكورية والصينية المبسطة والتقليدية والعربية. وتُعرض أسئلتك وتسمياتك الخاصة كما كتبتها.
الأحداث
يبلّغ النموذج صفحة Kaleidr التي تحتويه، لا صفحتك:
| الحدث | متى |
|---|---|
ready | عُرض النموذج. |
resize | تغيّر ارتفاعه. |
submitted | قُبل الطلب، مع مرجعه. |
error | رُفض الطلب، مع رمز خطأ. |
close | أغلق الزائر النموذج. |
لا تتلقى صفحتك أيًّا منها. لا ينشر الـ viewer أي رسالة عامة عند إرسال طلب، والرسائل من iframe غير ready وerror ليست عقدًا عامًا. للتصرف في طلب، استخدم صندوق الوارد أو webhook، الذي يصل إلى أنظمتك الخاصة بالطلب كاملًا.
عندما يكون Kaleidr Analytics مفعّلًا على الخريطة المنشورة، يُحتسب الطلب المرسَل تحويلًا لتلك الخريطة. لا يحمل التحويل إلا نوع الطلب، ولا يحمل أبدًا بيانات الزائر.
التنسيق
يُرسم النموذج داخل shadow root خاص به، ويأخذ ألوانه وخطه واستدارة زواياه من الخريطة التي يُفتح عليها، في الوضعين الفاتح والداكن. ولا يصل إليه CSS صفحتك: فهو داخل iframe الخاص بالـ viewer.
هذه خصائص CSS المخصصة التي يُنسَ ّق بها النموذج، وقيمها الافتراضية. وتضبطها صفحات Kaleidr من مظهر الخريطة.
| الخاصية | الافتراضي | ما تنسّقه |
|---|---|---|
--kbw-font | inherit | الخط. |
--kbw-fg | #111 | النص. |
--kbw-bg | #fff | الخلفية. |
--kbw-muted | #6b7280 | التلميحات والنص الثانوي. |
--kbw-border | #d1d5db | حدود الحقول. |
--kbw-accent | #2da84a | زر الإرسال وحلقة التركيز. |
--kbw-accent-fg | #fff | النص على زر الإرسال. |
--kbw-danger | #b91c1c | جمل الأخطاء. |
--kbw-radius | 10px | نصف قطر الزوايا. |
--kbw-space | 8px | وحدة التباعد. |