دليل مرئي خطوة بخطوة

sem.chat الوثائق

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

لم يتم العثور على أدلة مطابقة. جرّب كلمة رئيسية أقصر مثل عنصر واجهة المستخدم، API، أو الصوت، أو الفوترة، أو خطاف الويب، أو WordPress، أو SendPulse، أو الجدولة.
ملاحظة لقطة الشاشة: تم التقاط كل صورة في هذا الدليل من تطبيق sem.chat الحقيقي باستخدام مساحة عمل تجريبية. يتم إخفاء تفاصيل الحساب وبيانات العملاء ومفاتيح API وتفاصيل الدفع ومحتوى المحادثات الخاصة قبل النشر.
01

البدء

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

/authالاشتراك والتجربة والبوت الأول
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1ابدأ بالتسجيل أو تسجيل الدخول من الموقع أو التطبيق العام.
2تحقق من عنوان البريد الإلكتروني قبل الاعتماد على الإشعارات أو رسائل الفواتير.
3استخدم الإعداد لإنشاء الروبوت الأول قبل فتح لوحة المعلومات.
/ نظرة عامةنظرة عامة بعد تسجيل الدخول
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1استخدم الإجراءات السريعة لإنشاء روبوت، أو عرض الروبوتات، أو فتح التحليلات، أو إدارة الفواتير.
2قم بمراجعة الروبوتات النشطة، conversations، والدقائق الصوتية، ومدى الرضا قبل إجراء التغييرات.
3تحقق من النشاط الأخير بعد كل اختبار للإعداد.
الإطلاق الأول

قم بالتسجيل، وابدأ النسخة التجريبية، وافهم لوحة التحكم

ما هذا من أجل: استخدم سير العمل هذا لمساحة عمل جديدة تمامًا أو عند تأهيل زميل في الفريق لم يستخدم sem.chat من قبل.

قبل أن تبدأ
  • استخدم بريدًا إلكترونيًا خاصًا بالعمل يمكنه تلقي رسائل البريد الإلكتروني الخاصة بالتحقق والفوترة.
  • حدد من يجب أن يمتلك مساحة العمل قبل دعوة بقية أعضاء الفريق.
  • احتفظ بموقع اختبار آمن أو صفحة مرحلية جاهزة لتثبيت الأداة.
1

افتح صفحة الاشتراك في التطبيق

انتقل إلى app.sem.chat/auth من زر تسجيل الدخول / الاشتراك في موقع الويب.

النتيجة المتوقعة: تعرض صفحة المصادقة خيارات تسجيل الدخول وإنشاء الحساب.
2

قم بإنشاء الحساب

أدخل البريد الإلكتروني للعمل، وأنشئ كلمة المرور، وأرسل نموذج التسجيل.

النتيجة المتوقعة: يطلب التطبيق التحقق أو ينتقل إلى الإعداد بعد قبول الحساب.
3

التحقق من البريد الإلكتروني

افتح رسالة التحقق الإلكترونية وانقر على رابط التأكيد.

النتيجة المتوقعة: يمكن للحساب تلقي رسائل الفواتير والدعوة والإبلاغ والتنبيه.
4

استكمال الإعداد

أدخل اسم النشاط التجاري، ووصف هدف المساعد، واختر لون البداية، وقم بإنشاء الروبوت الأول.

النتيجة المتوقعة: تفتح مساحة العمل بمسودة روبوت وحالة تجريبية نشطة.
5

فتح نظرة عامة

انقر فوق نظرة عامة في الشريط الجانبي الأيسر.

النتيجة المتوقعة: تعرض لوحة المعلومات بطاقات usage والإجراءات السريعة والأنشطة الحديثة.
6

اختر الإجراء التالي

استخدم إنشاء روبوت جديد للإعداد، أو عرض جميع الروبوتات للإدارة، أو التحليلات للأداء، أو الفوترة لحدود الخطة.

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

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

اختبار الإطلاق الخاص

قم بإنشاء أول اختبار روبوت خاص قبل بدء البث المباشر

ما هذا من أجل: استخدم هذا للتحقق من تتبع الحساب والروبوت والأداة والسجل قبل أن يرى العملاء المساعد.

قبل أن تبدأ
  • احصل على عينة واحدة من أسئلة العملاء جاهزة.
  • جهز صفحة مرحلية أو صفحة اختبار HTML محلية.
  • لا تستخدم بيانات العميل الحقيقية في الاختبار الأول.
1

افتح My Bots

انقر على My Bots في الشريط الجانبي أو استخدم عرض جميع الروبوتات من نظرة عامة.

النتيجة المتوقعة: يمكنك رؤية الروبوت الذي تم إنشاؤه أثناء الإعداد أو في حالة فارغة باستخدام زر "روبوت جديد".
2

افتح منشئ الروبوت

انقر فوق روبوت جديد أو تحرير على الروبوت الموجود.

النتيجة المتوقعة: يتم فتح Bot Builder باستخدام عناصر التحكم الأساسية والأدوات والمعرفة والصوت والتكامل.
3

احفظ الروبوت مرة واحدة

قم بملء اسم الروبوت المطلوب والرسالة الأولى، ثم انقر فوق حفظ.

النتيجة المتوقعة: يتلقى الروبوت معرفًا صالحًا ويمكنه إنشاء كود التضمين.
4

المعاينة بشكل خاص

استخدم لوحة المعاينة واطرح سؤالك النموذجي.

النتيجة المتوقعة: يجب أن تتطابق الإجابة مع تعليماتك أو تكشف عن المعرفة المفقودة.
5

تثبيت على التدريج

افتح التضمين، وانسخ مقتطف HTML، والصقه قبل علامة الإغلاق الأساسية في الصفحة المرحلية.

النتيجة المتوقعة: تظهر الأداة في الزاوية التي تم تكوينها على سطح المكتب والهاتف المحمول.
6

تأكيد التتبع

افتح البريد الوارد أو Chat History بعد المحادثة التجريبية.

النتيجة المتوقعة: تظهر المحادثة الاختبارية مع سجل الروبوت والقناة والرسائل الصحيح.
كيفية اختباره: أرسل رسالة نصية واحدة واختبارًا صوتيًا واحدًا في حالة تمكين الصوت. تأكد من ظهورهما في Chat History.
مشكلةإصلاح
رمز التضمين غير متاحاحفظ البوت أولاً. إذا كانت المزامنة الصوتية لا تزال معلقة، فانتظر المزامنة أو احفظها مرة أخرى بعد اكتمال الحقول المطلوبة.
تظهر القطعة الروبوت الخطأتأكد من أن data-bot-id في المقتطف يطابق معرف الروبوت من نموذج التضمين.
لا تظهر أي محادثة في التاريخقم بتحديث Chat History، وتأكد من أن الروبوت نشط، وتأكد من إجراء الاختبار على الأداة المثبتة، وليس على صفحة قديمة.

ما يجب القيام به بعد ذلك: انتقل إلى Bot Builder الإعداد والتدريب المعرفي.

02

إنشاء وتكوين بوت

قم بإنشاء الروبوتات أو تعديلها أو معاينتها أو تنشيطها أو نقلها أو إزالتها من My Bots وBot Builder.

/dashboardMy Bots مركز التحكم
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1انقر فوق New Bot لبدء مساعد جديد.
2استخدم التحرير أو التضمين أو النقل أو التنشيط أو الحذف على كل بطاقة روبوت.
3تحقق من الحالة النشطة ووقت التحديث الأخير قبل الاختبار.
/البوتات/:id/editBot Builder علامة تبويب الأساسيات
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1املأ اسم الروبوت والصورة الرمزية والرسالة الأولى وتعليمات النظام.
2استخدم المعاينة للاختبار قبل النشر.
3قم بالحفظ والمزامنة قبل نسخ كود التضمين.
إنشاء بوت

قم بإنشاء روبوت جديد من My Bots

ما هذا من أجل: استخدم سير العمل هذا عندما تحتاج علامة تجارية جديدة أو موقع ويب أو قائمة انتظار دعم أو حملة إلى مساعد خاص بها.

قبل أن تبدأ
  • قم بإعداد اسم الروبوت والهدف والرسالة الأولى ونموذجين أو ثلاثة أسئلة.
  • اجمع موقع الويب العام URL إذا كنت تخطط لاستيراد المحتوى.
  • تأكد من أن الخطة تسمح بعدد الروبوتات وميزات الصوت/الصورة الرمزية التي تحتاجها.
1

افتح My Bots

انقر على My Bots في الشريط الجانبي.

النتيجة المتوقعة: تكون الروبوتات الموجودة وزر الروبوت الجديد مرئيين.
2

انقر فوق بوت جديد

ابدأ روبوتًا جديدًا من صفحة My Bots.

النتيجة المتوقعة: يتم فتح Bot Builder بمساعد مسودة.
3

تعيين هوية الروبوت

أدخل اسم الروبوت، وقم بتحميل الصورة الرمزية أو اختيارها، واكتب الرسالة الأولى التي سيراها الزائرون.

النتيجة المتوقعة: تعكس لوحة المعاينة اسم المساعد والصورة الرمزية والترحيب.
4

كتابة تعليمات النظام

قم بوصف ما يجب أن يفعله الروبوت، وكيف يجب أن يتحدث، وما يجب أن يتجنبه، ومتى يجب أن يطلب المساعدة البشرية.

النتيجة المتوقعة: لدى المساعد قواعد سلوكية واضحة قبل إضافة المعرفة.
5

أضف المعرفة الأساسية

قم بلصق معلومات الشركة والمنتج والدعم والتسعير والاتصال الأساسية في منطقة المعرفة.

النتيجة المتوقعة: يستطيع الروبوت الإجابة على الأسئلة الشائعة دون الحاجة إلى استيراد موقع الويب حتى الآن.
6

احفظ البوت

انقر فوق حفظ وانتظر التأكيد المحفوظ أو المتزامن.

النتيجة المتوقعة: يتمتع الروبوت بمعرف ثابت، ويمكن اختبار المعاينة، وتصبح خيارات التضمين متاحة.
7

معاينة النتيجة

اطرح الأسئلة النموذجية المعدة في المعاينة.

النتيجة المتوقعة: يجب أن تتبع الإجابات التعليمات وأن تستخدم المعرفة التي أدخلتها.
8

التنشيط فقط عندما تكون جاهزًا

قم بتنشيط الروبوت بعد اجتياز الاختبار الخاص.

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

ما يجب القيام به بعد ذلك: قم بتكوين إعدادات الأداة، وأضف معرفة موقع الويب، ثم قم بتثبيت الروبوت.

إدارة الروبوتات

تحرير سير العمل أو استنساخه أو نقله أو إلغاء تنشيطه أو حذفه

ما هذا من أجل: استخدم سير العمل هذا عندما يحتاج الروبوت إلى تحديثات، أو تغييرات في الملكية، أو إيقاف مؤقت مؤقت، أو إزالة دائمة.

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

