ودجت Reqdesk
ودجت دعم ثنائي اللغة قابل للتضمين. سكربت واحد، يشير إلى مساحة عملك، يفتح محادثة تذكرة حقيقية. يدعم العربية والمظاهر، ومُثبَّت على CDN.
التثبيت
<script async src="https://cdn.reqdesk.support/widget/latest/index.iife.js"></script>
<script>
window.addEventListener('load', () => {
window.ReqdeskWidget.init({
apiKey: 'your-project-api-key',
apiUrl: 'https://api.reqdesk.support',
language: document.documentElement.lang || 'ar',
})
})
</script>
ودجت Reqdesk أسرع طريقة لمنح المستخدم النهائي مدخلًا إلى مساحة دعمك. سكربت واحد، بلا إطارات. يُرسم الودجت داخل الصفحة المضيفة، ويلتقط مظهرها، ويعكس الاتجاه مع dir، ويفتح تذكرة حقيقية عند الإرسال — لا نموذج “سنردّ لاحقًا”.
الإعدادات
ينكشف بناء IIFE على window.ReqdeskWidget. تشغّله بـ init(...):
| الحقل | إلزامي | الوصف |
|---|---|---|
apiKey | نعم | مفتاح API الصادر من المنصّة، محصور بالمشروع الذي يكتب فيه الودجت. |
apiUrl | لا | عنوان الـ API. الافتراضي window.location.origin — يُحدَّد صراحةً عند التضمين على موقع طرف ثالث. |
language | لا | en أو ar. الافتراضي يتبع <html lang> للصفحة المضيفة. |
theme | لا | كائن تجاوز للمظهر (ألوان، انحناءات). يرث الافتراضي إن أُهمل. |
customer | لا | بيانات مستخدم معروف مسبقًا ({ email, name, externalId }). |
position | لا | موضع الزرّ (bottom-end، bottom-start، …). |
display | لا | نمط العرض (sheet، dialog، inline). |
واجهة برمجية
بعد عودة init()، يكشف window.ReqdeskWidget:
ReqdeskWidget.open() // فتح الودجتReqdeskWidget.close() // إغلاق الودجتReqdeskWidget.toggle() // تبديل الحالةReqdeskWidget.setLanguage('ar') // تبديل اللغة في وقت التشغيلReqdeskWidget.setTheme({ /* … */ }) // تجاوز رموز المظهر في وقت التشغيل
ReqdeskWidget.identify({ // إرفاق بيانات المستخدم المعروف email: 'customer@example.com', name: 'اسم العميل',})
ReqdeskWidget.on('ticket-created', t => { /* … */ })ReqdeskWidget.destroy() // تفكيك كاملidentify() اختيارية — إن كان عميلك مصادقًا أصلًا على موقعك، فاستدعاء identify() يجنّبه إعادة إدخال بريده في الودجت.
الإصدارات والـ CDN
تُقدَّم الحُزَم من cdn.reqdesk.support/widget/<version>/index.iife.js بكاش لمدة سنة وثبات immutable. ثبّت إصدارًا محدّدًا حين تحتاج تجميد السطح؛ الاسم البديل latest يتحدّث عند كل إصدار. قائمة docker/reqdesk-cdn/retained-versions.txt هي السجلّ الرسمي لما يُقدَّم حاليًا.
ملاحظة: الإصداران 1.2.20 و1.2.21 يحملان بناء IIFE مكسور، ومستبعدان عن قصد من الـ CDN. على المواقع المثبّتة عليهما الترقية إلى 1.2.22 أو
latest.
CSP
إذا كان موقعك يستخدم Content-Security-Policy، اسمح بـ:
script-src https://cdn.reqdesk.support https://challenges.cloudflare.comconnect-src https://api.reqdesk.support https://challenges.cloudflare.comframe-src https://challenges.cloudflare.com
Cloudflare Turnstile لازم لمنع الإساءة الآلية لسطح إنشاء التذاكر العام.