مصمم الرسائل

مصمم الرسائل يحفظ الرسائل كقوالب. والقالب رسالة ديسكورد كاملة: نص و Embeds، أو تخطيط Components V2، ومعها أزرار وقوائم اختيار تنفّذ شيئًا حين يستخدمها أحد الأعضاء. تنشره حين يصبح جاهزًا، وتستطيع أجزاء أخرى من Epix أن ترسله نيابةً عنك: لوحة رتب التفاعل يمكنها أن تتخذ منه محتوى رسالتها، والأتمتة يمكنها الرد به أو إرساله، و Epix AI يستطيع إنشاء قوالب بسيطة ونشرها وحذفها حين تطلب منه ذلك.

#أين تصمّم الرسالة

• لوحة التحكم: صفحة مصمم الرسائل (Message Builder) ضمن قسم General. هذا هو المحرر الكامل، ومعه معاينة حية تُرسم كما يرسم ديسكورد الرسالة. ويحتاج صلاحية Manage Server.
• الأمر /messageflow: أداة بناء داخل ديسكورد لمن لديه JSON الرسالة جاهزًا، ومعها إجراءات سريعة لعرض القوالب وإرسالها وتصديرها وحذفها. يحتاج صلاحية Administrator، ولوحته نفسها تصفه بأنه تجريبي.

#إنشاء قالب من لوحة التحكم

1. 01
   سمِّه

   الاسم فريد داخل سيرفرك ويصل إلى 120 حرفًا. أما الوصف، حتى 1,000 حرف، فهو لطاقمك؛ الأعضاء لا يرونه أبدًا.

2. 02
   اختر نوع الرسالة

   النوع Classic محتوى نصي مع Embeds، وهي الطريقة التي تُبنى بها أغلب الرسائل. أما Components V2 فيبني الرسالة كلها من كتل تخطيط، وليس فيه محتوى أو Embeds منفصلة. ديسكورد يرفض الرسالة التي تخلط بين الاثنين، ولذلك فإن إعادة قالب إلى Classic تحذف كتل التخطيط فيه، والمحرر يسألك قبل أن يفعل ذلك.

3. 03
   أضِف الأزرار والقوائم

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

4. 04
   احفظ، ثم أرسل

   زر Save يخزّن القالب، وزر Send يسألك في أي قناة تنشره. ومفتاح Active بجانب الاسم يحدد هل يمكن إرسال القالب أصلًا.

#الحدود

#كتل Components V2

الصورة المصغّرة لا توجد إلا كصورة لقسم؛ أما الصورة المستقلة فاستخدم لها المعرض. وفي قالب Components V2 تعيش الأزرار داخل التخطيط، في كتلة أزرار، ولذلك لا تظهر قائمتا الأزرار والقوائم المنفصلتان الموجودتان في قالب Classic.

#ماذا يفعل الزر أو خيار القائمة

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

• إجراءات الرتب تحتاج أن يملك Epix صلاحية Manage Roles، وأن تكون أعلى رتبة لديه فوق الرتبة التي يوزّعها؛ وإلا تُرفض الضغطة.
• لا يمنح Epix أبدًا رتبة تحمل Administrator أو Manage Server أو Manage Roles أو Manage Webhooks. وإذا اكتسبت رتبة إحدى هذه الصلاحيات بعد إنشاء الزر، يتوقف الزر عن منحها.
• خيار إعادة التعيين يمسح اختيار العضو في القائمة دون أن يفعل أي شيء آخر. ديسكورد يتذكر آخر خيار اختاره العضو، فبدون هذا الخيار لا يُحتسب اختيار الخيار نفسه مرتين اختيارًا جديدًا. يمكن أن تحتوي القائمة على خيار إعادة تعيين واحد، ولا يحتاج إلى إجراء.
• يعرض المحرر أيضًا الخيار Custom handler. وهو يشغّل معالجًا مدمجًا في Epix عبر مفتاحه، ولا يوجد حاليًا أي معالج متاح للضبط، لذلك فإن عنصر التحكم المضبوط عليه يرد بأنه لا يوجد معالج مسجّل.

#المتغيّرات