افتح My Bots

ابحث عن بطاقة الروبوت بالاسم أو الحالة.

النتيجة المتوقعة: تعرض البطاقة الحالة الحالية والإجراءات المتاحة.
2

انقر فوق تحرير

افتح أداة إنشاء الروبوتات وقم بإجراء التغييرات المطلوبة.

النتيجة المتوقعة: يقوم المحرر بتحميل التكوين الحالي.
3

حفظ وإعادة الاختبار

انقر فوق "حفظ" بعد كل تغيير مادي، ثم قم بتشغيل أسئلة المعاينة.

النتيجة المتوقعة: يتم استخدام التكوين المحفوظ بواسطة المعاينة والقطعة المثبتة.
4

قم بإلغاء التنشيط مؤقتًا

استخدم التبديل النشط إذا كان يجب على الروبوت التوقف عن التعامل مع الزوار في الوقت الحالي.

النتيجة المتوقعة: يتوقف الروبوت عن تقديم حركة المرور المباشرة مع الحفاظ على التكوين.
5

نقل الملكية

استخدم النقل، وأدخل البريد الإلكتروني للمستلم، وقم بالتأكيد.

النتيجة المتوقعة: يتلقى الحساب المحدد الملكية وفقًا لتدفق نقل التطبيق.
6

حذف فقط بعد الشيكات

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

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

ما يجب القيام به بعد ذلك: قم بمراجعة التحليلات والسجل بعد التغييرات المباشرة للتأكد من تحسين تجربة الزائر.

03

تثبيت القطعة

انسخ رمز التضمين الصحيح، وقم بتثبيته في سياقات HTML، أو WordPress، أو React، أو سياقات SDK المتقدمة، ثم تحقق من سلوك سطح المكتب والجوال.

تضمين مشروطانسخ مقتطف تثبيت موقع الويب
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1اختر HTML، أو WordPress، أو React، أو NPM/SDK استنادًا إلى مكدس الموقع.
2انسخ الرمز بعد حفظ الروبوت ومزامنته.
3الصق المقتطف قبل علامة إغلاق النص أو في تخطيط إطار العمل.
HTML تثبيت

قم بتثبيت الأداة على موقع ويب HTML القياسي

ما هذا من أجل: استخدم هذا عندما يمكنك تحرير قالب الصفحة أو تذييل السمة أو تخطيط HTML العام.

قبل أن تبدأ
  • احفظ الروبوت أولاً حتى يكون لنموذج التضمين معرف روبوت حقيقي.
  • استخدم موقع التدريج قبل الإنتاج.
  • احتفظ بنسخة البرنامج النصي الدقيقة وdata-bot-id من النموذج.
1

افتح My Bots

ابحث عن الروبوت الذي تريد تثبيته وانقر فوق "تضمين".

النتيجة المتوقعة: يتم فتح نموذج التضمين مع علامات تبويب التثبيت.
2

حدد HTML

اختر علامة التبويب HTML وانقر فوق "نسخ الرمز".

النتيجة المتوقعة: يتم نسخ البرنامج النصي لعنصر واجهة المستخدم مع معرف الروبوت المرفق.
3

افتح قالب الموقع

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

النتيجة المتوقعة: أنت تقوم بتحرير غلاف الموقع المشترك، وليس صفحة معزولة واحدة ما لم يكن ذلك مقصودًا.
4

لصق قبل إغلاق الجسم

قم بلصق المقتطف مباشرة قبل علامة إغلاق النص.

النتيجة المتوقعة: يتم تحميل البرنامج النصي بعد محتوى الصفحة ويمكنه تحميل حاوية عناصر واجهة المستخدم.
5

نشر أو نشر

احفظ القالب وانشر الموقع.

النتيجة المتوقعة: البرنامج النصي لعنصر واجهة المستخدم موجود مباشرة على الصفحات المستهدفة.
6

اختبار سطح المكتب والجوال

افتح الموقع في نافذة متصفح جديدة وفي إطار العرض على الهاتف المحمول.

النتيجة المتوقعة: تظهر الأداة في الموضع الذي تم تكوينه وتفتح بدون أخطاء في وحدة التحكم.
كيفية اختباره: أرسل رسالة من الصفحة المباشرة، ثم افتح Inbox وChat History للتأكد من أن المحادثة تنتمي إلى الروبوت الصحيح.
مشكلةإصلاح
القطعة مفقودةتأكد من أن الرمز موجود قبل علامة الإغلاق الأساسية، وأن البرامج النصية غير محظورة بواسطة منشئ الموقع، وأن الروبوت نشط.
يظهر بوت خاطئانسخ المقتطف مرة أخرى وقارن data-bot-id بالبوت المطلوب.
القطعة تتداخل مع عناصر التحكم في الصفحةقم بتغيير الموضع أو الحجم في إعدادات القطعة واختبرها مرة أخرى على الهاتف المحمول.

ما يجب القيام به بعد ذلك: قم بضبط إعدادات القطعة والتقاط الرصاص بعد التثبيت.

HTML تضمين
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
تثبيت المنصة

التثبيت في WordPress، React، أو التدفقات الصوتية المتقدمة SDK

ما هذا من أجل: استخدم هذا عندما تتم إدارة موقع الويب بواسطة نظام إدارة المحتوى (CMS)، أو تطبيق React، أو التكامل الصوتي المخصص.

قبل أن تبدأ
  • تعرف على المكدس الذي يمتلك التخطيط المشترك.
  • استخدم المقتطف الدقيق الموضح في sem.chat للروبوت المحدد.
  • بالنسبة للاستخدام المتقدم لـ SDK، تأكد من حصولك على المفتاح العام Vapi ومعرف المساعد المطلوبين.
1

خيار WordPress

استخدم المظهر أو محرر السمات أو footer.php أو مكون إضافي موثوق به للرؤوس والتذييلات.

النتيجة المتوقعة: يتم تحميل المقتطف على صفحات WordPress العامة.
2

خيار React

قم بإنشاء مكون ChatWidget صغير، وألحق البرنامج النصي في useEffect، وقم بعرضه في التخطيط الجذر.

النتيجة المتوقعة: يتم تحميل الأداة مرة واحدة ويتم تنظيفها في حالة إلغاء تحميل التخطيط.
3

خيار SDK المتقدم

استخدم علامة التبويب NPM/SDK فقط عندما تحتاج إلى عناصر تحكم مخصصة للمكالمات الصوتية تتجاوز الأداة الافتراضية.

النتيجة المتوقعة: يتحكم تطبيقك في الجلسة الصوتية بينما يظل sem.chat هو مصدر المساعد الذي تم تكوينه.
4

التحقق من معرف البوت

تأكد من أن الكود المثبت يشير إلى معرف الروبوت من نموذج التضمين.

النتيجة المتوقعة: تتصل القطعة المباشرة بالمساعد المقصود.
5

تحقق من وحدة التحكم

افتح أدوات مطور المتصفح وأعد التحميل.

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

ما يجب القيام به بعد ذلك: انتقل إلى إعدادات عناصر واجهة المستخدم للتحكم في السلوك والعلامة التجارية والتقاط العملاء المحتملين.

WordPress مقتطف التذييل
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
مكون React
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
صوت متقدم SDK
npm install @vapi-ai/web

import Vapi from '@vapi-ai/web';

const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');

vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04

إعدادات القطعة

قم بتكوين الوضع والموضوع والحجم والموضع واللون والعلامة التجارية وردود الفعل والصوت والموافقة والتقاط العملاء المحتملين والتقييمات ومتابعة البريد الإلكتروني وحالة التنشيط.

Bot Builder / القطعةمظهر القطعة وسلوك الزائر
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1اختر chat أو الصوت أو الوضع المختلط.
2قم بتعيين السمة واللون والموضع والحجم والعلامة التجارية والموافقة والصوت.
3قم بتكوين التقاط العملاء المحتملين والتقييمات وردود الفعل وسلوك المتابعة.
سلوك القطعة

تكوين سلوك القطعة التي تواجه الزائر

ما هذا من أجل: استخدم هذا بعد التثبيت الأول أو في أي وقت تحتاج فيه الأداة إلى مطابقة موقع الويب وجذب عملاء محتملين أفضل.

قبل أن تبدأ
  • قم بتثبيت الأداة على صفحة التدريج.
  • اعرف ما إذا كان يجب على الزائرين البدء بـ chat أو الصوت أو كليهما.
  • قم بإعداد الموافقة ونسخة التقاط الرصاص إذا لزم الأمر للمنطقة.
1

افتح منشئ الروبوت

افتح My Bots، وانقر على "تحرير"، ثم اختر علامة التبويب "القطعة".

النتيجة المتوقعة: تظهر عناصر التحكم في عنصر واجهة المستخدم للروبوت المحدد.
2

اختر الوضع

حدد الدردشة أو الصوت أو الهجين بناءً على تجربة الزائر التي تريدها.

النتيجة المتوقعة: تتغير المعاينة لإظهار الوضع المختار.
3

ضبط المظهر

اختر السمة واللون والحجم وموضع الزر وخيارات العلامة التجارية.

النتيجة المتوقعة: تتطابق الأداة مع الموقع دون تغطية المحتوى المهم.
4

تمكين عناصر التحكم بالزائرين

قم بتشغيل التفاعلات والصوت والتقييمات ومطالبات الموافقة أو إيقاف تشغيلها.

النتيجة المتوقعة: يرى الزائرون فقط عناصر التحكم التي تريد منهم استخدامها.
5

تكوين التقاط الرصاص

اختر الحقول المطلوبة وحقل الوصف الاختياري ومتى يظهر النموذج.

النتيجة المتوقعة: يتم جمع جهات الاتصال قبل أو أثناء conversations وفقًا لإعدادك.
6

قم بتعيين البريد الإلكتروني للمتابعة

قم بتكوين سلوك البريد الإلكتروني للمتابعة إذا كانت خطتك تتضمن ذلك.

النتيجة المتوقعة: يمكن للزائرين تلقي رسائل المتابعة بعد حل conversations.
7

حفظ واختبار

انقر فوق حفظ، وأعد تحميل صفحة التدريج، وافتح الأداة.

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

ما يجب القيام به بعد ذلك: أضف إعدادات الصوت/الصورة الرمزية ومصادر المعرفة قبل إطلاق الإنتاج.

05

الصوت والصور الرمزية

حدد أصوات المخزون، وقم بتكوين وضع الصوت وحدوده، وقراءة النصوص، واستنساخ الأصوات، وتعيين الأصوات المستنسخة، وإدارة المخزون أو الصور الرمزية المخصصة.

Bot Builder / صوتالصوت والحدود والنصوص والصور الرمزية
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1اختر صوتًا مخزونًا أو صوتًا مستنسخًا محفوظًا.
2قم بتعيين حدود دقائق الصوت وحفظ النص.
3اختر الصور الرمزية الخاصة بالمخزون أو قم بتحميل صورة رمزية مخصصة إذا كانت الخطة تسمح بذلك.
إعداد الصوت

