التذاكر

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

#قبل أن تبدأ

• شغّل إضافة التذاكر بالأمر /enable addon:tickets (يحتاج Administrator). أوامر التذاكر ترفض العمل حتى تُشغَّل.
• يحتاج Epix صلاحية Manage Channels لإنشاء التذاكر، و Manage Roles لضبط صلاحياتها، و Attach Files في أي قناة تُرسل إليها النسخ النصية.
• الأمران /ticketpanel و /ticketblacklist يحتاجان Manage Server.

#إعداد لوحة

1. 01
   أنشئ اللوحة

   بالأمر /ticketpanel create. أنشئ لوحة لكل فريق أو موضوع: فلكل لوحة إعداداتها وترقيم تذاكرها الخاص.

2. 02
   اختر أين تُنشأ التذاكر

   عبر الحقل category في /ticketpanel set. ديسكورد يحدّ التصنيف الواحد بـ50 قناة، فحدّد من الآن لا لاحقًا تصنيفًا للتذاكر المغلقة (closed-category) أو عادةً ثابتة في حذفها.

3. 03
   اختر من يراها

   الأمر /ticketpanel addrole يضيف رتبة دعم. ورتب الدعم تحصل على وصول إلى كل تذكرة لحظة فتحها. والوصول يُطبَّق على كل قناة في تلك اللحظة، فإضافة رتبة لاحقًا لا تمنحها وصولًا إلى التذاكر المفتوحة بالفعل.

4. 04
   انشرها

   الأمر /ticketpanel send ينشر اللوحة. والأمر /ticketpanel settings يغيّر الإعدادات من قوائم، ولوحة التحكم تعدّل لوحة التذاكر ذاتها.

/ticketpanel create name:Support
/ticketpanel set panel:Support field:category value:<category ID>
/ticketpanel addrole panel:Support role:@Support
/ticketpanel send panel:Support channel:#help

#الأزرار والقوائم والنماذج

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

• الرسالة تستخدم أزرارًا أو قائمة اختيار، لا الاثنين معًا، وبحد أقصى 25 من أيٍّ منهما (/ticketpanel addbutton و addselect).
• أي زر أو خيار يمكنه أن يطرح أولًا ما يصل إلى خمسة أسئلة، في نموذج ديسكورد يُضبط من لوحة التحكم. والسؤال قد يكون سطرًا واحدًا أو فقرة، وقد يكون اختياريًا، أو يقبل الأرقام فقط. تُنشر الإجابات داخل التذكرة؛ وفي حالة زر الفتح، تظهر تحت رسالة الترحيب.
• كل عناصر التحكم في اللوحة الواحدة تفتح النوع نفسه من التذاكر. ولتوجيه أسئلة الفوترة والأسئلة التقنية إلى فريقين مختلفين، أنشئ لوحتين.

#من يستطيع فتح تذكرة

#الاستلام

يستلم عضو الدعم التذكرة بالأمر /ticket claim أو بزر الاستلام. والسلوك الافتراضي كالتالي:

• الاستلام حصري: يُضاف المستلم إلى القناة وتُزال منها رتب الدعم. وإلغاء استلام التذكرة يعيد إليها وصولها.
• أمام المستلم 30 دقيقة لإرسال أول رد، ويُنبَّه قبل انتهاء المهلة بـ5 دقائق، وإن فاتته المهلة يُلغى استلام التذكرة تلقائيًا. ورده يوقف العدّاد.
• يستطيع عضو الطاقم أن يستلم تذكرة واحدة في كل مرة. ارفع max-claim، أو اجعله 0 لإلغاء الحد.
• الأمر /ticket transfer يسلّم تذكرة مستلمة إلى عضو آخر يحق له الاستلام، ويعيد بدء المهلة له.

#التجميد

الأمر /ticket freeze يوقف مؤقتًا تذكرة تنتظر شيئًا ما، ويمكن تحديد مدة مثل 2d، تصل افتراضيًا إلى 7 أيام. ومن دون مدة — وزر التجميد لا يحدد مدة أبدًا — تبقى التذكرة مجمّدة حتى يُنفَّذ /ticket unfreeze.

• التذكرة المجمّدة لا يُلغى استلامها تلقائيًا ولا تُغلق تلقائيًا أبدًا، ومهلة الرد فيها تُستأنف من حيث توقفت عند فك التجميد.
• لا يمكن إغلاقها أثناء التجميد، ولا يمكن استلامها أيضًا افتراضيًا.
• عند تشغيل freeze-lock (مطفأ افتراضيًا)، يستطيع صاحب التذكرة والأعضاء المضافون القراءة دون إرسال رسائل. أما الطاقم فيظل قادرًا على الرد. وتصنيف التذاكر المجمّدة (frozen-category) يُبعد التذاكر المجمّدة عن الطريق.

#الإغلاق وإعادة الفتح والحذف

