كل ما تحتاج إلى معرفته
دليل شامل لبناء وإدارة مكاتب الاستقبال الذكية الخاصة بك باستخدام shamz.ai
البدء
سجّل، أكمل خطوات الإعداد، اختر مهارتك الأولى، ثم أضف الويدجت إلى موقعك. معظم العملاء ينطلقون من الصفر إلى استقبال ذكي مباشر خلال أقل من 30 دقيقة.
- بريد إلكتروني (نستخدم Auth0؛ لا حاجة لبطاقة ائتمان للتجربة المجانية لمدة 30 يوماً)
1.1أنشئ حسابك
افتح shamz.ai واضغط "ابدأ التجربة المجانية". يجمع معالج الإعداد المكوّن من 7 خطوات تفاصيل شركتك (الاسم، الموقع، القطاع)، الدولة والعملة، اسم ومُعرّف أول روبوت محادثة، خطتك، أول مهارة، وساعات العمل. نطلب فقط بريداً إلكترونياً وتسجّل الدخول عبر Auth0 في النهاية.
1.2اختر مهارتك الأولى
اختر واحدة من: المواعيد، خدمة العملاء، قاعدة المعرفة، إدارة العملاء المحتملين، أو التجارة الإلكترونية. يمكنك إضافة مهارات أخرى لاحقاً من لوحة التحكم → المهارات. الاختيار يحدد بشكل أساسي أي معالج إعداد سيشغّل بعد ذلك.
1.3اضبط المهارة
يرشدك معالج المهارة عبر كل ما يخصها — الخدمات والموظفين للمواعيد، الفئات واتفاقيات SLA لخدمة العملاء، إلخ. راجع القسم المخصص لكل مهارة أدناه.
1.4اختبر في معاينة لوحة التحكم
افتح لوحة التحكم → روبوتات المحادثة → الروبوت الخاص بك → معاينة. أرسل بضع رسائل اختبارية لتأكد من أن رسالة الترحيب والاقتراحات والتدفقات الأساسية تعمل كما تتوقع.
1.5أضف الويدجت إلى موقعك
من لوحة التحكم → روبوتات المحادثة → التضمين، انسخ مقتطف <script> والصقه قبل </body> في موقعك. أضف نطاق الإنتاج إلى قائمة النطاقات المسموح بها (الويدجت يرفض التحميل على نطاقات غير مدرجة).
1.6اربط القنوات (اختياري ولكن موصى به)
اربط واتساب بيزنس و/أو Instagram Direct ليتمكن العملاء من الوصول إلى نفس الاستقبال الذكي من تطبيقات المراسلة. راجع أقسام واتساب وإنستغرام أدناه.
- إذا كان المُعرّف مستخدماً، يقترح المعالج بدائل في الوقت الفعلي.
- اختيار الدولة يضبط المنطقة الزمنية تلقائياً — يمكنك تغييرها لاحقاً من الإعدادات → الحساب.
مهارة المواعيد
تتيح للعملاء حجز المواعيد وإعادة جدولتها وإلغائها عبر الدردشة أو واتساب. مثالية للعيادات وصالونات التجميل وورش السيارات وأي عمل تكون وحدة الحجز فيه قطعة زمنية.
- مهارة مواعيد نشطة (تُنشأ خلال الإعداد أو من لوحة التحكم → المهارات → إضافة)
- خدمة واحدة على الأقل وموظف واحد على الأقل
2.1حدّد خدماتك
اذهب إلى لوحة التحكم → المهارات → مهارة المواعيد → الخدمات. أنشئ إدخالاً لكل نوع موعد بالاسم والمدة بالدقائق وفترة الفصل الاختيارية والسعر والعملة الاختياريين. أضف الاسم بالعربية (name_ar) ليعرضها الروبوت في المحادثات العربية.
2.2أضف الفروع (اختياري)
إذا كان لديك أكثر من فرع، أضف كل واحد كموقع بالعنوان والهاتف. سيُسأل العملاء عن اختيار الفرع أثناء الحجز.
2.3أضف الموظفين
في تبويب الموظفين، أضف كل شخص يستطيع استقبال الحجوزات. مطلوب: الاسم والبريد الإلكتروني. اختياري: التخصصات والصورة والخدمات التي يقدمها. بدون موظف نشط واحد على الأقل لن يُرجع تدفق الحجز أي مواعيد متاحة.
2.4اضبط جداول العمل
لكل موظف، حدّد الجدول الأسبوعي: ساعات العمل لكل يوم، فترات الراحة، وأي إجازات. الجداول تحدد توفر المواعيد — إذا طلب عميل الاثنين الساعة 3 مساءً، نبحث عن الموظف المتاح في ذلك الوقت.
2.5اضبط حقول الاستقبال (اختياري)
أضف الحقول المخصصة التي يجمعها الروبوت عند الحجز — رقم المريض، رقم التأمين، لوحة المركبة، إلخ. تُخزَّن مع الموعد وتظهر لفريقك.
2.6اربط تقويماً (اختياري)
ضمن مزامنة التقويم، اربط تقويم Google أو Outlook لتُزامن المواعيد المؤكدة في الاتجاهين. الإلغاءات وإعادة الجدولة في أي نظام تنتقل تلقائياً.
2.7فعّل تأكيدات وتذكيرات واتساب
إذا كان واتساب مربوطاً، فعّل خيارات تأكيدات المواعيد وتذكيرات المواعيد في تبويب واتساب. سيرسل الروبوت رسالة تأكيد معتمدة من Meta عند الحجز وتذكيراً قبل الموعد.
- يجب أن تغطي ساعات العمل مدة خدمة كاملة على الأقل وإلا سيقول الروبوت "لا توجد مواعيد متاحة".
- دقائق الفصل (مثلاً 15 دقيقة بين تنظيفات الأسنان) تمنع الحجز المتلاحق — اضبطها على كل خدمة، لا على جدول الموظف.
مهارة خدمة العملاء
تلتقط تذاكر الدعم عبر الدردشة، تصنفها حسب الفئة والأولوية، تتابع SLA، وتوجهها إلى الفريق المناسب. مثالية لمكاتب دعم تقنية المعلومات، التدبير المنزلي للفنادق، طلبات خدمة المستشفيات، وأي تدفق دعم بعد البيع.
- مهارة خدمة عملاء نشطة
- فئة واحدة على الأقل ومجموعة وكلاء واحدة على الأقل
3.1أنشئ فئات الخدمة
لوحة التحكم → المهارات → مهارة خدمة العملاء → الفئات. أضف فئة لكل نوع تذكرة — الفواتير، التقنية، الإرجاع، التدبير المنزلي، الصيانة، إلخ. الفئات تحدد التصنيف والتوجيه.
3.2أضف خدمات لكل فئة
كل فئة تحتوي خدمة أو أكثر بـ SLA خاص بها (وقت الاستجابة ووقت الحل بالساعات، الأولوية الافتراضية). مثال: "حساب مغلق" تحت التقنية → استجابة 30 دقيقة / حل ساعتان / أولوية عالية.
3.3اضبط مجموعات الوكلاء
ضمن مجموعات الوكلاء، أنشئ فرقاً (المستوى الأول، المستوى الثاني، المناوب، إلخ.) وعيّن أعضاء الفريق. يمكن ربط كل مجموعة بفئات محددة لتوجيه التذاكر تلقائياً.
3.4اضبط حقول الاستقبال
حدد ما يجب أن يجمعه الروبوت قبل فتح تذكرة — رقم الطلب، رقم الغرفة، معرف الأصل، مرفق. ضع الحقول المطلوبة كإلزامية حتى لا تُنشأ التذكرة بفجوات.
3.5اضبط ساعات العمل والتصعيد
ضمن ساعات العمل، حدد متى يكون الفريق متصلاً. يتوقف SLA خارج ساعات العمل. أضف مسار تصعيد ليُعلَّم تلقائياً أي تذكرة معرضة لخرق SLA إلى مدير.
3.6فعّل تحديثات تذاكر واتساب
في تبويب واتساب، فعّل تحديثات حالة التذاكر. يحصل العملاء على رسالة معتمدة من Meta كلما تغيرت حالة تذكرتهم (تم الإنشاء → قيد المعالجة → تم الحل).
3.7تحقق في صندوق الوارد
أرسل طلباً اختبارياً عبر الويدجت، ثم افتح لوحة التحكم → صندوق الوارد → التذاكر. يجب أن تظهر التذكرة الجديدة بالفئة والأولوية الصحيحة ومؤقت SLA.
- لا تفرط في التصنيف منذ اليوم الأول. ثلاث إلى خمس فئات تكفي عادة؛ يمكنك تقسيمها لاحقاً عند ظهور أنماط.
- إذا استمر الروبوت في التوجيه الخاطئ للتذاكر، تأكد أن وصف كل فئة يقدم سياقاً كافياً للذكاء الاصطناعي (جملة أو جملتان واضحتان).
مهارة قاعدة المعرفة
تجيب على الأسئلة المتكررة من محتواك الخاص — أسئلة شائعة يدوية، مستندات مرفوعة، وصفحات مواقع تم استخراجها. مثالية لأسئلة المنتج وأسئلة السياسات وأي سؤال "يُسأل دائماً".
- مهارة قاعدة معرفة نشطة
- واحد على الأقل من: إدخال أسئلة شائعة، مستند مرفوع، أو رابط موقع يمكننا استخراجه
4.1أضف أسئلة شائعة يدوياً
لوحة التحكم → المهارات → مهارة قاعدة المعرفة → الأسئلة الشائعة. أضف أزواج سؤال/جواب حسب الفئة. السؤال والجواب يمكن أن يكونا بالعربية والإنجليزية؛ يختار الروبوت لغة العميل وقت التشغيل.
4.2ارفع المستندات
ضمن الرفع والاستخراج، اسحب ملفات PDF أو Word أو نصية. نقطّعها ونحوّلها إلى متجهات ونستخدمها مصادر إجابة مع استشهادات. كل مقطع يعرض عداد "استُخدم N مرة" لترى ما يُقرأ فعلاً.
4.3استخرج موقعك
الصق رابط موقعك. يتبع الزاحف الروابط الداخلية (نفس النطاق فقط) ويفهرس الصفحات. يبث التقدم مباشرة في لوحة التحكم؛ المواقع الكبيرة تستغرق بضع دقائق.
4.4راجع الأسئلة بدون إجابة
عندما لا يستطيع الروبوت الإجابة بثقة، يُسجَّل السؤال تلقائياً ضمن الأسئلة بدون إجابة مع عداد "مرات السؤال". راجع القائمة أسبوعياً — الفجوات الأكثر تكراراً هي التي تُسد أولاً.
4.5استخدم "صياغة بالذكاء الاصطناعي"
على أي سؤال بدون إجابة، اضغط "صياغة بالذكاء الاصطناعي" لتوليد إجابة مرشحة بناءً على أسئلتك ومستنداتك فقط. حرّر ووافق قبل النشر — لا شيء يُنشر تلقائياً، عمداً.
4.6اختبر في المعاينة
اطرح بعض الأسئلة في معاينة الروبوت. تأكد أن الإجابات تستشهد بالمصدر الصحيح وأن اللغة تطابق السؤال.
- الإجابات المصاغة بالذكاء الاصطناعي لا تستخدم معرفة خارجية أبداً — تركّب فقط من مصادرك، مما يجعلها آمنة للقطاعات المنظّمة.
- أعد استخراج موقعك بشكل دوري (كل بضعة أسابيع) لالتقاط صفحات السياسة الجديدة وتحديثات المنتج.
مهارة إدارة العملاء المحتملين
تلتقط العملاء المحتملين من الدردشة، تسجلهم، تعينهم لمندوب، وتنبّه الفريق. مثالية لفرق المبيعات التي تتلقى استفسارات عبر موقعها أو قنواتها الاجتماعية.
- مهارة إدارة عملاء محتملين نشطة
- عضو فريق واحد على الأقل بدور Owner أو Admin أو Manager أو Rep و"استقبال العملاء المحتملين" مفعّل
5.1حدّد حقول الالتقاط
لوحة التحكم → المهارات → مهارة إدارة العملاء → التقاط العملاء. اختر الحقول التي يجب على الروبوت جمعها (الاسم، البريد، الهاتف، الشركة) وأيها اختياري. يطلبها الروبوت بطبيعية أثناء المحادثة.
5.2اضبط قواعد التسجيل
ضمن قواعد التسجيل، حدد كيف يصبح العميل ساخن/دافئ/بارد بناءً على السمات (مثلاً الدولة = الإمارات +10، قيمة الصفقة > 5000 +50، حجم الشركة > 100 +30) والسلوك (ذكر "عرض توضيحي"، رفع مستنداً).
5.3اختر وضع التعيين
التوزيع الدوار يوزع العملاء بالتساوي على المندوبين المؤهلين. اليدوي يترك owner_user_id فارغاً لتعيّن أنت. التوزيع الدوار هو الافتراضي الموصى به لأي فريق فيه مندوبان أو أكثر.
5.4اضبط SLA
حدد سرعة المتابعة — العملاء الساخنون عادة 15 دقيقة، الدافئون 60 دقيقة، الباردون 240 دقيقة. ينشئ الروبوت مهمة بتاريخ استحقاق مطابق ويظهرها في قائمة المندوب.
5.5اربط الإشعارات
يُرسَل البريد الإلكتروني دائماً عند التعيين. لإرسال إشعار واتساب أيضاً، اضبط whatsapp_phone للمندوب من الإعدادات → الفريق وفعّل "تعيين عميل محتمل جديد" في تبويب واتساب. أول تفعيل يُجهّز قالب Meta تلقائياً.
5.6أرسل إلى CRM (اختياري)
اربط Zoho أو HubSpot من التكاملات. تتزامن العملاء المؤهلون كجهات اتصال/عملاء في CRM مع كامل سياق المحادثة والمصدر والتقييم.
5.7تحقق بعميل اختباري
أرسل استفساراً اختبارياً عبر الويدجت. تحقق من لوحة التحكم → العملاء — يجب أن يظهر العميل الجديد مع owner_user_id مضبوط، تصنيف مرئي، ومهمة مُنشأة بتاريخ استحقاق صحيح.
- إذا لم يتم تعيين عميل تلقائياً، فالسبب الأكثر شيوعاً أنه لا يوجد عضو فريق بـ "استقبال العملاء المحتملين" مفعّل. تحقق من الإعدادات → الفريق.
- قوالب واتساب تحتاج موافقة Meta (عادة دقائق إلى ساعات). حتى الموافقة، يُتجاوَز إرسال واتساب بصمت ويُرسَل البريد فقط.
مهارة التجارة الإلكترونية
تربط متجرك، تتيح للروبوت البحث عن المنتجات وتتبع الطلبات واستعادة السلات المهجورة. مثالية لأي تاجر على Shopify أو Salla أو WooCommerce أو Zid أو Magento.
- مهارة تجارة إلكترونية نشطة
- صلاحيات مدير على متجرك
6.1اختر منصتك
في خطوة المتجر، اختر Shopify أو Salla أو WooCommerce أو Zid أو Magento. Shopify و Salla يستخدمان OAuth (تثبيت بنقرة واحدة)؛ WooCommerce و Zid و Magento تستخدم مفاتيح API تنشئها في إدارة متجرك. راجع قسم "اربط متجرك" أدناه للخطوات الخاصة بكل منصة.
6.2اربط المتجر
اتبع تدفق الربط الخاص بالمنصة. بمجرد الربط، نزامن كتالوج منتجاتك (الاسم، السعر، المخزون، الصور، المتغيرات). الكتالوجات الكبيرة (10 آلاف+ منتج) تستغرق بضع دقائق للمزامنة الأولية.
6.3اضبط الكتالوج
ضمن الكتالوج، اختر ما يمكن للروبوت عرضه: الأسعار، شارات المخزون، ترتيب الفرز (الأكثر شعبية / الأحدث / السعر). أخفِ الفئات التي لا تريد إظهارها في الدردشة.
6.4فعّل دعم الطلبات
ضمن الطلبات والإرجاع، فعّل تتبع الطلبات والإرجاع. يستطيع العملاء أن يسألوا "أين طلبي؟" ويبحث الروبوت بالبريد ورقم الطلب، مع الحالة ورابط التتبع والوقت المقدر للوصول.
6.5فعّل ميزات التفاعل
استعادة السلة وتنبيهات إعادة التوفر وطلبات التقييم مغلقة افتراضياً (لأنها قوالب تسويقية تفوترها Meta). فعّلها واحدة تلو الأخرى عند الجاهزية، ووافق على قوالب Meta التي تُجهَّز تلقائياً.
6.6اختبر البحث عن المنتجات
في المعاينة، اسأل عن منتج أو فئة محددة. تأكد أن الروبوت يُرجع نتائج مع الصور والأسعار وروابط "أضف للسلة" أو "عرض في المتجر".
- إذا لم تظهر صور المنتجات، تحقق أن متجرك يضبط og:image / الصورة الرئيسية — نستخدم صورة المنتج الافتراضية للمنصة.
- استعادة السلة تتطلب أن يكون العميل قد بدأ المحادثة في آخر 24 ساعة أو أنه اشترك عبر قالب تسويقي. تفرض Meta هذا.
اربط واتساب
يوجّه رسائل واتساب من رقم عملك إلى نفس الاستقبال الذكي الذي يشغّل ويدجت موقعك. مساران: التسجيل المضمَّن (موصى به، حوالي 5 دقائق) أو يدوي.
- حساب Meta Business بصلاحية WhatsApp Business API
- دور مدير على حساب Meta Business
- رقم هاتف غير مسجّل حالياً على واتساب الشخصي
7.1افتح تبويب واتساب
لوحة التحكم → الإعدادات → واتساب. ستظهر خياران: "الربط عبر Facebook" (التسجيل المضمَّن) و"الربط يدوياً".
7.2شغّل التسجيل المضمَّن (موصى به)
اضغط "الربط عبر Facebook". تفتح نافذة Meta منبثقة ترشدك لاختيار أو إنشاء حساب Meta Business، حساب WhatsApp Business (WABA)، ورقم الهاتف المراد استخدامه. تحقق من الرقم برسالة SMS أو مكالمة. نُبادل رمز OAuth مقابل access_token و phone_number_id و waba_id تلقائياً.
7.3أو الربط يدوياً
إذا كان لديك بيانات API مباشرة، اضغط "الربط يدوياً" والصق access_token (طويل الأمد) و phone_number_id و waba_id. يُشفَّر الرمز عند التخزين. مفيد عندما يدير فريق تقنية المعلومات لديك Meta Business Manager مباشرة.
7.4اضبط webhook في Meta (المسار اليدوي فقط)
إذا استخدمت المسار اليدوي، انسخ رابط webhook ورمز التحقق من تبويب واتساب إلى إعدادات webhook لـ WABA في Meta Business Manager. التسجيل المضمَّن يفعل هذا نيابةً عنك.
7.5فعّل الإشعارات الصادرة
ضمن الإشعارات الصادرة، فعّل ما تحتاجه: تأكيدات المواعيد، تذكيرات المواعيد، تحديثات حالة التذاكر، تعيين عميل محتمل، استعادة السلة، تنبيهات إعادة التوفر، طلبات التقييم. كل تفعيل يُجهّز قالب Meta المقابل تلقائياً.
7.6انتظر موافقة Meta على القوالب
تبدأ القوالب بحالة PENDING وتنتقل إلى APPROVED خلال 1-24 ساعة (أحياناً دقائق). حتى الموافقة، تُتجاوَز عمليات الإرسال الخارجة لذلك القالب بصمت — يُرسَل بريد تعيين العميل ولا يتعطل المندوبون.
7.7أرسل رسالة اختبارية
من واتساب الشخصي، أرسل رسالة إلى رقم عملك. يجب أن يرد الاستقبال الذكي خلال ثوانٍ. اختبر بالعربية والإنجليزية للتأكد من اكتشاف اللغة.
- الأرقام المسجلة على واتساب الشخصي يجب إلغاء تسجيلها قبل استخدامها لـ Business API. خطّط لذلك — هي فترة تهدئة 24 ساعة على Meta.
- القوالب التسويقية (استعادة السلة، تنبيهات إعادة التوفر، طلبات التقييم) تكلف نحو 0.03–0.15 دولار لكل محادثة، تفوترها Meta مباشرة على وسيلة دفع WABA. القوالب الخدمية عادة 0.01–0.05 دولار.
اربط Instagram Direct
يوجّه رسائل Instagram المباشرة إلى استقبالك الذكي. الردود تخرج من حسابك التجاري؛ الروبوت يستطيع أيضاً التعرف على ذكر القصص ووسوم المنتجات.
- حساب Instagram Business (ليس شخصي أو Creator)
- حساب Instagram مرتبط بصفحة Facebook تديرها
8.1افتح تبويب إنستغرام
لوحة التحكم → الإعدادات → إنستغرام. ستظهر "الربط عبر Facebook" (تسجيل دخول الأعمال) و"الربط يدوياً".
8.2شغّل تسجيل دخول الأعمال
اضغط "الربط عبر Facebook". تطلب نافذة Meta منك منح الوصول إلى حساب Instagram Business وصفحة Facebook المرتبطة. نُبادل رمز OAuth مقابل معرّف مستخدم Instagram ورمز وصول طويل الأمد للصفحة.
8.3أو الربط يدوياً
الصق رمز وصول الصفحة (طويل الأمد) ومعرّف الصفحة. يمكنك توليدهما من Meta Business Manager ضمن إعدادات الأعمال → الحسابات → الصفحات → أدوات الرموز.
8.4تحقق من webhook
التسجيل المضمَّن يضبط webhook نيابةً عنك. للإعدادات اليدوية، انسخ رابط webhook ورمز التحقق إلى إعدادات webhook الخاصة بـ Messenger / Instagram للصفحة في Meta.
8.5فعّل ميزات DM
في تبويب إنستغرام، فعّل ما تحتاجه: الرد التلقائي على DM، الرد التلقائي على ذكر القصص، التقاط العملاء من DM، مزامنة المحتوى (ليعرف الروبوت آخر منشوراتك ووسوم المنتجات).
8.6أرسل DM اختباري
من حساب Instagram شخصي، أرسل DM إلى ملفك التجاري. يجب أن يرد الروبوت خلال ثوانٍ. الرد التلقائي على القصص يعمل عند ذكر حسابك في قصة.
- رموز وصول الصفحة تنتهي إذا غيّر حساب Facebook الخاص بك كلمة المرور أو إعدادات المصادقة الثنائية. نحدّث استباقياً، لكن إذا فشل التسليم فجأة، الرمز هو أول ما يجب فحصه.
- إنستغرام لديه نافذة خدمة عملاء 24 ساعة — بمجرد أن يراسلك العميل، يمكنك الرد بحرية لمدة 24 ساعة. خارج النافذة، فقط وسوم الرسائل (HUMAN_AGENT, ACCOUNT_UPDATE) مسموحة.
اربط متجرك
خطوات خاصة بكل منصة لربط Shopify أو Salla أو WooCommerce أو Zid أو Magento. مهارة التجارة الإلكترونية تختار واحدة منها كمصدر بيانات.
9.1Shopify (OAuth)
اختر Shopify في المعالج وأدخل رابط متجرك (mystore.myshopify.com). يفتح OAuth في نافذة منبثقة ويطلب الموافقة على صلاحيات المنتجات والطلبات والمخزون. بعد الموافقة، تُعاد توجيهك ونزامن كتالوجك. الشرط المسبق: صلاحيات مدير Shopify.
9.2Salla (OAuth)
اختر Salla واتبع تدفق تثبيت متجر التطبيقات. إذا دخلت عبر متجر تطبيقات Salla، يكون الموقع والمهارة مختارَين سلفاً لك. التثبيتات المباشرة (الخاصة) تستخدم نفس تدفق OAuth بنوع تطبيق خاص. الشرط المسبق: حساب تاجر Salla.
9.3WooCommerce (مفاتيح REST API)
اختر WooCommerce. في إدارة WordPress، اذهب إلى WooCommerce → الإعدادات → متقدم → REST API → إضافة مفتاح. اضبط الصلاحيات على Read/Write. انسخ consumer_key و consumer_secret (يُعرض السر مرة واحدة فقط). الصقهما مع رابط المتجر في المعالج.
9.4Zid (رمز وصول + معرّف متجر)
اختر Zid. في لوحة تحكم تاجر Zid، اذهب إلى التطبيقات → API. انسخ رمز الوصول ومعرّف المتجر. الصقهما في المعالج مع رابط المتجر.
9.5Magento (رمز وصول)
اختر Magento. في إدارة Magento، اذهب إلى النظام → الإضافات → التكاملات → إضافة. اضبط نطاق وصول المورد ليشمل الكتالوج والمبيعات. فعّل، انسخ رمز الوصول. الصقه في المعالج مع رابط المتجر.
9.6تحقق من الربط
بعد حفظ بيانات الاعتماد، يشغّل المعالج اختبار اتصال ويعرض اسم متجرك وعدد المنتجات. إذا فشل الاختبار، تحقق من بيانات الاعتماد وأن مستخدم API لديه صلاحية قراءة المنتجات والطلبات.
- بالنسبة لـ WooCommerce، يُعرض consumer_secret مرة واحدة فقط أثناء توليد المفتاح. إذا لم تنسخه، ستحتاج لحذف المفتاح وإنشاء واحد جديد.
- إلغاء تثبيت تطبيق Shopify أو Salla يُلغي رمز OAuth فوراً — ستحتاج لإعادة الربط من لوحة التحكم.
أضف الويدجت إلى موقعك
ويدجت الدردشة وسم <script> واحد يُحمَّل على أي صفحة HTML. هو نفس الويدجت الذي يشغّل صفحات shamz.ai/chat/* المستقلة — لذا السلوك متطابق بين الوضعين.
- روبوت محادثة نشط
- صلاحية تعديل HTML / قالب موقعك
10.1انسخ مقتطف التضمين
لوحة التحكم → روبوتات المحادثة → الروبوت → التضمين. انسخ وسم <script src="https://widget.shamz.ai/v1/shamz-widget.js"></script> مع كتلة ShamzWidget.init({...}). يُملأ chatbotId لك.
10.2الصق قبل </body>
أضف المقتطف على كل صفحة تريد أن يظهر فيها الويدجت، قبل وسم </body> الختامي مباشرة. معظم أنظمة CMS لديها قسم HTML مخصص / Footer لهذا — يحمّل المقتطف نحو 30 كيلوبايت بشكل غير متزامن، فلن يعطّل تحميل صفحتك.
10.3أضف نطاقك إلى النطاقات المسموح بها
ضمن التضمين → النطاقات المسموح بها، أضف النطاق الذي سيعمل عليه الويدجت (مثلاً example.com). يرفض الويدجت التحميل على نطاقات غير مدرجة، مما يمنع موقعاً آخر من انتحال شخصيتك. أضف النطاقات الفرعية ونطاقات الاختبار أيضاً عند الحاجة.
10.4خصّص الفقاعة
ضمن إعدادات الفقاعة، اضبط الموضع (أسفل-يمين أو أسفل-يسار)، الحجم، اللون، وسلوك الفتح التلقائي. الفتح التلقائي يعرض تلميحاً صغيراً على الجوال ويفتح الدردشة مباشرة على سطح المكتب. يمكنك أيضاً تمرير language: 'ar' (أو رمز لغة آخر) عند init لفرض لغة محددة.
10.5اختبر في الإنتاج
افتح موقعك في تبويب متصفح جديد. يجب أن تظهر الفقاعة في الزاوية السفلية؛ النقر يفتح الدردشة. افتح وحدة تحكم المتصفح — لا يجب أن تكون هناك أخطاء من widget.shamz.ai.
- إذا لم يظهر الويدجت، السبب الأكثر شيوعاً هو نطاق غير مضاف إلى النطاقات المسموح بها. افتح وحدة تحكم المتصفح — نسجّل خطأ "Domain not authorized" واضحاً.
- لمواقع React/Next.js، يمكنك أيضاً استخدام <Script src="..." strategy="afterInteractive" /> بدلاً من <script> العادي. كلاهما يعمل.
العلامة التجارية والتخصيص
اضبط الويدجت ليطابق هويتك البصرية — الألوان، الشعار، رسالة الترحيب، اللغة، وحقول استقبال العميل التي يجمعها الروبوت.
11.1حرّر العلامة
لوحة التحكم → روبوتات المحادثة → الروبوت → العلامة. اضبط اللون الأساسي والثانوي، خلفية الترويسة، الخط، وارفع شعارك. تتحدث المعاينة المباشرة فور تعديل القيم.
11.2خصّص رسالة الترحيب
ضمن الترحيب، اضبط أول رسالة من الروبوت بالعربية والإنجليزية (welcome_message و welcome_message_ar). استخدمها لضبط التوقعات: ساعات العمل، ما يستطيع/لا يستطيع الروبوت، ولمن يلجأ في الطوارئ.
11.3اختر اللغة الأساسية للروبوت
اضبط اللغة الافتراضية للروبوت. الويدجت يستطيع تجاوزها عند init (?lang=hi إلخ). يمكن ضبط اللهجة العربية من الإعدادات → الحساب → لهجة روبوت العربية (الفصحى، السعودية، الإماراتية، المصرية، إلخ.).
11.4أضف حقول استقبال مخصصة
تحت كل مهارة، أضف الحقول التي يجب أن يجمعها الروبوت من العملاء — البطاقة المدنية، لوحة المركبة، رقم الغرفة، تفاصيل التأمين. لكل حقل اسم، نوع (نص / بريد / هاتف / اختيار)، وعلامة الإلزامية.
11.5فعّل استبيان ما قبل/ما بعد الدردشة
ضمن الإعدادات → سلوك الدردشة، حدد ما إذا كنت تعرض استبياناً قبل الدردشة (الاسم + البريد قبل بدء المحادثة) ومراجعة بعد الدردشة (تقييم 1-5 + تعليق حر بعد انتهاء المحادثة).
- رسالة الترحيب تظهر أيضاً كـ og:description على صفحات shamz.ai/chat المستقلة — اجعلها جذابة.
- حقول الاستقبال المخصصة تُخزَّن على سجل العميل وتُعاد استخدامها عبر المحادثات، فتجمعها مرة واحدة فقط.
الذكاء الاصطناعي للصوت والصورة والمستندات
يقبل الويدجت الرسائل الصوتية والصور ومرفقات المستندات على كل قناة — الويب، واتساب، إنستغرام. نحن نُحوّل، ونقرأ بصرياً، ونستخرج الحقول المهيكلة تلقائياً.
12.1تحويل الصوت (Whisper)
يضغط العملاء على الميكروفون في الويدجت ويسجلون. نحوّل بـ Azure OpenAI's gpt-4o-mini-transcribe (من فئة Whisper) ونمرّر النص إلى المحادثة العادية. يعمل بالعربية (وباللهجات) والإنجليزية واللغات المدعومة الأخرى.
12.2رفع الصور
يستطيع العملاء إسقاط صور JPG أو PNG أو HEIC. الروبوت يستطيع التعرف على المنتجات (للتجارة الإلكترونية)، أنواع المستندات (الهوية، بطاقة التأمين، الإيصال)، والمشاهد (لخدمة العملاء — "صورة لمكيف معطل").
12.3OCR للمستندات (Mistral Document AI)
تُعالَج ملفات PDF متعددة الصفحات بـ Mistral Document AI. نستخرج الحقول المهيكلة — الأسماء، أرقام الهوية، التواريخ، المبالغ — بالعربية والإنجليزية، ونملأ نموذج استقبال الموعد/التذكرة/العميل تلقائياً حتى لا يضطر العميل لإعادة الكتابة.
12.4اضبط ما يُقبَل
ضمن الإعدادات → سلوك الدردشة، يمكنك تعطيل رفع الملفات كلياً أو تقييدها بأنواع محددة. مفيد للقطاعات المنظَّمة التي يجب فيها تمرير بعض الرفعات عبر قناة أخرى.
- تظهر ثقة OCR في لوحة التحكم لكل حقل مستخرج — أي شيء أقل من 80% يُعلَّم لمراجعة بشرية قبل التعبئة التلقائية.
- كلاهما (الصوت و OCR) يُحسَب من ميزانية المحادثات الشهرية لخطتك، لكن كلٌ بمضاعف مختلف — راجع الإعدادات → الاستخدام للتفاصيل.
التحليلات والتقارير
تابع المحادثات، تحويل العملاء المحتملين، SLA التذاكر، والاستخدام. لكل مهارة تبويب لوحة تحكم خاص.
13.1تحليلات المحادثات
لوحة التحكم → التحليلات → المحادثات. اعرض إجمالي المحادثات عبر الزمن، ساعات الذروة، أعلى النوايا (حجز، دعم، تصفح)، وتوزيع اللغات. مفيد لقرارات التوظيف وفجوات المحتوى.
13.2تحليلات العملاء المحتملين
لوحة التحكم → التحليلات → العملاء. تابع حجم العملاء حسب المصدر (دردشة، واتساب، إنستغرام، يدوي)، معدل التحويل (محتمل ← مكسوب)، توزيع التقييم (ساخن/دافئ/بارد)، وأداء المندوبين (وقت الاستجابة، التحويل لكل مندوب).
13.3تحليلات خدمة العملاء
لوحة التحكم → التحليلات → التذاكر. أداء SLA (نسبة الاستجابة والحل في الوقت)، الحجم حسب الفئة، معدل التصعيد، ومتوسط وقت الحل.
13.4تحليلات التجارة الإلكترونية
لوحة التحكم → التحليلات → التجارة. معدل استعادة السلة، أعلى المنتجات بحثاً، حجم الإرجاع، وعزو المبيعات المُحرَّك بالذكاء الاصطناعي (محادثات أدت إلى إتمام شراء).
13.5استخدام الخطة
لوحة التحكم → الاستخدام. عدد المحادثات مقابل حد الخطة، دقائق الصوت، صفحات OCR، رسائل واتساب حسب نوع القالب. اضبط تنبيهات لتُعلَم قبل بلوغ الحد.
- تحترم كل الرسوم البيانية نطاق التواريخ — استخدمه لمقارنة أسبوع حملة بالأسبوع السابق.
- صدّر أي رسم بياني كـ CSV من قائمة … — مفيد للتقارير الشهرية لفريقك.
هل تحتاج إلى مساعدة إضافية؟
لا تجد ما تبحث عنه؟ فريق الدعم لدينا هنا للمساعدة.