إذا كان الزوار يسجّلون الدخول إلى موقعك، فيمكنك إخبار ماندو بهويتهم. فيعرف وكيلك أسماءهم وتفاصيلهم دون أن يسأل، وتُربط محادثاتهم بالشخص الصحيح.
عرّف زائراً
بعد أن تعرف صفحتك من سجّل الدخول، استدعِ:
MandoCS('identify', {
id: user.id,
email: user.email,
name: user.name,
phone: user.phone,
metadata: {
plan: user.plan,
company: user.company
}
});والمطلوب هو id فقط. وكل ما عداه اختياري، ويقبل metadata أي تفاصيل إضافية تريد أن يراها فريقك.
وتمنحك لوحة التحكم نسخة جاهزة من هذا في تبويب مستخدم مسجل الدخول في بطاقة التثبيت.
ضمّن عنوان البريد
وهذا أهم ما في هذه الصفحة.
تمرير id وحده مقبول، لكن سجل جهة الاتصال لا يُنشأ ولا يُربط إلا إذا مرّرت email أيضاً. فإن عرّفت بمعرّف فقط، لا يظهر أي خطأ ولا يبدو أن شيئاً معطوب، لكن الزائر لا يُربط أبداً بشخص في مساحة عملك.
لذلك إن بدا أن التعريف لا يفعل شيئاً، فتحقق أولاً من أنك ترسل بريداً.
امسح الهوية عند تسجيل الخروج
عندما يسجّل الزائر الخروج، استدعِ:
MandoCS('reset');وهذا يمسح الهوية المخزّنة ويبدأ محادثة جديدة، فلا تعود المحادثة السابقة متاحة من ذلك المتصفح. وهذا ما تريده على جهاز مشترك، ويستحق أن تعرفه قبل استدعائه في مواضع أخرى.
تحديث التفاصيل لاحقاً
لإضافة تفاصيل إضافية أو تغييرها بعد التعريف، استدعِ MandoCS('updateMetadata', { ... }). وهو يدمجها مع الموجود بدل استبداله.
ولا يعمل إلا بعد تعريف ناجح. فإن استُدعي قبله لا يفعل شيئاً ويسجّل تحذيراً في وحدة تحكم المتصفح.
إذا لم يعمل التعريف
هل ترسل بريداً؟ فبدونه لا تُربط أي جهة اتصال. وهذا هو الجواب المعتاد.
هل يوجد معرّف؟ فالمعرّف المفقود أو الفارغ يوقف الاستدعاء، وتذكر وحدة تحكم المتصفح ذلك.
هل بياناتك جاهزة؟ فاستدعاء التعريف بقيم لم تُحمَّل بعد لا يرسل شيئاً مفيداً. استدعِه بعد تحميل بيانات المستخدم.
واستدعاء التعريف مبكراً آمن بحد ذاته. فالسكربت يصفّ الاستدعاءات التي تتم قبل اكتمال تحميل الشات ويطبّقها عند جاهزيته، لذلك نادراً ما يكون التوقيت وحده هو المشكلة.
ما الذي يمكنك استدعاؤه أيضاً
يقبل الشات مجموعة صغيرة من الأوامر: identify وreset وupdateMetadata وopen وclose وtoggle. والصيغتان تعملان، فـMandoCS('open') وMandoCS.open() يفعلان الشيء نفسه.
ولا يوجد أمر لإرسال رسالة نيابة عن الزائر.
ملاحظة عن الثقة
يقبل ماندو التفاصيل التي ترسلها صفحتك كما هي. فأرسل تفاصيل الهوية فقط من الصفحات التي تحققت فيها أصلاً من تسجيل دخول الزائر، ولا ترسلها أبداً من صفحة يصلها أي أحد.
أسئلة شائعة
هل أفتح الشات من رابط؟
نعم. إضافة #mandochat إلى الرابط تفتحه، و#mandochat=your%20text تملأ مربع الرسالة أيضاً. ولا يُرسَل النص تلقائياً.
هل يحذف reset المحادثة؟
يبدأ محادثة جديدة. وتبقى المحادثة القديمة في صندوق الوارد.
هل هناك أحداث أستمع إليها؟
يشير الشات إلى جاهزيته، لكن لا توجد واجهة أحداث عامة.