تُستبدل المتغيّرات لحظة إرسال الرسالة أو تقديم الرد. وهي تعمل في النصوص وفي روابط الصور، فيمكن أن يكون {guild.avatar} صورة مصغّرة.

متغيّرات العضو تصف العضو الذي أطلق الرسالة: من ضغط الزر، أو من شغّل /messageflow send. القالب المنشور من لوحة التحكم ليس وراءه عضو كهذا، ولذلك تظهر هذه المتغيّرات فارغة في تلك الرسالة. ولعرض وقت مقروء، ضع {date.now.unix} داخل صيغة الطوابع الزمنية في ديسكورد.

Last updated <t:{date.now.unix}:f>

#الإرسال والتحديث

• زر Send في لوحة التحكم يتحقق من أن Epix يستطيع النشر في القناة قبل إرسال أي شيء.
• الإرسال مرة أخرى إلى القناة نفسها يعدّل الرسالة الموجودة هناك بدل نشر نسخة ثانية، فلا يكون لكل قالب إلا رسالة حية واحدة في القناة. وإذا كانت تلك الرسالة قد حُذفت، تُنشر رسالة جديدة.
• الأمر /messageflow send ينشر نسخة لمرة واحدة في القناة التي تشغّله فيها. وهذه النسخة ليست هي التي تعدّلها لوحة التحكم لاحقًا.
• حذف القالب لا يحذف الرسائل التي نُشرت منه؛ فهي تبقى في القناة. أما الزر الموجود في مكان آخر والذي يرد بالقالب المحذوف فيصبح عاجزًا عن إرساله.

#الأمر /messageflow

/messageflow
/messageflow action:builder
/messageflow action:edit template_id:<id>
/messageflow action:list
/messageflow action:send template_id:<id>
/messageflow action:export template_id:<id>
/messageflow action:delete template_id:<id>

أداة البناء لوحة تبقى مفتوحة عشر دقائق ولا تستجيب إلا لمن فتحها. زر Set Meta يأخذ name | type | description، حيث type إما NORMAL أو COMPONENTS_V2. وزر Import JSON يقبل JSON بصيغة Components V2 أو JSON لـ Embed، ملصوقًا أو مرفقًا كملف txt أو json، أو مأخوذًا من رسالة ترد عليها عند تشغيل الأمر. وزر Configure Actions يمرّ بك على كل عنصر تحكم ما زال يحتاج إجراءً، وزر Preview ينشر نسخة خاصة، وزر Save Template يرفض الحفظ ما دام هناك شيء غير صالح أو معلّق. ويعرض List حتى 25 قالبًا؛ ويرسل Export قالبًا واحدًا كملف JSON.

#المجاني و Premium

القوالب، وكل أنواع الكتل، والإجراءات الخمسة كلها، والإرسال: كلها مجانية. أما منح الرتب لمدة محددة فهو ضمن Premium: في أداة البناء الخاصة بـ /messageflow، يُسأل السيرفر الذي لديه Premium عن المدة التي تدومها الرتبة في إجراء «منح رتبة» أو «تبديل رتبة»، من دقيقة واحدة إلى 90 يومًا (30m، 2h، 3d، 1w)، أو الشرطة - لتكون دائمة.

#منح الرتب بالتفاعل

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

#حل المشكلات

• يقول Send إن بعض المكوّنات غير موصولة: هناك زر أو خيار بلا إجراء. حدّد له إجراءً، أو احذفه.
• زر «الرد بقالب» يقول إن القالب المستهدف غير موجود أو غير مفعّل: ذلك القالب حُذف أو أن مفتاح Active فيه مطفأ. اختر قالبًا آخر، أو أعِد تشغيله.
• زر رتبة لا يفعل شيئًا: تأكد أن Epix يملك Manage Roles، وأن أعلى رتبة لديه فوق تلك الرتبة، وأن الرتبة لا تحمل أيًّا من الصلاحيات الأربع التي لا يمنحها Epix.
• صورة تظهر كعنصر نائب في المعاينة: المتغيّر لا يشير إلى شيء، مثل {guild.banner} في سيرفر بلا بانر.
• البوت لا يستطيع النشر في القناة المختارة: امنح Epix صلاحية إرسال الرسائل هناك.