دردشة الموقع

تضع دردشة الموقع فقاعة دردشة في متجرك أو موقعك. تصل الرسائل إلى صندوق الوارد في راقي بجانب قنواتك الأخرى، ويجيب عليها فريقك أو وكيل AI.

إنشاء الدردشة

يستغرق الإعداد دقائق قليلة:

• 1. افتح القنوات، وابحث عن بطاقة دردشة الموقع واضغط ربط.
• 2. اكتب اسماً للقناة، ثم حدد العنوان والعنوان الفرعي ورسالة الترحيب واسم الوكيل ولغة الودجت واللون والموضع. يمكنك تغييرها كلها لاحقاً.
• 3. املأ المواقع المسموح بها إن أردت (التفاصيل أدناه).
• 4. اضغط إنشاء دردشة الموقع. تعرض الشاشة التالية كود التثبيت.

التثبيت على موقعك

كود التثبيت سطر واحد. اضغط نسخ والصقه في موقعك مرة واحدة، متبعاً خطوات منصتك تحت على أي منصة بُني موقعك؟:

• Shopify: من لوحة إدارة Shopify افتح Online Store ثم Themes. بجانب القالب الحالي اضغط زر النقاط الثلاث واختر Edit code. افتح الملف layout/theme.liquid والصق الكود قبل </body> مباشرة، ثم اضغط Save. تفضّل عدم تعديل الكود؟ من محرر القالب أضف قسم Custom liquid إلى التذييل والصق الكود فيه، ثم احفظ.
• Salla وZid: من لوحة تحكم متجرك ابحث عن المكان الذي يتيح إضافة كود مخصص لكل صفحات المتجر، والصق الكود في منطقة جسم الصفحة أو التذييل، ثم احفظ التغييرات. وإذا لم تجد هذا الإعداد يمكن لدعم Salla أو Zid إرشادك إلى مكان إضافة الكود المخصص.
• WooCommerce (WordPress): من لوحة تحكم WordPress افتح الإضافات (Plugins) ثم أضف جديدة (Add New)، وثبّت إضافة لأكواد الترويسة والتذييل. افتح إعداداتها والصق الكود في قسم التذييل (Body)، ثم احفظ.
• Wix: من لوحة تحكم Wix افتح Settings ثم Custom code، واضغط Add custom code. الصق الكود، واختر All pages، وحدد موضعه Body - end، ثم اضغط Apply. وتتطلب الأكواد المخصصة في Wix خطة Premium ونطاقاً مربوطاً بالموقع.
• HTML: الصق الكود قبل </body> مباشرة في كل صفحة من موقعك، أو مرة واحدة في قالب التذييل المشترك، ثم انشر التغييرات.

المواقع المسموح بها

تحدد المواقع المسموح بها أين تعمل الدردشة، فلا يعمل كودك إذا نسخه أحد إلى موقع آخر:

• اترك الحقل فارغاً لتعمل الدردشة على أي موقع.
• أضف مواقعك، كل موقع في سطر، مثل shop.com. ويشمل كل إدخال نطاقاته الفرعية، فـ shop.com يسمح بـ www.shop.com وcheckout.shop.com.
• يمكنك لصق العنوان كاملاً، ويحتفظ راقي بالنطاق فقط. والنطاقات العربية مقبولة أيضاً.
• أضف 20 موقعاً كحد أقصى.

إعدادات الدردشة

اضغط إدارة على دردشة الموقع لتغيير إعداداتها، ثم اضغط حفظ:

التحقق من الهوية

عندما يكون المتسوق مسجلاً دخوله في متجرك، يربطه التحقق من الهوية بجهة الاتصال الخاصة به في راقي، فيعرف فريقك ووكيل AI من يحادثهم. يوقّع خادمك معرّف المتسوق بـ مفتاح التحقق السري للدردشة (توقيع HMAC-SHA256 للمعرّف، مكتوباً بصيغة hex)، ويمرره إلى الدردشة باسم userHash. لا يقبل راقي إلا المعرّفات الموقّعة، وبدون توقيع صحيح تصل الرسالة كأي زائر آخر.

