بداية سريعة.
في أقل من خمس دقائق.

§ 01أنشئ مساحة العمل.

توجّه إلى لوحة التحكّم التجريبية على صفحة تسجيل الدخول. استخدم حساب المالك المُهيَّأ، أو في الإنتاج أنشئ مساحة عمل جديدة — اختر slug، يصبح ذلك نطاقك الفرعي (acme.livechattools.com).

عند أوّل تسجيل دخول، تصل إلى صندوق الوارد. لا توجد محادثات حقيقية بعد — هذا ما تصلحه الخطوة الثانية.

§ 02ضمّن الودجت.

الصق سكربت اللودر قبل وسم الإغلاق </body> . هذا كل شيء — لا مكوّن React لتعليقه، ولا plugin Vue لتسجيله.

<script>
  window.LivechattoolsConfig = { tenant: 'acme' };
</script>
<script src="https://cdn.livechattools.com/widget-loader.js" async defer></script>

استبدل acme بِـ slug مساحة العمل الخاصة بك. يَجلِب السكربت السمة الحيّة من مستأجرك — الألوان، النصوص، علم RTL، والصورة الرمزية — لذا تغييرات التصميم لا تتطلّب إعادة نشر لموقعك.

تحديد هويّة الزائر

إذا كان الزائر مسجّل دخوله إلى منتجك، سلِّم الودجت هويّته حتى تتمكّن من ربط محادثات EasyLiveChat بجدول مستخدميك:

window.LivechattoolsConfig = {
  tenant: 'acme',
  identify: {
    id:    'usr_28x91',          // your stable user id
    name:  'Mariam El-Sayed',
    email: 'mariam@example.com',
    locale: 'ar',
    attributes: {
      plan:        'pro',
      mrr_cents:   4900,
      signed_up:   '2024-11-04',
    },
  },
};

§ 03أرسل أوّل ردّ.

افتح موقعك في علامة تبويب أخرى للمتصفّح، انقر الفقاعة، واكتب "Hello world". تصل الرسالة إلى صندوق الوارد في لوحة التحكّم في الوقت الحقيقي عبر قناة Socket.IO — أقلّ من ثانية، دون احتياط polling.

اضغط ⌘↩ على أي ردّ وكيل لإرساله. يرى الزائر رسالتك تظهر مع نغمة خفيفة ونقطة حضور تتحوّل إلى "Typing…" بينما تكتب.

§ 04ادعُ فريقك.

من الإعدادات → الوكلاء, انقر دعوة، وأدخل بريدًا إلكترونيًا ودورًا. ترسل EasyLiveChat بريدًا إلكترونيًا برابط لاستخدام واحد؛ والنقر عليه يضبط كلمة المرور ويُسقط الوكيل الجديد مباشرة إلى صندوق الوارد. تفرض الأدوار ما يمكنهم رؤيته — يدير المالكون الفوترة، ويدير المسؤولون الوكلاء، ويردّ الوكلاء.

curl -X POST https://acme.livechattools.com/api/tenant/agents \
  -H "Authorization: Bearer $EASYLIVECHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "email":  "noor@acme.test",
        "name":   "Noor Al-Saadi",
        "role":   "ADMIN"
      }'

§ 05حدّد ساعات العمل.

خارج ساعات العمل يبدّل الودجت مساحة الكتابة بنموذج "خارج الدوام". لا تزال المحادثات تصل صندوقك — يتم وسمها offline لمتابعة نظيفة في صباح اليوم التالي. عيِّن نوافذ أيام الأسبوع ضمن الإعدادات → ساعات العمل، كلٌّ منها بتوقيت مستأجرك المحلي.

{
  "timezone": "Asia/Erbil",
  "schedule": {
    "sunday":    [{ "from": "09:00", "to": "18:00" }],
    "monday":    [{ "from": "09:00", "to": "18:00" }],
    "tuesday":   [{ "from": "09:00", "to": "18:00" }],
    "wednesday": [{ "from": "09:00", "to": "18:00" }],
    "thursday":  [{ "from": "09:00", "to": "18:00" }],
    "friday":    [],
    "saturday":  []
  },
  "offlineMessage": "We're back Sunday at 9. Leave a note — we will reply."
}

§ 06إلى أين تذهب لاحقًا.

• وصِّل WhatsApp Cloudتحقّق من رقمك، الصق الويب هوك، أرسل رسائل القوالب.→
• اشترك في الويب هوكس الصادرةادفع كل حدث محادثة إلى مستودع البيانات الخاص بك.→
• افتح مرجع APIابنِ تدفّقًا مدفوعًا بـ EasyLiveChat داخل برنامجك.→
• ترجم الودجت إلى لغتكقاموس JSON، تقسيم كود لكل لغة، RTL تلقائي.→