دردشة الضيوف، على موقعك الخاص.

1. 1

   أنشئ أداتك

   افتح تطبيق أداة الدردشة بالذكاء الاصطناعي في Prohost وحدّد الاسم والترحيب ونمط زر الإطلاق الذي سيراه زوّارك.

2. 2

   انسخ مقتطفك

   في قسم الإضافة إلى موقع آخر، انسخ المقتطف. يحمل بالفعل معرّف الأداة ومفتاح التضمين وإعدادات زر الإطلاق.

3. 3

   الصقه قبل وسم body الختامي

   أضفه إلى تذييل الموقع بالكامل أو منطقة الكود المخصص ثم انشر. يظهر زر الإطلاق في الزاوية عند تحميل الصفحة التالي.

<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  data-position="bottom-right"
  data-launcher-color="#4F46E5"
  data-launcher-icon="chat"
  data-sound="on"
  async></script>

استبدل WIDGET_ID وWIDGET_API_KEY بالقيم من إعدادات أداتك، أو انسخ ببساطة المقتطف الجاهز من التطبيق الذي يملأها لك. مفتاح التضمين عام ومحدود بتلك الأداة وحدها: لا يمنح أي وصول إلى حسابك. يخفي Prohost المفتاح بعد عرضه أول مرة، فاستخدم تدوير المفتاح إذا احتجت إلى مقتطف جديد قابل للنسخ.

<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  async></script>

يعمل مع معظم منشئي المواقع؛ فلدى Webflow وWordPress وSquarespace وWix جميعها مكان للكود المخصص في تذييل الموقع.

تعمل data-hide-mobile بالوجود فقط: أي قيمة، حتى السلسلة الفارغة، تفعّلها. وتُطابَق كل خاصية أخرى بقيمتها؛ ولا تستجيب data-sound تحديداً إلا للقيمة on الدقيقة بأحرف صغيرة.

• يجب أن يتفاعل الزائر مع الصفحة أولاً

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

• لا يصدر أبداً أثناء القراءة

  لا رنين عندما تكون اللوحة مفتوحة والتبويب في المقدمة؛ فالرد على الشاشة بالفعل. يصدر عندما تكون اللوحة مغلقة أو التبويب في الخلفية. وتتبع شارة غير المقروء قاعدة أضيق قليلاً: لا تظهر إلا عندما تكون اللوحة مغلقة.

• دفعة الردود رنين واحد

  تنتج عدة رسائل تصل معاً إشارة واحدة، لا إشارة لكل رسالة.

function wireUpWebchat() {
  window.ProhostWebchat.on('webchat_host_message', (event) => {
    console.log(event.type);
  });

  document.querySelector('#my-chat-button')?.addEventListener('click', () => {
    window.ProhostWebchat.open();
    // window.ProhostWebchat.close() collapses it again.
  });
}

if (window.ProhostWebchat) {
  wireUpWebchat();
} else {
  // src*= rather than src$= — the tag may carry a cache-busting query string.
  document
    .querySelector('script[src*="/webchat.js"]')
    ?.addEventListener('load', wireUpWebchat);
}

• webchat_session_startedالمحادثة موجودة الآن؛ أرسل الزائر رسالته الأولى. تحمل حمولته conversationId.
• webchat_message_sentأرسل الزائر رسالة.
• webchat_host_messageوصل رد من فريقك أو من ذكائك الاصطناعي. هذا ما يحرّك شارة غير المقروء، والرنين عند تفعيله.

مفيد مع data-hide-mobile: أخفِ زر الإطلاق الافتراضي على الهواتف وافتح اللوحة من زر خاص بك بدلاً منه. تُنقل الأحداث فقط عندما تأتي من تضمين Prohost، وليس من أي مصدر آخر.