• من إدارة ابحث عن التحقق من الهوية واضغط عرض المفتاح. عرض المفتاح أول مرة ينشئه.
• أضف كود منصتك قبل كود التثبيت مباشرة. في النماذج أدناه ضع مفتاحك مكان YOUR_IDENTITY_SECRET، أما النماذج داخل التطبيق فتضيفه تلقائياً بعد عرضه.
• تنتقل محادثة المتسوق الموثَّق إلى جهة اتصاله الموجودة عندما يتطابق المعرّف أو البريد أو الهاتف. ولا تُدمج جهات الاتصال ولا تُحذف أبداً.

Shopify (Liquid)

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

{% if customer %}
<script>
  window.RaqiSettings = {
    user: {
      userId: "{{ customer.id }}",
      email: {{ customer.email | json }},
      name: {{ customer.name | json }},
      userHash: "{{ customer.id | hmac_sha256: 'YOUR_IDENTITY_SECRET' }}"
    }
  };
</script>
{% endif %}

Node.js

احسب userHash على خادمك، ثم اطبع RaqiSettings في الصفحة قبل سطر التثبيت:

const crypto = require('crypto');

// Keep the secret on your server, e.g. in an environment variable.
const RAQI_IDENTITY_SECRET = 'YOUR_IDENTITY_SECRET';

function raqiUserHash(userId) {
    return crypto.createHmac('sha256', RAQI_IDENTITY_SECRET).update(String(userId)).digest('hex');
}

// Print this in the page, before the install line, for a logged-in shopper:
// <script>window.RaqiSettings = { user: { userId: "42", email: "sara@example.com", name: "Sara", userHash: raqiUserHash(42) } };</script>

PHP

احسب userHash على خادمك، ثم اطبع RaqiSettings في الصفحة قبل سطر التثبيت:

<?php
// Keep the secret on your server, e.g. in an environment variable.
$raqiSecret = 'YOUR_IDENTITY_SECRET';
$userHash = hash_hmac('sha256', (string) $userId, $raqiSecret);
?>
<script>
  window.RaqiSettings = {
    user: {
      userId: <?= json_encode((string) $userId) ?>,
      email: <?= json_encode($userEmail) ?>,
      name: <?= json_encode($userName) ?>,
      userHash: <?= json_encode($userHash) ?>
    }
  };
</script>

سياق الصفحة لوكيل AI

مع كل رسالة تخبر الدردشة وكيل AI بالصفحة التي يتصفحها المتسوق، والمنتج الذي ينظر إليه، وسلته. يعمل ذلك تلقائياً على Shopify وSalla وZid والصفحات التي تحتوي على بيانات المنتجات.

• ما يُرسل: عنوان الصفحة (دون جزء الاستعلام)، وعنوانها ولغتها، والعملة، والمنتج (الاسم والسعر والعملة وSKU والرابط والصورة)، والسلة (عدد المنتجات والإجمالي والعملة).
• تُحفظ هذه الحقول فقط. يُتجاهل أي شيء آخر، ويجب أن تبدأ الروابط بـ http:// أو https://، وألا تكون الأرقام سالبة.
• السلة تُقرأ تلقائياً في Shopify، أما في المنصات الأخرى فحددها بنفسك كما في الكود أدناه.
• قيمك هي الأولى: ما تحدده أنت يتقدم على ما تجده الدردشة في الصفحة.

<script>
  window.RaqiSettings = window.RaqiSettings || {};
  window.RaqiSettings.context = {
    product: { name: "Oud oil 30 ml", price: 120, currency: "SAR", sku: "OUD-30" },
    cart: { itemCount: 2, total: 240, currency: "SAR" }
  };
</script>