يحوّل بوت تحليلات خادم Discord عمليات الانضمام الخام وفتح التذاكر ودفعات الفواتير إلى تقرير تقرؤه بنظرة واحدة، سواء كان Embed داخل Discord أو صفحة على لوحة تحكم الويب. يفعل Noxyr ذلك عبر أمرين شرطيين هما /status و/sales، وصفحة نظرة عامة في لوحة التحكم، وواجهة خادم للقراءة فقط تعرض الأرقام نفسها على موقعك. يشرح هذا الدليل ما يعرضه كل منها فعلاً.

An authenticated API request reaches the Noxyr server and returns JSON with a depleting rate limit. GET /api/v1/server Authorization: Bearer •••••• Noxyr API { "id": "48213" "prefix": "!" "premium": true } RateLimit 60 33 60

/status: إحصاءات الأعضاء والتذاكر والمجتمع

/status أمر مخصص للمسؤولين فقط، وله خمسة عروض: all وinvite وsales وtickets وcommunity. كل عرض يقبل خيار days (7 أو 14 أو 30، والافتراضي 30) ويعيد Embed مرفقاً به مخطط خطي، فيعمل كفحص سريع للأرقام وكعرض للاتجاهات معاً.

  • /status invite: عمليات الانضمام والمغادرة لليوم وآخر 7 أيام والفترة المختارة، معروضة كصافي تغيّر مع أعداد الإضافة والحذف الخام أسفلها.
  • /status tickets: التذاكر التي فُتحت وأُغلقت، وعدد التذاكر المفتوحة الآن. هذه أكثر إحصاءات التذاكر التي يطلبها مسؤولو Discord: هل تتراكم التذاكر، أم أن الفريق يواكب الطلب؟
  • /status sales: عدد الفواتير وإجمالي قيمتها. الإجمالي مجموع بسيط وليس تحويل عملات، لأن الفواتير قد تُصدر بأكثر من عملة، والتحويل سيعني تخمين سعر صرف.
  • /status community: عدد المراجعات وحجم الرسائل، لقراءة النشاط العام بدلاً من الدعم أو الإيرادات.
  • /status all: كل الحقول أعلاه في Embed واحد، لملخص صباح يوم الاثنين.

يُرسم المخطط على الخادم ويُرفق كصورة. إذا فشل رسم المخطط لأي سبب، يرد الأمر بالأرقام كنص بدلاً من أن يفشل كلياً. تبدأ عدادات الأعضاء والرسائل من اليوم الذي انضم فيه Noxyr إلى الخادم، لذلك لن يُظهر بوت أُضيف الشهر الماضي تاريخاً يمتد لسنوات.

/sales: الإيرادات وأفضل المشترين وتنسيق التقرير

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

  • /sales report: الإيرادات للفترة، وعدد الطلبات المدفوعة، والوحدات المباعة، وعدد الفواتير، وتفصيل حسب الحالة (ناجحة، قيد الانتظار، فاشلة) وحسب طريقة الدفع، إضافة إلى أفضل المنتجات. خيارات الفترة: آخر 7 أيام، أو آخر 30 يوماً، أو آخر 90 يوماً، أو كل الوقت.
  • /sales top: لوحة صدارة للمشترين، مرتبة حسب عدد الطلبات أو حسب المبلغ المنفق، وقابلة للتصفية حسب العملة، وتعرض حتى 25 مشترياً.
  • /sales style: يضبط لون الـ Embed وصور اللافتة والصورة المصغّرة، وعناوين مخصصة للتقرير ولوحة الصدارة، ونص التذييل، والحجم الافتراضي للوحة الصدارة، وما إذا كانت أسماء المشترين تظهر بجانب الإشارة، وأي حالات فواتير تُحتسب كإيرادات. إيقاف الحالات الثلاث معاً مرفوض، لأن تقريراً لا يحتسب أي شيء كإيراد لا يفيد أحداً.

يتحقق كلا الأمرين من صلاحية Administrator أو من رتبة مسؤول مُعدّة قبل التشغيل، وهي البوابة نفسها التي تستخدمها لوحة التحكم.

ما تعرضه النظرة العامة في لوحة التحكم

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

قراءة الأرقام نفسها من موقعك: واجهة الخادم

إذا أردت إحصاءات خادم Discord على موقعك الخاص أو على صفحة الحالة أو في جدول بيانات، فإن واجهة الخادم (Server API) هي الجسر. وهي للقراءة فقط، ومحصورة بخادم واحد، وتعيد JSON للبيانات نفسها التي يتتبعها /status ولوحة التحكم بالفعل:

  • GET /api/v1/server: الاسم والأيقونة وعدد الأعضاء وعدد المتصلين والتعزيزات (boosts).
  • GET /api/v1/tickets: الإجماليات، وعدد المفتوحة والمغلقة، وحجم التذاكر خلال 7 و30 يوماً، ومتوسط التقييم.
  • GET /api/v1/activity?days=30: الرسائل اليومية وعمليات الانضمام والمغادرة، حتى 90 يوماً إلى الوراء.
  • GET /api/v1/invoices: عدد الفواتير والإيرادات حسب العملة والحالة.
  • GET /api/v1/reviews: متوسط التقييم، وتفصيل النجوم، وأحدث المراجعات العامة.
  • GET /api/v1/giveaways: عدد المسابقات النشطة والمنتهية، وإجمالي المشاركات.

أنشئ مفتاحاً من صفحة الـ API الخاصة بالخادم في لوحة التحكم، وأرسله كـ Bearer token. كل نقطة نهاية محمية بنطاق (scope) خاص بها، لذلك يمكنك مشاركة مفتاح يقرأ التذاكر فقط مثلاً دون كشف بيانات الفواتير. المفاتيح محدودة بـ 60 طلباً في الدقيقة، وهذا يكفي لأن إجماليات التذاكر والمبيعات لا تحتاج إلى الاستعلام أسرع من مرة في الدقيقة.

أسئلة شائعة

هل أحتاج إلى الواجهة لرؤية التحليلات؟ لا. يعمل /status و/sales دون أي إعداد، وتحتاج صفحة النظرة العامة في لوحة التحكم إلى تسجيل الدخول فقط. الواجهة مخصصة لنقل الأرقام إلى مكان خارج Discord.

هل يكلف /status أي شيء؟ لا. ليس لدى Noxyr مستوى مدفوع، لذلك كل عرض من /status و/sales متاح لكل خادم.

هل يستطيع الأعضاء رؤية هذه الإحصاءات؟ يتطلب الأمران صلاحية Administrator أو رتبة مسؤول مُعدّة، لذلك لا يستطيع الأعضاء العاديون تشغيلهما.

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

راجع قائمة الأوامر الكاملة في /commands، أو قارن بين تشغيل الأشياء من Discord ومن لوحة التحكم في لوحة التحكم مقابل الأوامر. أضف Noxyr مجاناً لتحصل على التحليلات والتذاكر والمتجر في بوت واحد.