إعداد المكالمات الصوتية والنصوص

ما هذا من أجل: استخدم هذا عندما يتعين على الزائرين التحدث إلى الروبوت بدلاً من الكتابة فقط.

قبل أن تبدأ
  • تأكد من أن الخطة تتضمن دقائق صوتية وخيارات الصوت/الصورة الرمزية المطلوبة.
  • استخدم بيئة متصفح هادئة للاختبار.
  • قم بإعداد سؤال دعم أو مبيعات واقعي واحد لاختباره صوتيًا.
1

افتح إعدادات الصوت

افتح أداة إنشاء الروبوتات وحدد منطقة الصوت أو الصوت والصور الرمزية.

النتيجة المتوقعة: عناصر التحكم في الصوت واختيار الصوت الحالي مرئية.
2

حدد صوت الأسهم

قم بمعاينة الأصوات المتاحة، واختر الأنسب، واحفظ التحديد.

النتيجة المتوقعة: يستخدم الروبوت الصوت المختار للمكالمات.
3

تكوين الوضع الصوتي

استخدم إعدادات القطعة لاختيار الصوت أو الهجين عندما يكون الصوت متاحًا للزائرين.

النتيجة المتوقعة: يرى الزائرون خيار الصوت في الأداة.
4

ضبط حدود الصوت

حدد الحدود لكل مستخدم أو مساحة العمل إذا كانت متوفرة.

النتيجة المتوقعة: لا يمكن للمكالمات الطويلة أو المتكررة أن تستهلك دقائق أكثر من المقصود.
5

تمكين النصوص

قم بتشغيل حفظ النص إذا كنت بحاجة إلى مراجعة المكالمات في السجل.

النتيجة المتوقعة: تنشئ المكالمات الصوتية نصوصًا قابلة للقراءة بعد الجلسة.
6

اختبار مكالمة

افتح الأداة، واسمح بالوصول إلى الميكروفون، وابدأ مكالمة، واطرح السؤال المعد.

النتيجة المتوقعة: يستجيب الروبوت بالصوت وتنتهي المكالمة بشكل نظيف.
7

اقرأ النص

افتح Chat History وابحث عن المحادثة الصوتية.

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

ما يجب القيام به بعد ذلك: قم بإضافة المعرفة أو تحسينها حتى تكون الإجابات الصوتية دقيقة.

استنساخ الصوت والصورة الرمزية

استنساخ صوت وتعيين صورة رمزية مخصصة

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

قبل أن تبدأ
  • استخدم فقط الصوت والصور التي لديك إذن باستخدامها.
  • تسجيل عينات صوتية نظيفة مع ضوضاء خلفية منخفضة.
  • قم بتأكيد حدود الخطة للأصوات المستنسخة والصور الرمزية المخصصة.
1

فتح استنساخ الصوت

انقر فوق Clone Voice من منطقة الصوت.

النتيجة المتوقعة: يعرض مربع حوار التحميل متطلبات العينة المقبولة.
2

تحميل العينات

قم بتحميل واحد إلى خمسة تسجيلات واضحة وأرسل طلب النسخ.

النتيجة المتوقعة: يظهر الصوت المستنسخ بعد المعالجة أو يعرض مربع الحوار المتطلبات التالية.
3

تعيين الصوت المستنسخ

حدد الصوت المستنسخ في محدد الصوت واحفظه.

النتيجة المتوقعة: تستخدم المكالمات المستقبلية الصوت المستنسخ.
4

اختر الصورة الرمزية للسهم

اختر صورة رمزية مضمنة إذا لم تكن هناك حاجة لتحميل الصورة الرمزية المخصصة.

النتيجة المتوقعة: التجربة الصوتية لها هوية بصرية.
5

تحميل الصورة الرمزية المخصصة

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

النتيجة المتوقعة: تتم معالجة الصورة الرمزية وتصبح متاحة للاختيار.
6

تشغيل معاينة كاملة

ابدأ مكالمة صوتية وقم بتأكيد سلوك الصوت والصورة الرمزية والنص معًا.

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

ما يجب القيام به بعد ذلك: انتقل إلى المعرفة والبيانات حتى تحصل التجربة الصوتية على إجابات دقيقة.

06

المعرفة والبيانات

قم بإضافة المعرفة اليدوية، واستيراد محتوى موقع الويب، وتطبيق نتائج الزحف، ومزامنة المحتوى المستورد، وإضافة خلاصة المنتج URLs، وتحديث الخلاصات أو إزالتها، والتحقق من الإجابات باستخدام أسئلة الاختبار.

Bot Builder / المعرفةمصادر المعرفة واختبار الإجابة
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1أضف المعرفة اليدوية للسياسة والتسعير وقواعد العلامة التجارية.
2استيراد صفحات موقع الويب وتطبيق نتائج الزحف.
3أضف خلاصات المنتج وقم بمزامنتها عند تغير المخزون.
مصادر المعرفة

قم بتدريب الروبوت باستخدام المعرفة اليدوية واستيراد موقع الويب وخلاصات المنتج

ما هذا من أجل: استخدم هذا عندما يقدم المساعد إجابات غير كاملة أو يحتاج إلى معلومات جديدة عن المنتج أو السياسة أو موقع الويب.

قبل أن تبدأ
  • قم بإعداد المصدر URLs وموجز المنتج URLs.
  • حدد الصفحات التي لا ينبغي استيرادها، مثل الصفحات الإدارية أو الخاصة.
  • قم بإنشاء أسئلة اختبار لكل موضوع تضيفه.
1

المعرفة المفتوحة

افتح Bot Builder واختر علامة التبويب "المعرفة" أو "البيانات".

النتيجة المتوقعة: تظهر المعرفة اليدوية واستيراد موقع الويب وأدوات تغذية المنتج.
2

إضافة المعرفة اليدوية

قم بلصق الحقائق الموجزة والسياسات والأسعار وتفاصيل الاتصال وملاحظات أسلوب الإجابة.

النتيجة المتوقعة: يمتلك الروبوت مصدرًا فوريًا موثوقًا به للحصول على الإجابات ذات الأولوية العالية.
3

استيراد محتوى الموقع

الصق موقع الويب العام URL وابدأ عملية الزحف/الاستيراد.

النتيجة المتوقعة: تعرض نتائج الزحف الصفحات المكتشفة أو حالة الاستيراد.
4

مراجعة النتائج وتطبيقها

احتفظ بالصفحات المفيدة، وقم بإزالة الصفحات غير ذات الصلة، ثم قم بتطبيق المحتوى المحدد.

النتيجة المتوقعة: يدخل محتوى موقع الويب المعتمد فقط إلى قاعدة المعرفة.
5

أضف خلاصة المنتج URLs

الصق Google Merchant Center أو الخلاصة المدعومة URLs واستوردها.

النتيجة المتوقعة: تصبح المنتجات والأسعار والتوفر والسمات متاحة للروبوت.
6

تحديث أو إزالة الخلاصات

استخدم التحديث عندما تتغير بيانات الكتالوج وقم بإزالة الخلاصات التي لم تعد مستخدمة.

النتيجة المتوقعة: يتجنب الروبوت بيانات المنتج القديمة أو المكررة.
7

حفظ ومزامنة

احفظ الروبوت وانتظر حتى تكتمل المزامنة.

النتيجة المتوقعة: يتم استخدام أحدث المعرفة من خلال المعاينة وإجابات القطعة المباشرة.
8

اطرح أسئلة التحقق

اطرح سؤال اختبار واحدًا لكل مصدر أضفته.

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

ما يجب القيام به بعد ذلك: ارجع إلى المعاينة، واختبر مرة أخرى، ثم قم بتثبيت الأداة أو تحديثها.

07

البريد الوارد، Live Support، التاريخ، جهات الاتصال

التعامل يوميًا مع conversations، والمطالبة بطلبات الدعم المباشر، وإعادة التحكم إلى الذكاء الاصطناعي، وتصدير السجل، وإدارة جهات الاتصال، ومزامنة جهات الاتصال مع SendPulse.

/inboxسير عمل محادثة البريد الوارد
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1التصفية حسب الروبوت أو القناة.
2افتح محادثة وقم بالرد كإنسان عند الحاجة.
3استخدم عناصر التحكم في الترجمة والحل والتسليم بعناية.
/ الدعم المباشرالتحكم في عملية التسليم للدعم المباشر
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1المطالبة بانتظار عمليات التسليم بسرعة.
2قم بالرد كوكيل أو قم بإعادة المحادثة إلى الذكاء الاصطناعي.
3حل عندما لم يعد الزائر بحاجة إلى مساعدة بشرية.
/chat-التاريختاريخ المحادثة والصادرات
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1البحث حسب الزائر أو الروبوت أو القناة أو التاريخ.
2افتح النصوص الكاملة للجلسات النصية والصوتية.
3قم بتصدير CSV أو JSON عند الحاجة.
/جهات الاتصالجهات الاتصال وتصدير SendPulse
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1تصفية جهات الاتصال حسب الروبوت أو المصدر.
2افتح تفاصيل الاتصال وسياق المحادثة.
3تصدير أو مزامنة جهات الاتصال المحددة إلى SendPulse.
الرد على البريد الوارد

افتح محادثة وأرسل ردًا بشريًا

ما هذا من أجل: استخدم هذا عندما يحتاج المشغل إلى الرد على عميل من sem.chat بدلاً من السماح للذكاء الاصطناعي بالاستمرار بمفرده.

قبل أن تبدأ
  • تأكد من أن المشغل لديه حق الوصول إلى الروبوت أو مساحة العمل.
  • إقرأ المحادثة قبل الرد.
  • معرفة ما إذا كان الزائر يتوقع نفس اللغة.
1

افتح البريد الوارد

انقر فوق البريد الوارد في الشريط الجانبي.

النتيجة المتوقعة: تظهر conversations الأخيرة مع الروبوت والقناة والزائر والحالة والوقت.
2

تصفية إذا لزم الأمر

استخدم مرشحات القناة أو الروبوت أو غير المقروءة أو الحالة للعثور على المحادثة.

النتيجة المتوقعة: تضيق القائمة لتشمل مجموعة المحادثات التي تحتاجها.
3

افتح المحادثة

انقر فوق صف الزائر.

النتيجة المتوقعة: يمكن رؤية الموضوع الكامل ومعلومات الزائر وعناصر التحكم في الرد.
4

ترجم إذا لزم الأمر

استخدم عناصر التحكم في الترجمة عندما تختلف لغة الزائر عن لغة الوكيل.

النتيجة المتوقعة: يمكن للوكيل أن يفهم ويرد بشكل مناسب.
5

إرسال الرد

اكتب الرد البشري وأرسله.

النتيجة المتوقعة: تتم إضافة الرسالة إلى سلسلة المحادثات كرد وكيل/بشري.
6

