تضمين أداة الحجز في موقعك الإلكتروني

آخر تحديث: 22 سبتمبر 2026التكاملات

يتيح لك الإعدادات ← التكاملات أن يحجز الزوار معك مباشرةً من موقعك الإلكتروني عبر أداة حجز مضمَّنة، بدلاً من توجيههم إلى هنا.

1. اسمح بنطاقك

في النطاقات المسموح بها، أدخل الأصل الدقيق للموقع الذي سيستضيف أداة الحجز، أي البروتوكول والمضيف فقط، بلا مسار وبلا شرطة مائلة في النهاية:

https://apply.acme.com     ✓
https://acme.com:8443      ✓
acme.com                   ✗  البروتوكول ناقص
https://acme.com/book      ✗  يحتوي على مسار
https://acme.com/          ✗  شرطة مائلة في النهاية

https://www.acme.com وhttps://acme.com أصلان مختلفان. إن كان بإمكان الزوار الوصول إلى موقعك بالطريقتين فأضفهما معًا.

هذه القائمة هي أيضًا مفتاح التشغيل والإيقاف: ما دامت فارغة لا يمكن تضمين أداة الحجز في أي مكان. يمكنك إضافة حتى 50 نطاقًا، وإزالة أي نطاق تسري فورًا.

2. الصق الشيفرة

لكل خدمة معتمدة شيفرة خاصة بها. انسخها والصقها في صفحتك حيث تريد ظهور أداة الحجز:

<div class="scheduling-embed" data-service="SERVICE_ID"></div>
<script src="https://embed.example.com/embed.js" async></script>

يحدّد <div> موضع الأداة؛ أما وسم script فيمكن وضعه في أي مكان من الصفحة ويكفي مرة واحدة حتى مع وجود عدة أدوات حجز. وإن ظهرت لك عبارة لا توجد خدمات معتمدة للتضمين بعد، فالخدمة ما زالت قيد المراجعة، وستظهر شيفرتها فور اعتمادها.

3. اضبط اللغة

يتحكم لغة الأداة في هذه الصفحة بما يراه الزوار. اتركه على مطابقة لغة الصفحة فتقرأ أداة الحجز الخاصية lang من وسم <html> في صفحتك، وهي الخاصية نفسها التي تعتمد عليها محركات البحث وقارئات الشاشة، فلا يحتاج الموقع المترجم جيدًا إلى أي إعداد إضافي:

<!doctype html>
<html lang="es">      <!-- تظهر أداة الحجز بالإسبانية -->
  <head>…</head>
  <body>…</body>
</html>

الرموز الإقليمية مدعومة: تُختزل lang="pt-BR" إلى أقرب لغة ندعمها بدلاً من رفضها.

لتجاوز لغة الصفحة في أداة حجز بعينها، أضف data-locale إلى div التضمين. فهي تتقدّم على لغة الصفحة وعلى الإعداد في هذه الصفحة معًا:

<div class="scheduling-embed" data-service="SERVICE_ID" data-locale="de"></div>

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

window.SchedulerEmbed.setLocale("sr");

باختصار، يفوز أول ما يكون مضبوطًا مما يلي: data-locale، ثم <html lang> في صفحتك، ثم لغة الأداة، ثم متصفح الزائر، ثم الإنجليزية.

خيارات أخرى

أضِف هذه إلى div التضمين:

data-mode="popup" يعرض زرًا يفتح أداة الحجز في نافذة منبثقة بدلاً من إدراجها ضمن الصفحة.

data-label="احجز الآن" يحدد نص الزر في الوضع المنبثق.

data-min-height="480" يحدد الارتفاع بالبكسل قبل أن تُبلغ أداة الحجز عن حجمها الحقيقي. زِده إن لاحظت قفزة عند التحميل.

وهناك استدعاءان إضافيان إن كان موقعك يُدرج المحتوى ديناميكيًا أو يتتبّع التحويلات:

// أعد فحص الصفحة بعد إضافة div لأداة الحجز
window.SchedulerEmbed.refresh();

// يُستدعى عندما يُكمل الزائر حجزًا
window.SchedulerEmbed.onBooking(function (e) {
  console.log(e.bookingId, e.serviceId);
});

إذا لم تظهر أداة الحجز

أصل الصفحة غير مدرج في قائمة النطاقات المسموح بها، أو لا يطابقها تمامًا. يكفي http بدل https، أو غياب www، لمنعها.

وُضعت الشيفرة في موضع لا يمكن تشغيل النص البرمجي فيه، مثل كتلة نص عادي أو HTML مقيَّد في منشئ المواقع لديك.

جرى تعديل قيمة data-service. الصق الشيفرة كما هي بدلاً من إعادة كتابة المعرّف.

أُلغي نشر الخدمة أو لم تعد معتمدة.