• الإغلاق ينزع وصول صاحب التذكرة والأعضاء المضافين لكنه يُبقي القناة، فيظل الطاقم قادرًا على قراءتها، وينقلها إلى تصنيف التذاكر المغلقة إن كان محددًا. ويستطيع صاحب التذكرة إغلاقها بنفسه ما لم تُطفئ ذلك؛ والخيار confirm-close يضيف خطوة تأكيد.
• إعادة الفتح تعيد وصولهم إلى القناة نفسها، فيبقى السجل في مكان واحد.
• الحذف يزيل القناة، ولا يُنشئ نسخة نصية من تلقاء نفسه — خذ نسخة أولًا، أو استخدم زر النسخة النصية في إشعار الإغلاق. والأمر /ticket delete delay:30s ينشر إشعارًا وينتظر، حتى دقيقة واحدة، قبل الحذف.
• الإغلاق التلقائي مطفأ افتراضيًا. وعند تشغيله، يُغلق التذكرة بعد 3 أيام بلا رسائل وينبّه قبلها بيوم. وأي رسالة من أي أحد غير Epix تعيد ضبط العدّاد.

#النسخ النصية

النسخة النصية ملف يضم المحادثة، بصيغة HTML افتراضيًا أو نصًا عاديًا، يُبنى من الرسائل التي حفظها Epix لحظة إرسالها.

• الأمر /ticket transcript ينشرها في المكان الذي نفّذت فيه الأمر. أما زر النسخة النصية فيرسلها إلى قناة النسخ النصية، أو إلى قناة السجلات إن لم تكن هناك قناة للنسخ.
• الخيار transcript-auto يُنشئ نسخة عند كل إغلاق (مطفأ افتراضيًا). والإغلاق التلقائي يُنشئ نسخة ما لم تُطفئ ذلك. والخيار transcript-dm يرسل نسخة إلى صاحب التذكرة أيضًا.
• تتسع النسخة النصية افتراضيًا لـ1,000 رسالة، و5,000 كحد أقصى.
• رسائل التذاكر تُحفظ 90 يومًا في السيرفر المجاني، وبشكل دائم مع Premium. ومع Premium، حتى قناة التذكرة التي تُحذف خارج Epix — يدويًا أو في هجوم تدميري — تصل نسختها النصية إلى قناة النسخ النصية أو قناة السجلات.

#أسماء القنوات وحدّ إعادة التسمية

تُسمّى التذاكر من قوالب: ticket-{number} عند الفتح، ثم claimed-{number} و frozen-{number} و closed-{number}. الرقم يُكمَّل بأصفار في أوله (ticket-0042) ويُعدّ لكل لوحة على حدة. وتقبل القوالب أيضًا {user}، وهو اسم مستخدم صاحب التذكرة، و {claimer}. تغيير القوالب ميزة Premium؛ أما الأمر /ticket rename فيعيد تسمية تذكرة واحدة يدويًا في أي سيرفر.

#مواعيد العمل (Premium)

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

• الأمر /ticketpanel schedule يضيف فترات لكل الأيام أو ليوم واحد من الأسبوع، تُكتب بصيغة 5 PM أو 17:00، وبحد أقصى 25 فترة لكل لوحة. ويمكن أن تمتد الفترة بعد منتصف الليل، مثل 22:00 إلى 02:00.
• تتبع الساعات المنطقة الزمنية للوحة، وتُكتب باسم IANA مثل Africa/Cairo (الافتراضي UTC)، فتبقى 17:00 هي 17:00 عند تغيّر التوقيت الصيفي.
• لا يسري شيء حتى تنفّذ الإجراء enable. وإذا فقد السيرفر Premium، يتوقف تطبيق الجدول.

#من يستطيع فعل ماذا

مالك السيرفر وكل من يملك Administrator أو Manage Server أو Manage Channels يستطيع فعل كل شيء. وفيما عدا ذلك، يعود كل إجراء إلى رتب الدعم في اللوحة، ما لم تخصص له لوحة التحكم قائمة رتب خاصة به (الإغلاق، الحذف، النسخة النصية، إعادة التسمية، الأعضاء، الاستلام، التجميد). ويستطيع صاحب التذكرة إغلاقها (مفعّل افتراضيًا) وحذفها (مطفأ افتراضيًا).

تغيير نص الرسائل بالأمر /ticketpanel message ميزة Premium. ويستطيع السيرفر المجاني تغيير تنسيق أول Embed في كل رسالة بالأمر /ticketpanel embed؛ أما الـEmbeds الإضافية، حتى عشرة، فهي Premium.

#السجلات والإحصاءات

حدّد قناة سجلات (log-channel) وسينشر فيها Epix سطرًا عند كل حدث من 16 حدثًا للتذاكر: الفتح، والإغلاق، والإغلاق التلقائي، والحذف، والاستلام، وإلغاء الاستلام، وإلغاء الاستلام التلقائي، والتحويل، والتجميد، وفك التجميد، وإعادة الفتح، وإنشاء نسخة نصية، وتغيير الأولوية، وتغيير الموضوع، وإضافة عضو، وإزالة عضو. والأمر /ticket stats يعرض التذاكر المستلمة والمغلقة والملغى استلامها تلقائيًا والمفتوحة، ومتوسط زمن أول رد، للفريق أو لعضو واحد، خلال فترة مثل 30d.

#مرجع الأوامر