حل أو إبقاء مفتوحة

قم بحل المحادثة إذا اكتملت، أو اتركها مفتوحة للمتابعة.

النتيجة المتوقعة: تتوافق حالة البريد الوارد مع حالة العميل الحقيقية.
كيفية اختباره: أرسل ردًا اختباريًا آمنًا لمحادثة اختبارية وتأكد من ظهوره في أداة الزائر وChat History.
مشكلةإصلاح
فشل الرد في الإرسالتحقق من حالة الشبكة وحالة المحادثة وما إذا كان قد تم المطالبة بالدعم المباشر.
لغة الزائر خاطئةاستخدم الترجمة أو قم بتحديث إعدادات لغة الروبوت قبل الرد.
المحادثة ليست في البريد الواردابحث عن Chat History وتأكد من أن اختبار الأداة استخدم الروبوت الصحيح.

ما يجب القيام به بعد ذلك: استخدم Live Support لقوائم انتظار التسليم النشطة وChat History لعمليات التدقيق.

الدعم المباشر

يمكنك المطالبة والرد وإعادة التسليم إلى الذكاء الاصطناعي وحل عملية التسليم

ما هذا من أجل: استخدم هذا عندما يطلب الذكاء الاصطناعي من إنسان أو يحتاج الزائر بشكل صريح إلى وكيل.

قبل أن تبدأ
  • اجعل الوكيل متاحًا قبل تمكين الدعم المباشر.
  • حدد متى يجب على الذكاء الاصطناعي أن يطلب التسليم في تعليمات الروبوت.
  • حافظ على تمكين إعدادات الإشعارات لتنبيهات التسليم.
1

افتح Live Support

انقر على Live Support في الشريط الجانبي.

النتيجة المتوقعة: الانتظار والتسليم النشط conversations مرئيان.
2

المطالبة بالطلب

انقر فوق المطالبة بالمحادثة المنتظرة.

النتيجة المتوقعة: يمكن للوكلاء الآخرين رؤية المحادثة يتم التعامل معها بشكل نشط.
3

قراءة السياق

افتح الرسائل وتفاصيل الزائر قبل الرد.

النتيجة المتوقعة: يفهم الوكيل سبب حدوث عملية التسليم.
4

إرسال الرد البشري

قم بالرد بوضوح وحافظ على تحديث الموضوع.

النتيجة المتوقعة: يتلقى الزائر استجابة بشرية.
5

قم بالرجوع إلى منظمة العفو الدولية إذا كان ذلك مناسبًا

استخدم اليد مرة أخرى عندما يتم الرد على المشكلة ويمكن للذكاء الاصطناعي الاستمرار.

النتيجة المتوقعة: يستأنف الذكاء الاصطناعي التعامل مع المحادثة.
6

الحل عند الانتهاء

انقر فوق "حل" بعد أن لم يعد الزائر بحاجة إلى المساعدة.

النتيجة المتوقعة: يتم إغلاق عملية التسليم وإزالتها من قائمة الانتظار النشطة.
كيفية اختباره: قم بإنشاء عملية تسليم اختبارية، والمطالبة بها، والرد مرة واحدة، ثم تسليمها مرة أخرى، وتأكيد تغييرات الحالة في Live Support وChat History.
مشكلةإصلاح
وكلاء تفوت الطلباتتمكين المتصفح/البريد الإلكتروني/إشعارات الدفع وإضافة عملية لملكية قائمة الانتظار.
يستمر الذكاء الاصطناعي في تولي المسؤولية في وقت مبكر جدًااضبط التعليمات وقواعد التسليم بحيث تظل السيطرة البشرية نشطة حتى يتم حلها أو إعادتها.
CRM الخارجي غير متزامناستخدم خطافات الويب أو الاقتراع من قسم وصفات المطورين.

ما يجب القيام به بعد ذلك: قم بالاتصال بـ CRM/webhooks إذا كانت فرق الدعم تعمل خارج sem.chat.

التاريخ والاتصالات

البحث عن سجلات المحادثات/جهات الاتصال وتصديرها واستخدامها

ما هذا من أجل: استخدم هذا لعمليات التدقيق، ومراجعة العملاء المتوقعين، وتصدير CSV، ومزامنة SendPulse.

قبل أن تبدأ
  • قرر ما إذا كنت بحاجة إلى conversations أو جهات الاتصال أو كليهما.
  • قم بتطبيق النطاق الزمني الصحيح قبل التصدير.
  • لا تقم بتصدير بيانات شخصية أكثر من اللازم.
1

افتح Chat History

انقر على Chat History في الشريط الجانبي.

النتيجة المتوقعة: تكون عوامل تصفية المحادثة والإحصائيات وقائمة النصوص مرئية.
2

البحث والتصفية

قم بالتصفية حسب الروبوت أو القناة أو الوضع أو الزائر أو النطاق الزمني.

النتيجة المتوقعة: فقط conversations المطابق يظل مرئيًا.
3

افتح النص

انقر فوق محادثة لقراءة موضوع الرسالة بالكامل.

النتيجة المتوقعة: يكون السياق الكامل وتفاصيل الاتصال وبيانات تعريف المحادثة مرئية.
4

تصدير conversations

انقر فوق تصدير واختر التنسيق المطلوب إذا كان متاحًا.

النتيجة المتوقعة: تحتوي عملية التصدير على بيانات المحادثة التي تمت تصفيتها.
5

افتح جهات الاتصال

انقر فوق جهات الاتصال في الشريط الجانبي.

النتيجة المتوقعة: تظهر سجلات العملاء المتوقعين/جهات الاتصال مع المصدر والروبوت والحالة.
6

تصفية وتصدير جهات الاتصال

ابحث في جهات الاتصال، وحدد السجلات المطلوبة، ثم قم بالتصدير أو المزامنة إلى SendPulse.

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

ما يجب القيام به بعد ذلك: قم بمراجعة التحليلات لفهم اتجاهات الأداء بعد تشغيل العمليات.

08

القنوات والتكاملات

قم بتوصيل Slack، Facebook، Instagram، WhatsApp، Telegram من خلال BotFather، وبيانات الاعتماد اليدوية، وروابط chat البديلة، وSendPulse، وCRM عمليات التكامل.

/تكاملاتالقنوات، CRM، واتصالات البريد الإلكتروني
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1اختر القناة أو بطاقة التكامل CRM.
2اتبع خطوات OAuth أو بيانات الاعتماد لكل مزود.
3افصل عمليات التكامل أو أعد اختبارها من نفس الصفحة.
ربط القنوات

قم بتوصيل قناة مراسلة أو تكامل CRM

ما هذا من أجل: استخدم هذا عندما يجب أن يتلقى sem.chat conversations خارج أداة موقع الويب أو يرسل جهات اتصال إلى أدوات أخرى.

قبل أن تبدأ
  • الحصول على حق الوصول الإداري إلى النظام الأساسي الخارجي.
  • تعرف على الروبوت الذي يجب أن يتلقى رسائل القناة.
  • استخدم قنوات الاختبار قبل ربط حسابات الإنتاج.
1

التكامل المفتوح

انقر فوق عمليات التكامل في الشريط الجانبي.

النتيجة المتوقعة: القنوات المتاحة وأدوات CRM وSendPulse وخيارات أداة موقع الويب مرئية.
2

اختر التكامل

انقر فوق "اتصال" في Slack، أو القنوات التعريفية، أو Telegram، أو SendPulse، أو CRM، أو بيانات الاعتماد اليدوية.

النتيجة المتوقعة: يتم فتح مربع حوار الإعداد أو تدفق OAuth.
3

استكمال إعداد المزود

بالنسبة لقنوات OAuth، قم بالموافقة على الأذونات المطلوبة. بالنسبة للقنوات اليدوية، الصق الرمز المميز أو السر أو معرف الحساب أو خطاف الويب المطلوب URL.

النتيجة المتوقعة: sem.chat يخزن الاتصال ويعرض التكامل على أنه متصل.
4

تعيين الروبوت

اختر الروبوت الذي يجب أن يتعامل مع الرسائل من تلك القناة عندما يطلب منك مربع الحوار ذلك.

النتيجة المتوقعة: يتم توجيه الرسائل الواردة إلى المساعد الصحيح.
5

اختبر القناة

إرسال رسالة اختبار من القناة الخارجية.

النتيجة المتوقعة: تظهر الرسالة في البريد الوارد أو Chat History ضمن القناة الصحيحة.
6

افصل إذا لزم الأمر

استخدم قطع الاتصال من بطاقة التكامل عندما يجب أن تتوقف القناة.

النتيجة المتوقعة: sem.chat يتوقف عن الاستلام أو الإرسال من خلال هذا التكامل.
كيفية اختباره: أرسل رسالة اختبارية واحدة عبر القناة المتصلة وقم بتأكيد رد الروبوت وصف البريد الوارد وسجل السجل.
مشكلةإصلاح
فشل الرمز المميز Telegramقم بإنشاء أو إعادة تعيين الرمز المميز في BotFather ولصقه مرة أخرى.
Slack الرسائل لا تصلتحقق من نطاقات التطبيق، واشتراك الحدث URL، ورمز الروبوت، وسر التوقيع، وعضوية القناة.
فشل اتصال قناة التعريفتأكد من أن حساب Facebook/Instagram/WhatsApp لديه أذونات المسؤول ويتطلب الوصول التجاري.
فشلت مزامنة SendPulseأعد توصيل SendPulse وتأكد من تعيين حقول الاتصال.

ما يجب القيام به بعد ذلك: توثيق ملكية القناة للفريق ومراقبة Inbox بعد الإطلاق.

09

الجدولة

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

/جدولةجدولة مساحة العمل
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1استخدم علامات التبويب لأنواع الأحداث والحجوزات والتحليلات والارتباطات لمرة واحدة والتقويمات ورسائل البريد الإلكتروني والإعدادات.
2تحرير أنواع الأحداث أو نسخها أو تضمينها أو تنشيطها أو إيقافها مؤقتًا.
3انسخ الرابط العام وقم بإجراء اختبار الحجز الخاص.
محرر الحدثتكوين نوع الحدث
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1أدخل الاسم والوصف والمدة والموقع والمخازن المؤقتة.
2قم بتعيين مدى التوفر ونوافذ الحجز والأسئلة وخيارات الأحداث المدفوعة وقواعد الإلغاء.
3احفظ الحدث قبل مشاركة الرابط.
/book/:اسم المستخدم/:eventSlugصفحة الحجز العامة
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1يختار الزوار تاريخًا من صفحة الحجز العامة.
2يختار الزوار فترة زمنية متاحة.
3يؤكد الزوار الحجز ويتلقون رسائل تأكيد عبر البريد الإلكتروني.
نوع الحدث

قم بإنشاء نوع الحدث ونشر رابط الحجز

