المطوّرون
خيارات كود التضمين
السمات التي يقرؤها سكربت دردشة الموقع، للمطوّرين الذين يضيفون الدردشة يدويًا.
هذه الصفحة للمطوّرين. يمكن لمعظم الناس نسخ الكود من القنوات ← دردشة الموقع دون تغييره. راجع التثبيت على موقعك.
كود التضمين
<script
src="https://chatzora.com/widget.js"
data-agent-id="YOUR_ASSISTANT_ID"
data-api-base="https://chatzora.com"
data-title="Your business name"
async
></script>ضعه قبل وسم الإغلاق </body> في كل صفحة تريد أن تظهر فيها الدردشة.
السمات
| السمة | مطلوبة | وظيفتها |
|---|---|---|
data-agent-id | نعم | المساعد الذي سيُحمَّل. بدونها لا يفعل السكربت شيئًا. |
data-api-base | لا | عنوان Chatzora الذي يتم الاتصال به. الافتراضي هو العنوان الذي حُمِّل منه السكربت. |
data-title | لا | نص الترويسة الذي يظهر قبل تحميل الإعدادات المحفوظة. |
data-color | لا | لون السمة الذي يظهر قبل تحميل الإعدادات المحفوظة، مثل #059669. |
data-welcome-message | لا | رسالة الترحيب التي تظهر قبل تحميل الإعدادات المحفوظة. |
data-launcher-text | لا | نص زر الدردشة الذي يظهر قبل تحميل الإعدادات المحفوظة. |
data-position | لا | left أو right، قبل تحميل الإعدادات المحفوظة. |
data-lead-capture | لا | true لعرض نموذج التواصل قبل تحميل الإعدادات المحفوظة. |
data-visitor-id | لا | معرّف ثابت خاص بك للزائر، مثل معرّف عميلك. إذا تركته فارغًا يُنشأ معرّف عشوائي ويُخزَّن في المتصفح. |
سمات المظهر مجرد قيم أولية. عند تحميل الدردشة تحل محلها الإعدادات المحفوظة في لوحة التحكم (الإعدادات ← نافذة الدردشة). غيّر المظهر من لوحة التحكم لا من الكود.
السلوك
- على الشاشات بعرض 480 بكسل أو أقل، تُفتح الدردشة بملء الشاشة. وعلى الشاشات الأكبر تُفتح كنافذة عائمة.
- تظهر الردود أثناء كتابتها إذا كان المتصفح يدعم ذلك. أما الردود التي تستخدم تكاملًا، مثل البحث عن منتج، فتصل دفعة واحدة.
- إذا حُدِّد المواقع المسموح لها بعرض الدردشة، فلن تعمل الدردشة إلا على هذه المصادر (origins) تحديدًا.
- إذا كانت دردشة الموقع متوقفة في لوحة التحكم، يزيل السكربت الدردشة من الصفحة.
Content Security Policy
إذا كان موقعك يستخدم Content Security Policy، فاسمح بـ script-src وconnect-src وframe-src لعنوان Chatzora الخاص بك (https://chatzora.com). صفحات الحجز تُفتح داخل إطار، لذا إذا كنت تستخدم روابط الحجز فاسمح أيضًا بمزوّد الجدولة لديك في frame-src.
صفحة الدردشة المستضافة
يمكنك الربط بصفحة الدردشة المستضافة أو تضمينها بدلًا من السكربت:
https://chatzora.com/widget?agentId=YOUR_ASSISTANT_ID