دليل المنتج
الإعدادات
كوّن إعدادات الحساب العامة، وأدر الوسائط، وأنشئ مفاتيح API، وأعدّ خطافات الويب، وتحكّم في القائمة البيضاء للنطاقات، وتعامل مع تذاكر الدعم في SkyLight Chat.
الإعدادات
التكوين المركزي لمساحة عمل SkyLight Chat الخاصة بك. أدر تفاصيل الحساب والوصول إلى API والتكاملات والدعم من مكان واحد.
الغرض
تتيح لك منطقة الإعدادات:
- تكوين مساحة العمل — اسم الشركة، المنطقة الزمنية، البلد.
- إدارة الوسائط — رفع وتنظيم وحذف الصور والفيديوهات.
- إنشاء مفاتيح API — إنشاء مفاتيح للوصول البرمجي.
- القائمة البيضاء للنطاقات — تقييد وصول API والأداة إلى مصادر موثوقة.
- إعداد خطافات الويب — استلام إشعارات الأحداث الفورية.
- التواصل مع الدعم — إنشاء وإدارة تذاكر الدعم.
صلاحيات الوصول
| القسم | المالك | المشرف | العضو | المشاهد |
|---|---|---|---|---|
| عام | كامل | كامل | عرض | عرض |
| مدير الوسائط | كامل | كامل | رفع/عرض | عرض |
| مفاتيح API | كامل | كامل | عرض | — |
| القائمة البيضاء للنطاقات | كامل | كامل | — | — |
| خطافات الويب | كامل | كامل | عرض | — |
| التذاكر | كامل | كامل | إنشاء/عرض | عرض |
الإعدادات العامة
تكوين مساحة العمل
- اذهب إلى الإعدادات ← عام.
- حدّث:
- اسم الشركة — يُعرض في لوحة التحكم والتقارير.
- العنوان — عنوان العمل (اختياري).
- المنطقة الزمنية — تؤثر على الجدولة والتقارير والطوابع الزمنية.
- البلد — يُحدد الإعدادات الافتراضية للمنطقة.
- انقر على حفظ.
مرجع الحقول
| الحقل | الوصف |
|---|---|
| اسم الشركة | اسم عرض مساحة العمل |
| العنوان | عنوان العمل |
| المنطقة الزمنية | المنطقة الزمنية IANA (مثال: Asia/Riyadh) |
| البلد | اختيار البلد (يؤثر على التنسيقات) |
مدير الوسائط
الغرض
تخزين الصور والفيديوهات للاستخدام في الحملات والقوالب وقاعدة المعرفة وردود الوكيل الذكي.
رفع الوسائط
- اذهب إلى الإعدادات ← مدير الوسائط.
- انقر على رفع أو اسحب وأفلت الملفات.
- التنسيقات المدعومة:
- الصور: JPG، JPEG، PNG، GIF (بحد أقصى 50 ميجابايت)
- الفيديوهات: MP4، AVI، MOV، WMV، FLV، WEBM (بحد أقصى 50 ميجابايت)
- تظهر الملفات في شبكة الوسائط فورًا.
إدارة الوسائط
| الإجراء | الطريقة |
|---|---|
| عرض التفاصيل | انقر على صورة مصغرة لفتح نافذة التفاصيل |
| إعادة التسمية | في النافذة، عدّل اسم العرض واحفظ |
| نسخ الرابط | انقر على أيقونة النسخ بجانب الرابط |
| حذف | انقر على حذف في النافذة؛ أكّد |
البحث والتصفية
- بحث بالاسم الملف أو اسم العرض.
- تصفية حسب النوع: الكل، صور، فيديوهات.
مرجع الحقول
| الحقل | الوصف |
|---|---|
| الاسم | اسم العرض (قابل للتعديل) |
| الاسم الأصلي | اسم الملف عند الرفع |
| الرابط | الرابط العام للملف |
| نوع الملف | image أو video |
| الحجم | حجم الملف بالبايت |
| رُفع بواسطة | client أو admin |
| تاريخ الإنشاء | طابع الرفع |
مفاتيح API
الغرض
تُصادق مفاتيح API الطلبات إلى REST API الخاص بـ SkyLight Chat. أنشئ مفاتيح للتكاملات والأتمتة والتطبيقات الخارجية.
إنشاء مفتاح
- اذهب إلى الإعدادات ← مفاتيح API.
- انقر على + إنشاء مفتاح.
- أدخل اسمًا (مثال: الخادم الإنتاجي، تكامل Zapier).
- انقر على إنشاء.
- انسخ المفتاح فورًا — يُعرض مرة واحدة فقط.
إدارة المفاتيح
| الإجراء | الطريقة |
|---|---|
| عرض المفاتيح | القائمة تُظهر الاسم، تاريخ الإنشاء، آخر استخدام |
| نسخ المفتاح | انقر على أيقونة النسخ (إذا كانت لا تزال مرئية) |
| إلغاء المفتاح | انقر على إلغاء؛ أكّد. يتوقف المفتاح عن العمل فورًا. |
أفضل ممارسات الأمان
- لا تشارك المفاتيح علنًا — لا تُرسلها إلى مستودعات الكود.
- بدّل المفاتيح دوريًا — ألغِ المفاتيح القديمة وأنشئ جديدة.
- استخدم متغيرات البيئة — خزّن المفاتيح في تكوين آمن.
- القائمة البيضاء للنطاقات — قيّد استخدام المفتاح للمصادر الموثوقة.
القائمة البيضاء للنطاقات
الغرض
تقييد طلبات API وتضمين الأداة لنطاقات محددة. تُرفض الطلبات من مصادر غير مدرجة في القائمة البيضاء.
إضافة نطاق
- اذهب إلى الإعدادات ← القائمة البيضاء للنطاقات.
- انقر على + إضافة نطاق.
- أدخل النطاق (مثال:
yourdomain.com،app.yourdomain.com). - انقر على إضافة.
إدارة النطاقات
| الإجراء | الطريقة |
|---|---|
| عرض النطاقات | القائمة تُظهر جميع النطاقات المسموحة |
| إزالة نطاق | انقر على أيقونة سلة المهملات؛ أكّد |
دعم أحرف البدل
- استخدم
*.yourdomain.comللسماح بجميع النطاقات الفرعية. - أحرف البدل تنطبق على النطاقات الفرعية فقط، وليس المسارات.
متى تستخدم
- أداة الدردشة الحية — تأكد من تحميل الأداة فقط على مواقعك.
- استدعاءات API من المتصفحات — منع الاستخدام غير المصرح به من الواجهة الأمامية.
- تكاملات الشركاء — أضف نطاقات الشركاء للقائمة البيضاء.
خطافات الويب
الغرض
استلام إشعارات HTTP فورية عند حدوث أحداث في حساب SkyLight Chat الخاص بك.
إنشاء خطاف ويب
- اذهب إلى الإعدادات ← خطافات الويب.
- انقر على + إنشاء خطاف ويب.
- أدخل:
- الاسم — تسمية وصفية (مثال: إشعارات الطلبات).
- الرابط — نقطة نهاية HTTPS الخاصة بك.
- الأحداث — اختر الأحداث للاشتراك فيها.
- انقر على إنشاء.
- انسخ السر — يُستخدم للتحقق من توقيعات خطاف الويب.
الأحداث المتاحة
| الحدث | الوصف |
|---|---|
contact.created | جهة اتصال جديدة أُضيفت |
contact.updated | تفاصيل جهة الاتصال تغيرت |
contact.deleted | جهة الاتصال أُزيلت |
message.received | رسالة واردة من جهة اتصال |
message.sent | رسالة صادرة أُرسلت |
booking.created | حجز جديد أُنشئ |
booking.updated | الحجز عُدّل |
booking.cancelled | الحجز أُلغي |
booking.completed | الحجز اكتمل |
order.created | طلب جديد قُدّم |
order.updated | حالة الطلب تغيرت |
order.cancelled | الطلب أُلغي |
order.delivered | الطلب وُصّل |
ticket.created | تذكرة دعم جديدة |
ticket.replied | رد أُضيف للتذكرة |
campaign.started | الحملة بدأت الإرسال |
campaign.completed | الحملة انتهت |
web_chat.session_started | جلسة دردشة حية فُتحت |
web_chat.message_received | رسالة في الدردشة الحية |
إدارة خطافات الويب
| الإجراء | الطريقة |
|---|---|
| تعديل | افتح خطاف الويب؛ غيّر الاسم أو الرابط أو الأحداث |
| تعطيل | بدّل نشط إلى إيقاف |
| حذف | انقر على حذف؛ أكّد |
| اختبار | انقر على إرسال اختبار لإرسال حمولة اختبارية |
| عرض السجلات | افتح خطاف الويب؛ راجع سجل التسليم |
سجلات التسليم
| العمود | الوصف |
|---|---|
| نوع الحدث | أي حدث أُرسل |
| الحالة | pending، delivered، failed |
| رمز الاستجابة | حالة HTTP من خادمك |
| المحاولة | رقم محاولة التسليم |
| وُصّل في | طابع التسليم الناجح |
التحقق من التوقيع
يتضمن كل خطاف ويب ترويسة X-SkyLight-Signature. تحقق منها باستخدام HMAC-SHA256 مع سر خطاف الويب الخاص بك. راجع أمان خطافات الويب لتفاصيل التنفيذ.
إعادة إنشاء السر
- افتح خطاف الويب.
- انقر على إعادة إنشاء السر.
- انسخ السر الجديد فورًا.
- حدّث خادمك لاستخدام السر الجديد.
تذاكر الدعم
الغرض
تواصل مع دعم SkyLight Chat مباشرة من لوحة التحكم. تتبع المشاكل واطرح الأسئلة واستلم الردود دون مغادرة التطبيق.
إنشاء تذكرة
- اذهب إلى الإعدادات ← التذاكر.
- انقر على + تذكرة جديدة.
- املأ:
- الموضوع — وصف موجز للمشكلة.
- المحتوى — شرح تفصيلي.
- الأولوية — منخفضة، متوسطة، عالية.
- القسم — الفوترة، الدعم الفني، المبيعات (إن كان منطبقًا).
- انقر على إرسال.
عرض التذاكر
| العمود | الوصف |
|---|---|
| رقم التذكرة | مرجع يمكن قراءته (مثال: ABX9Y2KL) |
| الموضوع | عنوان التذكرة |
| الحالة | open، answered، closed |
| الأولوية | منخفضة، متوسطة، عالية |
| آخر رد | طابع أحدث استجابة |
الرد على تذكرة
- افتح التذكرة.
- اقرأ سجل المحادثة.
- اكتب ردك في حقل الإدخال.
- انقر على إرسال.
الرد على تذكرة answered يُعيد فتحها إلى open.
إغلاق تذكرة
- افتح التذكرة.
- انقر على إغلاق التذكرة.
- أكّد.
لا يمكن للتذاكر المغلقة استلام مزيد من الردود.
حالات التذاكر
| الحالة | المعنى |
|---|---|
| مفتوحة | في انتظار رد الدعم |
| مُجاب عليها | الدعم رد؛ في انتظار ردك |
| مغلقة | المشكلة حُلّت؛ لا يتطلب إجراء إضافي |
الروابط مع المناطق الأخرى
| الميزة | كيفية الارتباط |
|---|---|
| الحملات | تستخدم الوسائط من مدير الوسائط |
| الوكلاء الأذكياء | يمكن للوكلاء إرسال الوسائط في الردود |
| الدردشة الحية | الأداة تحترم القائمة البيضاء للنطاقات |
| API | مفاتيح API تُصادق جميع طلبات API |
| خطافات الويب | خطافات الويب تُسلّم الأحداث لخوادمك |
الحدود وسلوك الخطط
| القسم | Starter | Pro | Business | Enterprise |
|---|---|---|---|---|
| مفاتيح API | 2 | 5 | 10 | غير محدود |
| النطاقات المدرجة | 2 | 5 | 10 | غير محدود |
| خطافات الويب | 2 | 5 | 10 | غير محدود |
| تخزين الوسائط | 500 ميجابايت | 2 جيجابايت | 10 جيجابايت | غير محدود |
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| مفتاح API لا يعمل | المفتاح أُلغي أو غير صحيح | أنشئ مفتاحًا جديدًا؛ تحقق من صحة المفتاح المستخدم |
| خطاف الويب لا يستلم الأحداث | الرابط غير قابل للوصول أو خاطئ | تحقق من أن نقطة النهاية متاحة علنيًا؛ تحقق من الرابط |
| توقيع خطاف الويب غير صالح | سر خاطئ مُستخدم | انسخ السر الصحيح من إعدادات خطاف الويب |
| فشل رفع الوسائط | الملف كبير جدًا أو تنسيق خاطئ | تحقق من حجم الملف (بحد أقصى 50 ميجابايت) والتنسيقات المدعومة |
| القائمة البيضاء للنطاقات تحظر الطلبات | النطاق غير مضاف | أضف النطاق للقائمة البيضاء |
| التذكرة لا تستلم ردودًا | التذكرة مغلقة | أعد الفتح بالرد أو أنشئ تذكرة جديدة |
مقالات ذات صلة
- API الحساب — إدارة الحساب برمجيًا
- API الوسائط — رفع وإدارة الوسائط عبر API
- دليل خطافات الويب — تنفيذ خطافات الويب بالتفصيل
- API خطافات الويب — إدارة خطافات الويب عبر API
- API التذاكر — إنشاء وإدارة التذاكر عبر API