ما هذا من أجل: استخدم هذا عندما يتعين على الزائرين حجز العروض التوضيحية أو الاستشارات أو مكالمات المبيعات أو الإعداد أو جلسات الدعم.

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

فتح الجدولة

انقر على "الجدولة" في الشريط الجانبي.

النتيجة المتوقعة: تعرض مساحة عمل الجدولة علامات تبويب لأنواع الأحداث والحجوزات والتحليلات والارتباطات لمرة واحدة والتقويمات ورسائل البريد الإلكتروني والإعدادات.
2

إنشاء نوع الحدث

انقر على إنشاء، ثم قم بإضافة الاسم والوصف والمدة والموقع والمخزن المؤقت وقواعد الحجز.

النتيجة المتوقعة: يحتوي الحدث على معلومات عامة كافية للزوار لفهمه.
3

ضبط التوفر

قم بتكوين الساعات الأسبوعية وتجاوزات التاريخ ونوافذ الإشعارات ونافذة الحجز.

النتيجة المتوقعة: يرى الزوار فقط الأوقات التي ترغب في تقديمها.
4

أضف أسئلة

إضافة الأسئلة المطلوبة مثل الهاتف أو الشركة أو الموقع الإلكتروني أو هدف الاجتماع.

النتيجة المتوقعة: تجمع الحجوزات السياق الذي يحتاجه فريقك قبل المكالمة.
5

ربط التقويمات

افتح التقويمات واتصل بـ Google أو Outlook أو iCal إذا كان ذلك متاحًا.

النتيجة المتوقعة: يمكن حظر الأوقات المزدحمة ويمكن كتابة الحجوزات المؤكدة في التقويم.
6

ضبط رسائل البريد الإلكتروني والتذكيرات

افتح رسائل البريد الإلكتروني وقم بتكوين رسائل التأكيد والتذكير والإلغاء وإعادة الجدولة.

النتيجة المتوقعة: يتلقى الزوار اتصالات الحجز الصحيحة.
7

مشاركة واختبار الرابط العام

انسخ رابط الحدث، وافتحه في نافذة خاصة، واختر مكانًا، وأكمل الحجز التجريبي.

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

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

جدولة متقدمة

استخدم الروابط والتحليلات والتضمينات والأحداث المدفوعة لمرة واحدة

ما هذا من أجل: استخدم هذا عندما تحتاج الجدولة إلى توفر مؤقت أو إعداد تقارير أو حجز مضمن أو دفع.

قبل أن تبدأ
  • قم بإنشاء نوع حدث واحد على الأقل أولاً.
  • قم بتوصيل التقاويم قبل استخدام الروابط لمرة واحدة بشكل كبير.
  • حدد سياسة استرداد الأموال/الإلغاء قبل تمكين الأحداث المدفوعة.
1

إنشاء رابط لمرة واحدة

افتح الروابط لمرة واحدة، وحدد الخانات أو القواعد المعروضة، ثم أنشئ الرابط.

النتيجة المتوقعة: يمكن للمستلم الحجز من التوفر المحدد فقط.
2

تضمين الجدولة

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

النتيجة المتوقعة: يمكن وضع واجهة مستخدم الحجز في الصفحة التي يقوم فيها الزوار بالتحويل.
3

مراجعة تحليلات الجدولة

افتح التحليلات داخل الجدولة.

النتيجة المتوقعة: يمكنك رؤية الحجوزات واتجاهات الإكمال وأداء نوع الحدث.
4

تمكين الأحداث المدفوعة

افتح محرر الحدث، وحدد السعر والعملة وسلوك الدفع.

النتيجة المتوقعة: يجب على الزوار إكمال خطوة الدفع وفقًا لإعدادات الحدث.
5

حجوزات التدقيق

افتح الحجوزات وراجع الإدخالات القادمة والمكتملة والملغاة والمعاد جدولتها.

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

ما يجب القيام به بعد ذلك: ربط نتائج الجدولة بالتقارير والتحليلات.

10

التحليلات والتقارير

اختر النطاقات الزمنية، واستخدم التواريخ المخصصة، واقرأ المقاييس الأساسية، وقم بتصدير CSV، ومراجعة الرضا واتجاهات المحادثة، وتكوين تقارير البريد الإلكتروني، والتحقق من التسليم.

/ تحليلاتلوحة التحليلات
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1اختر النطاقات الزمنية أو التواريخ المخصصة.
2اقرأ مقاييس المحادثة والرضا واللغة والقناة والتحويل.
3قم بتصدير CSV للتحليل في وضع عدم الاتصال.
الإعدادات / التقاريرإعداد تقرير البريد الإلكتروني
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1اختر إيقاع التقرير اليومي أو الأسبوعي أو الشهري.
2إضافة مستلمي التقرير.
3إرسال تقرير فوري لاختبار التسليم.
مراجعة التحليلات

قراءة التحليلات وتصدير بيانات الأداء

ما هذا من أجل: استخدم هذا للمراجعات الأسبوعية وفحوصات الإطلاق ودعم مراجعة الجودة وتحليل التحويل.

قبل أن تبدأ
  • اختر النطاق الزمني قبل قراءة المقاييس.
  • تعرف على الروبوت أو القناة التي تقوم بتقييمها.
  • استبعاد تواريخ الاختبار الخاصة عند الإبلاغ عن أداء الإنتاج.
1

افتح التحليلات

انقر على التحليلات في الشريط الجانبي.

النتيجة المتوقعة: مقاييس لوحة المعلومات ولوحات الرسم البياني مرئية.
2

اختر النطاق الزمني

حدد اليوم أو 7 أيام أو 30 يومًا أو تواريخ مخصصة.

النتيجة المتوقعة: يتم تحديث كافة الرسوم البيانية للفترة المحددة.
3

قراءة المقاييس الأساسية

قم بمراجعة conversations والدقائق الصوتية والرضا والتحويل ومزيج القنوات.

النتيجة المتوقعة: أنت تفهم حجم ونوعية تفاعلات العملاء.
4

مراجعة الاتجاهات

انظر إلى اتجاهات المحادثة وتغييرات الرضا وأهم الأسئلة وأنماط اللغة/القناة.

النتيجة المتوقعة: يمكنك تحديد مكان تحسين تعليمات الروبوت أو التوظيف.
5

تصدير CSV

استخدم تصدير CSV عندما يحتاج الفريق إلى تحليل جداول البيانات.

النتيجة المتوقعة: يحتوي CSV على النطاق الزمني والمقاييس المحددة.
6

تحويل النتائج إلى تغييرات

قم بتحديث تعليمات الروبوت أو المعرفة أو إعدادات الأداة أو تغطية الدعم بناءً على البيانات.

النتيجة المتوقعة: تؤدي التحليلات إلى تحسينات ملموسة في المنتج.
كيفية اختباره: قم بتصدير تاريخ مخصص صغير CSV وتحقق من تطابق النطاق الزمني والمقاييس مع ما تعرضه لوحة المعلومات.
مشكلةإصلاح
تبدو المقاييس مرتفعة للغايةتحقق مما إذا كان التدريج/الاختبار conversations مدرجًا في النطاق الزمني المحدد.
الرضا فارغقم بتمكين التقييمات في إعدادات القطعة وانتظر حتى يغادر الزائرون التقييمات.
الدقائق الصوتية لا تتناسب مع التوقعاتتأكد من تمكين الوضع الصوتي فقط على الروبوتات المقصودة.

ما يجب القيام به بعد ذلك: جدولة تقارير البريد الإلكتروني للرؤية المتكررة.

التقارير

تكوين تقارير البريد الإلكتروني المتكررة وتسليم الاختبار

ما هذا من أجل: استخدم هذا عندما يحتاج المالكون أو المديرون أو العملاء إلى ملخصات أداء تلقائية.

قبل أن تبدأ
  • قرر من يجب أن يتلقى التقارير.
  • استخدم عناوين البريد الإلكتروني التي تم التحقق منها.
  • اختر إيقاعًا يتوافق مع إيقاعات مراجعة الأعمال.
1

افتح الإعدادات، ثم التقارير

انتقل إلى الإعدادات وحدد علامة التبويب التقارير، أو استخدم إعادة توجيه التقارير إذا كان ذلك متاحًا.

النتيجة المتوقعة: يمكن رؤية إيقاع التقرير والمستلمين والتاريخ.
2

اختر الإيقاع

تمكين التقارير اليومية أو الأسبوعية أو الشهرية.

النتيجة المتوقعة: يتم تخزين جدول التقرير لمساحة العمل.
3

إضافة المستلمين

أدخل عناوين البريد الإلكتروني التي ينبغي أن تتلقى التقارير.

النتيجة المتوقعة: يتم إرسال التقارير إلى أصحاب المصلحة المناسبين.
4

إرسال تقرير فوري

انقر فوق إرسال الآن أو ما يعادله من إجراء التقرير الفوري.

النتيجة المتوقعة: يتم إرسال تقرير بالبريد الإلكتروني على الفور للتحقق.
5

مراجعة تاريخ التقرير

تحقق من لوحة التاريخ بعد إرسال التقارير.

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

ما يجب القيام به بعد ذلك: استخدم إيقاع التقرير كإيقاع تشغيل لتحسينات الروبوت.

11

الفواتير، الفريق، الأمان، الإعدادات، الشركة التابعة

بدء الخطط أو ترقيتها، وإدارة بوابة الفوترة، ودعوة أعضاء الفريق، وتعيين الأدوار، وتحرير الملف الشخصي/اللغة، وتكوين الإشعارات، وتمكين المصادقة الثنائية، واستخدام إجراءات منطقة الخطر، وتشغيل سير العمل التابع.

/الفواتيرضوابط الخطة والفواتير
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1قم بمراجعة الخطة الحالية وحالة الإصدار التجريبي وحدود usage.
2قارن ميزات الخطة قبل الترقية.
3افتح بوابة الفوترة للفواتير وطرق الدفع والإلغاء أو إعادة التنشيط.
/الإعداداتالإعدادات والفريق والأمان
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1استخدم عام للملف الشخصي واللغة.
2استخدم الفريق للدعوات والأدوار.
3استخدم الأمان لمفاتيح 2FA وAPI وإجراءات منطقة الخطر.
/ التابعةضوابط البرنامج التابع
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1انضم إلى البرنامج لإنشاء رابط الإحالة.
2انسخ رابط الإحالة للحملات.
3قم بتعيين البريد الإلكتروني للدفع واطلب دفعات مؤهلة.
الفواتير

ابدأ الخطة أو قم بترقيتها أو إلغائها أو إعادة تنشيطها

ما هذا من أجل: استخدم هذا عندما تحتاج مساحة العمل إلى تنشيط تجريبي أو المزيد من الحدود أو الفواتير أو تحديثات الدفع أو تغييرات الاشتراك.

