تتبّع الدعوات

يسجّل تتبّع الدعوات الدعوةَ التي استخدمها كل عضو جديد، ويحتسبها للعضو الذي أنشأها. وهو يعمل في كل سيرفر منذ لحظة دخول Epix إليه، فلا يوجد ما تحتاج إلى تشغيله. ما تختاره أنت هو طريقة معرفة مصدر كل انضمام، وأين تُسجَّل حالات الانضمام والعودة والمغادرة، إن أردت تسجيلها أصلًا.

#أين تضبطه

• صفحة الدعوات في لوحة التحكم، وفيها تبويبات: لوحة الصدارة، والبحث عن عضو، والسجلات والرسائل، والتتبّع. وفيها تُكتب رسائل السجلات المخصصة.
• أوامر ‎/invites داخل ديسكورد.

#الأوامر

/invites mode mode:mixed
/invites setlog channel:#invite-log leave:false
/invites leaderboard limit:25

#أوضاع التتبّع

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

وضعا Hybrid و Mixed يحتاجان صلاحية Manage Server، لأنها ما يتيح لـEpix قراءة قائمة دعوات السيرفر. وعند التبديل يقرأ Epix القائمة فورًا ويخبرك إن لم يستطع. وإلى أن يستطيع، يلجأ Mixed إلى API في كل انضمام، ويسجّل Hybrid حالات الانضمام بداعٍ غير معروف.

بعض حالات الانضمام لا يوجد من تُحتسب له، وهي التي تأتي عبر: الرابط المخصص للسيرفر (Vanity URL)، أو Server Discovery، أو Student Hub، أو البحث عن الأعضاء، أو بوت، أو دعوة لا يُعرف منشئها. هذه تُسجَّل مع مصدرها ولا تُحتسب لأحد.

#كيف تُحتسب الدعوات

• إجمالي الداعي هو عدد حالات الانضمام لأول مرة المحتسبة له.
• العضو الذي يعود يُعدّ «عودة». تُسجَّل على هذا الأساس مع عدّاد متراكم لمرات عودته، ولا تُضاف إلى إجمالي أحد، حتى لو عاد عبر دعوة شخص آخر.
• العضو الذي يغادر يبقى ضمن إجمالي من دعاه. يُعلَّم بأنه غادر، وتعرض لوحة التحكم لكل داعٍ عدد من بقي ممن أحضرهم وعدد من غادر.
• لا تُعرف العودة إلا لعضو سبق أن احتسبه Epix لداعٍ ما. فالعضو الذي دخل أول مرة عبر الرابط المخصص، أو قبل إضافة Epix، يُعدّ انضمامًا لأول مرة عند أول دعوة تُحتسب له.

#سجلات الانضمام والعودة والمغادرة

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

الأمر ‎/invites setlog يرسل السجلات التي تختارها إلى قناة واحدة. أما في لوحة التحكم، فيمكن أن يكون لكل سجل قناته ورسالته: نص حتى 2,000 حرف، أو حتى 10 Embeds، أو كلاهما، مع معاينة حيّة. وإلى أن تكتب رسالتك، تُستخدم الرسالة الافتراضية بلغة سيرفرك. ولوحة التحكم ترفض أي قناة لا يستطيع Epix النشر فيها.

**{{user.username}}** joined using invite **{{inviteCode}}** from **{{inviter.username}}**. They now have **{{inviteCount}}** invites.

الإشارات داخل السجل لا ترسل تنبيهًا لأحد أبدًا. ورابط الصورة الشخصية يصلح صورةً أو صورة مصغّرة داخل Embed.

#لوحة التحكم

• لوحة الصدارة: أكثر الأعضاء دعوةً، عشرةً في كل مرة، مع عدد من بقي وعدد من غادر ممن أحضرهم كل واحد منهم. اختر أحدهم لترى من دعاهم.
• البحث عن عضو: من دعا عضوًا ما، وكل من أحضرهم هو.
• الأرقام الأخيرة: حالات الانضمام في آخر 7 أيام وآخر 30 يومًا، وحالات العودة في آخر 30 يومًا، وعدد الأعضاء المتتبَّعين، وكم منهم غادر.
• السجلات والرسائل، والتتبّع: السجلات والوضع، كما شُرحا أعلاه.

#الصلاحيات التي يحتاجها Epix

لا توجد في تتبّع الدعوات أي ميزات حصرية لـPremium.

#حل المشكلات

• حالات الانضمام تظهر بداعٍ غير معروف: في وضع Hybrid يحدث هذا كلما كانت المقارنة غير حاسمة، فانتقل إلى Mixed. وفي Hybrid أو Mixed، تأكد أيضًا أن Epix يملك صلاحية Manage Server.
• سجلات الانضمام تصل متأخرة: في وضع API ينتظر السجل إجابة ديسكورد. أما Mixed فيحسم أغلب حالات الانضمام فورًا.
• لا شيء يُسجَّل: شغّل ‎/invites viewlog. السجل الذي ليست له قناة مطفأ.
• تاريخ العضو طويل: «البحث عن عضو» في لوحة التحكم أسهل قراءةً من ‎/invites info.