قبل أن تبدأ
  • يجب على مالك الحساب أو مسؤول الفوترة تنفيذ إجراءات الفوترة.
  • تأكد من الميزات المدرجة في الخطة: الصوت، والأصوات المستنسخة، والصور الرمزية المخصصة، API، والفريق، CRM، والقنوات.
  • استخدم بوابة الفوترة الآمنة لطريقة الدفع وتغييرات الفاتورة.
1

فتح الفواتير

انقر فوق الفوترة في الشريط الجانبي.

النتيجة المتوقعة: الخطة الحالية، وحالة الإصدار التجريبي، وحدود usage، وبطاقات الخطة مرئية.
2

قارن الخطط

قم بمراجعة chat، والصوت، والفريق، وAPI، والصورة الرمزية، والتكامل، والجدولة، وحدود الدعم.

النتيجة المتوقعة: أنت تعرف أي خطة تفتح الميزة المطلوبة.
3

اختر الفاصل الزمني للفوترة

حدد شهريًا أو سنويًا إذا كان التبديل متاحًا.

النتيجة المتوقعة: تحديث الأسعار والتوفير للفاصل الزمني المحدد.
4

ترقية أو بدء الخروج

اختر الخطة المطلوبة وأكمل عملية الدفع.

النتيجة المتوقعة: يصبح الاشتراك نشطًا بعد تأكيد الدفع.
5

فتح بوابة العملاء

استخدم بوابة الفواتير لطريقة الدفع أو الفواتير أو الإلغاء أو إعادة التنشيط.

النتيجة المتوقعة: تحدث إجراءات الفوترة الحساسة في بوابة المزود الآمنة.
6

التحقق من الوصول إلى الميزة

ارجع إلى الميزة التي تم قفلها وأعد تحميل التطبيق.

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

ما يجب القيام به بعد ذلك: قم بدعوة أعضاء الفريق وتأمين حساب المالك.

الفريق والأمن

قم بدعوة أعضاء الفريق، وتعيين الأدوار، وتحرير الملف الشخصي، وتمكين المصادقة الثنائية، وإدارة الإعدادات

ما هذا من أجل: استخدم هذا عندما تنتقل مساحة العمل من الإعداد الفردي إلى التشغيل الجماعي.

قبل أن تبدأ
  • تعرف على دور كل زميل في الفريق قبل إرسال الدعوات.
  • استخدم الوصول الأقل امتيازًا: المالك، المشرف، المحرر، العارض.
  • احصل على تطبيق مصادقة جاهز للمصادقة الثنائية.
1

افتح الإعدادات

انقر على الإعدادات في الشريط الجانبي.

النتيجة المتوقعة: تظهر علامات التبويب العامة والإشعارات والفريق والتقارير والمطورين والأمان وعلامات التبويب ذات الصلة.
2

تحرير الملف الشخصي واللغة

قم بتحديث اسم العرض ومعلومات الملف الشخصي واللغة المفضلة بشكل عام.

النتيجة المتوقعة: يحدد التطبيق المستخدم بشكل صحيح ويستخدم اللغة المختارة حيثما كانت متاحة.
3

دعوة أعضاء الفريق

افتح الفريق، وأدخل البريد الإلكتروني، واختر دورًا، وأرسل الدعوة.

النتيجة المتوقعة: يتلقى زميل الفريق رابط دعوة ويظهر في حالة معلقة حتى يتم قبوله.
4

تعيين أذونات الدور

استخدم المالك للتحكم الكامل، والمسؤول للإدارة، والمحرر لتغييرات المحتوى، والعارض للوصول للقراءة فقط.

النتيجة المتوقعة: كل مستخدم لديه حق الوصول المناسب لمسؤوليته.
5

تكوين الإخطارات

اختر إشعارات البريد الإلكتروني والمتصفح والدفع والدعم المباشر والفوترة والتقارير.

النتيجة المتوقعة: يحصل الأشخاص المناسبون على تنبيهات دون ضوضاء غير ضرورية.
6

تمكين 2FA

افتح الأمان، وقم بتمكين المصادقة الثنائية، وامسح الرمز ضوئيًا، وقم بتخزين تفاصيل الاسترداد.

النتيجة المتوقعة: يتطلب الحساب عاملاً ثانيًا بعد تسجيل الدخول بكلمة المرور.
7

استخدم إجراءات منطقة الخطر بعناية

قم بتصدير البيانات المطلوبة وتأكيد عناصر واجهة المستخدم/عمليات التكامل النشطة قبل إجراءات الحساب المدمرة.

النتيجة المتوقعة: تتجنب مساحة العمل فقدان البيانات العرضي.
كيفية اختباره: قم بدعوة زميل في فريق الاختبار، واقبل الدعوة في متصفح منفصل، وتأكد من أن الدور لا يكشف إلا عن الميزات المقصودة.
مشكلةإصلاح
دعوة البريد الإلكتروني في عداد المفقودينتحقق من الرسائل غير المرغوب فيها وأعد إرسال الدعوة وتحقق من العنوان.
زميله يرى الكثيرقم بتخفيض دورهم ومراجعة إعدادات الوصول إلى الروبوت.
فشل إعداد 2FAتحقق من وقت الجهاز، وأعد مسح رمز الاستجابة السريعة ضوئيًا، وقم بتخزين تفاصيل الاسترداد قبل الاعتماد عليه.

ما يجب القيام به بعد ذلك: قم بتكوين مفاتيح API فقط للمستخدمين والخدمات التي تحتاج إليها.

انضم

انضم إلى الشركة التابعة، وانسخ رابط الإحالة، وقم بتعيين البريد الإلكتروني للدفع، واطلب الدفع

ما هذا من أجل: استخدم هذا عندما يريد شريك أو عميل إحالة مستخدمي sem.chat الجدد وتتبع نشاط العمولة.

قبل أن تبدأ
  • استخدم الحساب الذي يجب أن يمتلك إسناد الإحالة.
  • قم بإعداد البريد الإلكتروني الخاص بالدفع قبل طلب الدفع.
  • تحقق من قواعد البرنامج قبل نشر حملات الإحالة.
1

فتح التابعة

انقر على "التابع" في الشريط الجانبي أو افتح علامة التبويب "التابع" من "الإعدادات" إذا كانت مرتبطة هناك.

النتيجة المتوقعة: تعرض صفحة البرنامج التابع مناطق الانضمام والإحالة والدفع والسجل.
2

انضم إلى البرنامج

انقر فوق "انضمام" إذا لم ينضم الحساب بعد.

النتيجة المتوقعة: يتم إنشاء رمز الإحالة ورابط الإحالة.
3

انسخ رابط الإحالة

انسخ الرابط الفريد واستخدمه في المحتوى أو الحملات أو رسائل الشركاء.

النتيجة المتوقعة: يمكن أن تعزى عمليات الاشتراك من خلال الرابط إلى الحساب التابع.
4

قم بتعيين البريد الإلكتروني للدفع

أدخل البريد الإلكتروني للدفع واحفظه.

النتيجة المتوقعة: يمكن توجيه العوائد المؤهلة بشكل صحيح.
5

مراجعة الإحالات والعمولات

تحقق من قائمة الإحالة، وحالة العمولة، وتاريخ الدفع.

النتيجة المتوقعة: أنت تعرف ما هو معلق أو مؤهل أو مدفوع بالفعل.
6

طلب دفع تعويضات

انقر فوق طلب دفع تعويضات عند استيفاء قواعد البرنامج والحد الأدنى.

النتيجة المتوقعة: يتم تسجيل طلب الدفع للمعالجة.
كيفية اختباره: افتح رابط الإحالة في متصفح خاص وتأكد من وصوله إلى تدفق الاشتراك المتوقع مع تتبع الإحالة.
مشكلةإصلاح
رابط الإحالة مفقودانضم إلى البرنامج أولاً أو قم بتحديث الصفحة التابعة بعد الانضمام.
طلب الدفع غير متاحتحقق من الحد الأدنى للدفع وحالة العمولة المؤهلة والبريد الإلكتروني للدفع.
الإحالة لم تنسبتأكد من أن الزائر استخدم رابط الإحالة الدقيق ولم يقم بإزالة معلمات التتبع.

ما يجب القيام به بعد ذلك: استخدم التحليلات والتقارير لمراقبة تأثير العملاء المحالين إن أمكن.

12

الإخطارات وApp Updates

قم بمراجعة التنبيهات ووضع علامة على الإشعارات كمقروءة وتصفية الأحداث المهمة واستخدام تحديثات التطبيق لفهم تغييرات المنتج الجديدة.

/الإخطاراتمركز الإخطار
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1استخدم وضع علامة على الكل مقروءًا بعد مراجعة التنبيهات غير المقروءة.
2قم بالتصفية حسب الأحداث غير المقروءة أو الفوترة أو الدعم المباشر أو أحداث النظام.
3افتح الميزة ذات الصلة بعد قراءة التنبيه.
/app-updatesخلاصة تحديثات التطبيق
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1اقرأ ملاحظات الإصدار للتعرف على الميزات والإصلاحات الجديدة.
2استخدم التفاصيل لتدريب أعضاء الفريق قبل إجراء تغييرات على سير العمل.
3تحقق من التحديثات بعد ملاحظة تغييرات في واجهة المستخدم أو السلوك.
الإخطارات

مراجعة الإخطارات والتصرف بناء على التنبيهات

ما هذا من أجل: استخدم هذا عندما يقوم التطبيق بالإبلاغ عن عمليات التسليم، أو حالة الفوترة، أو أحداث النظام، أو تسليم التقرير، أو نشاط مساحة العمل المهم.

قبل أن تبدأ
  • تأكد من ضبط تفضيلات الإشعارات في الإعدادات.
  • احصل على تغطية دعم مباشر في حالة تمكين تنبيهات التسليم.
  • قم بمراجعة التنبيهات غير المقروءة قبل وضع علامة عليها كمقروءة.
1

فتح الإخطارات

انقر على الإشعارات في الشريط الجانبي أو إدخال الإشعارات في رأس التطبيق.

النتيجة المتوقعة: يسرد مركز الإشعارات التنبيهات الأخيرة.
2

تصفية التنبيهات

استخدم عوامل تصفية غير مقروءة أو فئات للتركيز على الفوترة أو الدعم المباشر أو الروبوت أو التقرير أو أحداث النظام.

النتيجة المتوقعة: تبقى التنبيهات المطابقة فقط مرئية.
3

افتح الصفحة ذات الصلة

انقر على التنبيه أو استخدم السياق الخاص به لفتح الفوترة، أو Live Support، أو التقارير، أو الروبوت ذي الصلة.

النتيجة المتوقعة: أنت تتصرف بناءً على الإشعار بدلاً من مجرد قراءته.
4

مارك اقرأ

قم بوضع علامة على تنبيه واحد للقراءة أو استخدم علامة على كل القراءة بعد المراجعة.

النتيجة المتوقعة: لم يعد يتم تمييز عدد القطرات غير المقروءة والعناصر التي تمت مراجعتها.
5

ضبط التفضيلات

افتح الإعدادات، ثم الإشعارات في حالة وصول عدد كبير جدًا أو قليل جدًا من التنبيهات.

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

ما يجب القيام به بعد ذلك: قم بمراجعة App Updates عند حدوث تغييرات في السلوك أو ظهور عناصر تحكم جديدة.

تحديثات التطبيق

استخدم تحديثات التطبيق لفهم تغييرات المنتج

ما هذا من أجل: استخدم هذا عندما يحتاج أعضاء الفريق إلى معرفة ما تغير قبل استخدام ميزة جديدة.

قبل أن تبدأ
  • افتح التحديثات بعد الإصدارات الرئيسية أو عندما تتغير واجهة المستخدم.
  • شارك ملاحظات التحديث ذات الصلة مع مستخدمي الدعم والمبيعات.
  • إعادة اختبار سير العمل المهم بعد التغييرات الرئيسية.
1

افتح App Updates

انقر على App Updates في الشريط الجانبي.

النتيجة المتوقعة: يعرض موجز التحديث الميزات الجديدة والإصلاحات وملاحظات الإصدار.
2

قراءة آخر تحديث

افتح بطاقة التحديث الأحدث أو عرض التفاصيل.

النتيجة المتوقعة: ترى ما تغير وسير العمل الذي يؤثر عليه.
3

قم بتخطيط التغيير في سير العمل الخاص بك

حدد ما إذا كان التحديث يؤثر على الروبوتات أو الأدوات أو الدعم أو الجدولة أو الفوترة أو المطورين.

النتيجة المتوقعة: أعضاء الفريق المناسبون يعرفون ما يجب التحقق منه.
4

إعادة اختبار المسارات الحرجة

إذا كان التحديث يؤثر على سير عمل الإنتاج، فكرر الخطوات اليدوية ذات الصلة من هذه الوثائق.

النتيجة المتوقعة: يؤكد الفريق أن سير العمل الذي تم تغييره لا يزال يعمل.
5

المشاركة داخليًا

أرسل ملخص التحديث إلى المستخدمين الذين يملكون المنطقة المتأثرة.

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

ما يجب القيام به بعد ذلك: حافظ على تحديث الوثائق العامة مع تطور الميزات.

13

وصفات المطور

أنشئ مفاتيح API، واستخدم مصادقة x-api-key، واستدعاء نقاط النهاية المستندة إلى الإجراء، وقم بتوصيل الدعم المباشر إلى CRM، وتسجيل خطافات الويب، والتحقق من التوقيعات، وتضمين الأداة في التعليمات البرمجية.

الإعدادات / المطورينمفاتيح API، والبدء السريع، وعلامات التبويب usage
لقطة شاشة حقيقية من مساحة عمل تجريبية في sem.chat
1قم بإنشاء وإبطال مفاتيح API من علامة التبويب مفاتيح API.
2استخدم Quick Start لأمثلة التجعيد الأولى.
3قم بمراجعة الاستخدام قبل تمكين الأتمتة ذات الحجم الكبير.
API بداية سريعة

قم بإنشاء مفتاح API وقم بإجراء أول مكالمات API

ما هذا من أجل: استخدم هذا لإعداد التقارير النصية أو التطبيقات المخصصة أو جسور CRM أو الدعم المباشر الخارجي أو التشغيل الآلي.

قبل أن تبدأ
  • استخدم بيئة من جانب الخادم. لا تكشف عن مفاتيح API في المتصفح JavaScript.
  • قم بإنشاء مفتاح منفصل لكل تكامل.
  • انسخ المفتاح فورًا لأن الأسرار تظهر مرة واحدة.
1

افتح المطورين

افتح الإعدادات وحدد المطورين، أو استخدم إعادة توجيه المطورين إذا كان ذلك متاحًا.

النتيجة المتوقعة: API المفاتيح وQuick Start والوثائق وعلامات التبويب الاستخدام مرئية.
2

إنشاء مفتاح

انقر فوق "إنشاء مفتاح" وأعطه تسمية واضحة وانسخه على الفور.

النتيجة المتوقعة: يبدأ المفتاح بـ sk_live_ وهو متاح للطلبات من جانب الخادم.
3

أرسل رأس x-api-key

قم بتضمين x-api-key في كل طلب API عام.

النتيجة المتوقعة: يمكن لـ API العام مصادقة الطلب وتوسيع نطاقه للمالك.
4

قائمة الروبوتات

اتصل بالإجراء=list-bots للعثور على معرف الروبوت الذي تحتاجه.

النتيجة المتوقعة: تقوم الاستجابة بإرجاع معرفات الروبوت والأسماء والحالة النشطة وملخص التكوين.
5

أرسل رسالة chat

POST الإجراء chat مع botId والرسالة.

النتيجة المتوقعة: تقوم الاستجابة بإرجاع الرد والنموذج ومعلومات usage.
6

تحقق من usage

استدعاء الإجراء=usage قبل تشغيل المهام ذات الحجم الكبير.

النتيجة المتوقعة: أنت تعرف الخطة الحالية وحالة usage قبل تشغيل الأتمتة.
7

تدوير المفاتيح عند الحاجة

قم بإلغاء المفاتيح غير المستخدمة وإنشاء مفاتيح جديدة للبائعين أو الخدمات التي تم تغييرها.

النتيجة المتوقعة: لا يمكن للخدمات القديمة الاستمرار في استخدام بيانات الاعتماد القديمة.
كيفية اختباره: قم بتشغيل list-bots وchat من محطة محلية أو بيئة خادم، ثم تأكد من ظهور المحادثة في Chat History إذا تم إرسال chat.
مشكلةإصلاح
401 أو استجابة غير مصرح بهاقم بإجراء تدقيق إملائي لـ x-api-key، وانسخ المفتاح بالكامل، وتأكد من أنه لم يتم إبطاله.
لم يتم العثور على بوتاستخدم list-bots مرة أخرى وتأكد من أن الروبوت ينتمي إلى مالك المفتاح API.
مشكلة CORS في المتصفحانقل استدعاء API إلى الواجهة الخلفية لديك؛ مفاتيح API مخصصة للاستخدام من جانب الخادم.

ما يجب القيام به بعد ذلك: استخدم /api-docs كمرجع مركز لنقطة النهاية واحتفظ بهذه الصفحة كدليل سير العمل.

قائمة الروبوتات
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
  -H "x-api-key: sk_live_your_key_here"
أرسل رسالة chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "chat",
    "botId": "YOUR_BOT_ID",
    "message": "What can you help me with?"
  }'
الدعم المباشر لجسر CRM

قم باستقصاء طلبات الدعم المباشر أو إرسالها إلى CRM

ما هذا من أجل: استخدم هذا عندما يعمل الوكلاء في نظام آخر ولكن sem.chat يتلقى محادثة الزائر.

قبل أن تبدأ
  • قم بإنشاء مفتاح API مخصص باسم الجسر CRM.
  • قرر ما إذا كان الاقتراع أو خطافات الويب تناسب بنيتك الأساسية.
  • تأكد من أن CRM يخزن معرفات المحادثة للردود/الحل المستقبلي.
1

قائمة انتظار التسليمات

GET الإجراء=live-support-list بالحالة=مطلوب أو الحالة=الكل.

النتيجة المتوقعة: يستقبل CRM conversations مفتوحًا ويتطلب اهتمامًا بشريًا.
2

جلب الرسائل

إجراء GET=live-support-messages مع conversationId.

النتيجة المتوقعة: يحتوي CRM على سياق الموضوع الكامل وتفاصيل الزائر.
3

المطالبة قبل الرد

POST الإجراء=live-support-claim.

النتيجة المتوقعة: sem.chat يضع علامة على المحادثة على أنها تمت معالجتها بشكل نشط.
4

إرسال رد الوكيل

إجراء POST=live-support-reply مع conversationId والرسالة واسم الوكيل.

النتيجة المتوقعة: يتلقى الزائر الرد البشري وتحديثات الموضوع.
5

حل أو تسليم مرة أخرى

POST الإجراء=live-support-resolve مع حل الدقة أو التراجع.

النتيجة المتوقعة: تترك المحادثة قائمة الانتظار أو يستأنف الذكاء الاصطناعي التحكم.
6

حالة التسجيل في CRM

قم بتخزين أحدث حالة التسليم ومعرف الرسالة والطوابع الزمنية.

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

ما يجب القيام به بعد ذلك: قم بتسجيل خطافات الويب إذا كان الاقتراع بطيئًا جدًا أو مكلفًا للغاية.

خطافات الويب

سجل خطافات الويب وتحقق من X-SemChat-Signature

ما هذا من أجل: استخدم هذا عندما يحتاج نظامك إلى أحداث في الوقت الفعلي لعمليات التسليم والرسائل وتحديثات الدقة.

قبل أن تبدأ
  • يجب أن يكون Webhook URL HTTPS ويمكن الوصول إليه من الإنترنت العام.
  • قم بتخزين سر webhook على الفور؛ يتم عرضه مرة واحدة.
  • التحقق من التوقيعات قبل معالجة الأحداث.
1

سجل خطاف الويب

إجراء POST webhook-register مع عنوان url والأحداث.

النتيجة المتوقعة: يتضمن الرد تفاصيل خطاف الويب وسر التوقيع لمرة واحدة.
2

تخزين السر

احفظ السر في بيئة الخادم الخاص بك أو مدير السر.

النتيجة المتوقعة: يمكن التحقق من التسليمات المستقبلية.
3

التحقق من التوقيع

اقرأ X-SemChat-Signature وقارنه بـ HMAC SHA-256 الموجود في نص الطلب الأولي.

النتيجة المتوقعة: يتم قبول عمليات تسليم sem.chat الأصلية فقط.
4

التعامل مع إعادة المحاولة بشكل غير فعال

استخدم معرف الحدث أو معرف المحادثة/الرسالة لتجنب المعالجة المكررة.

النتيجة المتوقعة: لا تؤدي إعادة المحاولة إلى إنشاء سجلات CRM مكررة.
5

قائمة خطافات الويب

إجراء GET webhook-list لتدقيق نقاط النهاية التي تم تكوينها.

النتيجة المتوقعة: يمكنك رؤية URLs والأحداث والحالة الممكّنة وحالة التسليم الأخيرة.
6

حذف خطافات الويب القديمة

إجراء POST webhook-delete بمعرف الرد التلقائي على الويب.

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

ما يجب القيام به بعد ذلك: قم بربط المهندسين بـ /api-docs للحصول على تفاصيل وأمثلة عن نقطة النهاية.

تسجيل خطاف الويب
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
التحقق من توقيع webhook
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
خريطة نقطة النهاية

استخدم API العام القائم على الإجراء بشكل صحيح

ما هذا من أجل: استخدم هذا عند اختيار الإجراء المناسب لميزة ما.

قبل أن تبدأ
  • يستخدم كل طلب نفس وظيفة واجهة برمجة التطبيقات العامة URL.
  • تستخدم إجراءات GET معلمات الاستعلام. تستخدم إجراءات POST نص JSON.
  • أرسل x-api-key على كافة الطلبات.
كيفية اختباره: اتصل بـ usage وlist-bots كاختبار دخان بعد أي تغيير في مفتاح API أو نقطة النهاية.
مشكلةإصلاح
عدم تطابق الطريقةاستخدم الطريقة الموضحة في جدول نقطة النهاية. بعض الإجراءات هي GET فقط أو POST فقط.
القيمة المطلوبة مفقودةتحقق من botId وconversationId ومعرف خطاف الويب والتهجئة الإملائية.

ما يجب القيام به بعد ذلك: استخدم Quick Start للطلبات الأولى، ثم /api-docs للمرجع الكامل.

الطريقةالعملالغرض
__سيمتشات_0__list-botsقم بإدراج جميع برامج الروبوت المتاحة لمالك المفتاح API.
__سيمتشات_0__get-botجلب تكوين روبوت واحد عن طريق معرف الروبوت.
__سيمتشات_0__chatأرسل رسالة زائر إلى الروبوت وأرجع رد الذكاء الاصطناعي.
__سيمتشات_0__conversationsقم بإدراج أحدث conversations للروبوت، بما يصل إلى 100 سجل.
__سيمتشات_0__usageخطة الإرجاع، والأرصدة، وعدد الروبوتات، وconversations، ومفتاح API usage.
__سيمتشات_0__live-support-listقائمة conversations في انتظار وكيل بشري أو يتم التعامل معه.
__سيمتشات_0__live-support-messagesجلب سلسلة تسليم مع الرسائل ومعلومات الزائر.
__سيمتشات_0__live-support-replyإرسال رد الوكيل البشري من نظام خارجي.
__سيمتشات_0__live-support-claimالمطالبة بمحادثة تسليم قيد الانتظار.
__سيمتشات_0__live-support-resolveقم بحل عملية التسليم أو التحكم في العودة إلى الذكاء الاصطناعي.
__سيمتشات_0__webhook-registerقم بتسجيل نقطة نهاية خطاف الويب HTTPS.
__سيمتشات_0__webhook-listقم بإدراج تسجيلات webhook دون إرجاع الأسرار.
__سيمتشات_0__webhook-deleteحذف تسجيل webhook بواسطة المعرف.
14

دليل المهندس: إضافة الميزات

أضف المسارات، والتنقل في لوحة المعلومات، وإعدادات منشئ الروبوتات، وSupabase الجداول/الوظائف/الترحيلات، وAPI المستندات، والوثائق العامة، وفحوصات تحسين محركات البحث (SEO)، والتحقق المحلي.

سير عمل ميزة التطبيق

أضف مسار التطبيق، والصفحة، وعنصر التنقل، وإدخال المستندات

ما هذا من أجل: استخدم هذا عند إضافة ميزة لوحة معلومات جديدة تواجه العملاء.

قبل أن تبدأ
  • إنشاء فرع قبل التحرير.
  • حدد ما إذا كانت الميزة تنتمي إلى مستودع التطبيق أو مستودع الواجهة الأمامية sem.chat العام.
  • افحص المسار الحالي والشريط الجانبي وi18n وأنماط الإعدادات قبل إضافة بنية جديدة.
1

أضف الطريق

قم بتحديث src/App.tsx بمسار محمي لصفحات العملاء، أو بمسار عام فقط عندما تكون الصفحة عامة.

النتيجة المتوقعة: يتم حل URL في التطبيق دون الضغط على NotFound.
2

إنشاء أو تحديث مكون الصفحة

استخدم أنماط الصفحة الحالية وتحميل البيانات والحالات الفارغة وحالات التحميل والأذونات.

النتيجة المتوقعة: تعمل الميزة بشكل متسق مع لوحة المعلومات.
3

إضافة التنقل في لوحة القيادة

قم بتحديث الشريط الجانبي/مصدر التنقل باستخدام التسمية والرمز والمسار وبوابات الخطة إذا لزم الأمر.

النتيجة المتوقعة: يمكن للمستخدمين اكتشاف الصفحة الجديدة من غلاف التطبيق.
4

أضف علامة تبويب أو إعداد برنامج إنشاء الروبوتات

إذا كانت الميزة تنتمي إلى برنامج روبوت، فأضفها داخل علامات التبويب Bot Builder واستمر في استمرارها من خلال تدفقات الحفظ الحالية.

النتيجة المتوقعة: يتم حفظ التكوين الخاص بالروبوت مع الروبوت، وليس في الحالة المحلية.
5

أضف Supabase تغييرات في المخطط/الوظيفة

قم بإنشاء عمليات ترحيل للجداول/السياسات ووظائف الحافة للعمل من جانب الخادم.

النتيجة المتوقعة: يمكن نشر سلوك قاعدة البيانات والخادم بشكل متكرر.
6

قم بتحديث شكل API إذا كان عامًا

قم بإضافة أو توسيع معالجة الإجراءات في supabase/functions/public-api/index.ts وتوثيق سلوك x-api-key.

النتيجة المتوقعة: يمكن لعمليات التكامل استخدام الميزة بأمان.
7

تحديث مستندات التطبيق والوثائق العامة

قم بتحديث مستندات المطور داخل التطبيق وصفحة /الوثائق هذه مع لقطات الشاشة وخطوات النقر بنقرة.

النتيجة المتوقعة: يرى المستخدمون والمهندسون الميزة في كلا المكانين.
8

تشغيل الشيكات

قم بإجراء اختبارات/إنشاء التطبيق، ومُحسِّن تحسين محركات البحث (SEO) في الموقع العام، وعمليات فحص خريطة الموقع، والتحقق من المتصفح.

النتيجة المتوقعة: تعمل الميزة محليًا ويظل الموقع العام قابلاً للزحف.
كيفية اختباره: افتح المسار الجديد، واستخدم الميزة من البداية إلى النهاية، وافحص أخطاء وحدة التحكم/الشبكة، وتحقق من أي تغييرات في قاعدة البيانات من واجهة المستخدم.
مشكلةإصلاح
يعمل الطريق ولكن لا يتم تسليط الضوء على التنقلتحقق من مطابقة مسار الشريط الجانبي وأعد توجيه المسارات.
تعمل البيانات محليًا ولكن لم يتم نشرهاقم بتأكيد الترحيل وسياسات RLS ومتغيرات بيئة وظيفة الحافة.
المستندات العامة مفقودة من خريطة الموقعقم بتشغيل مُحسِّن تحسين محركات البحث (SEO) وافحص sitemap.xml بحثًا عن URL المتعارف عليه.

ما يجب القيام به بعد ذلك: قم بالتقاط أو إعادة إنشاء لقطات شاشة للتوثيق كلما تغيرت واجهة المستخدم.

سير عمل صيانة المستندات

قم بتحديث صفحة الوثائق العامة هذه بعد تغييرات المنتج

ما هذا من أجل: استخدم هذا عند تغيير لقطات الشاشة أو سير العمل أو سلوك API أو التنقل.

قبل أن تبدأ
  • استخدم البيانات التجريبية الآمنة فقط.
  • لا تكشف أبدًا عن العملاء الحقيقيين أو رسائل البريد الإلكتروني أو تفاصيل الدفع أو مفاتيح API أو conversations الخاصة.
  • قم بتحديث الدليل الإنجليزي أولاً، ثم حدّث كل صفحة وثائق مترجمة قبل فحوصات SEO.
1

تدقيق المسار الذي تم تغييره

افتح مسار التطبيق وحدد ما تغير بصريًا وإجرائيًا.

النتيجة المتوقعة: أنت تعرف أي صفوف من الأدلة ولقطات الشاشة واستكشاف الأخطاء وإصلاحها تحتاج إلى تعديلات.
2

التقاط أو إنشاء لقطة شاشة آمنة

استخدم مساحة عمل تجريبية وقم بإخفاء الأسرار قبل حفظ أصول WebP ضمن الأصول/الوثائق.

النتيجة المتوقعة: لقطة الشاشة دقيقة وآمنة للنشر.
3

قم بتحديث الدليل

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

النتيجة المتوقعة: يخبر الدليل المستخدمين بما يجب النقر عليه وما يجب أن يحدث بعد كل نقرة.
4

قم بتحديث التنقل إذا لزم الأمر

أضف القسم إلى جدول المحتويات الثابت ومنتقي أقسام الهاتف المحمول والفهرس المرئي إذا كانت صفحة رئيسية.

النتيجة المتوقعة: يمكن للقراء العثور على المحتوى الجديد بسرعة.
5

تشغيل أدوات تحسين محركات البحث

قم بتشغيل أدوات العقدة/seo-optimize-static-pages.js وأدوات العقدة/seo-optimize-static-pages.js --check.

النتيجة المتوقعة: تظل مخرجات البيانات الأساسية والبيانات التعريفية وخريطة الموقع والروبوتات صحيحة.
6

قم بتشغيل عمليات التنظيف والتحقق من الفرق

قم بتشغيل أدوات العقدة/static-translation-cleanup.js --audit و git diff --check.

النتيجة المتوقعة: الترجمات الثابتة والمسافات البيضاء نظيفة.
7

التحقق من المتصفح

خدمة الموقع محليًا واختبار/التوثيق على سطح المكتب والهاتف المحمول.

النتيجة المتوقعة: يتم تحميل الصور، ويعمل البحث، وتعمل أزرار النسخ، وإبراز جدول المحتويات، ولا يتداخل التخطيط مع شعار ملف تعريف الارتباط.
كيفية اختباره: ابحث عن اسم الميزة التي تم تغييرها في /documentation وتأكد من ظهور كتلة الدليل الصحيحة.
مشكلةإصلاح
علامات لقطة الشاشة تنجرف على الهاتف المحمولاحتفظ بالعلامات داخل صورة لقطة الشاشة أو استخدم إحداثيات العلامة سريعة الاستجابة.
البحث يفتقد الدليل الجديدأضف كلمات رئيسية مفيدة إلى عنوان البيانات وقم بتضمين مصطلحات المنتج الدقيقة التي يبحث عنها المستخدمون.
تصبح الوثائق المترجمة قديمةبعد تعديل الدليل الإنجليزي، حدّث كل صفحة وثائق مترجمة، وشغّل محسّن SEO مرة أخرى، وتأكد من أن sitemap.xml يتضمن كل عنوان URL للوثائق.

ما يجب القيام به بعد ذلك: قم بتنفيذ تغييرات صفحة المستندات والأصول وروابط الرأس/التذييل و.htaccess وخريطة الموقع معًا.

هل تحتاج إلى مرجع API المركّز؟

تظل صفحة /api-docs الأقدم متاحة لتفاصيل API على مستوى نقطة النهاية.

افتح مستندات API