> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.
# كيف تعمل الإشعارات
> أعلن عن البثوث الجديدة ومقاطع الفيديو والمنشورات والحلقات من ثماني منصات خارجية مباشرةً في خادم ديسكورد الخاص بك.
يراقب فيتوكس ثماني منصات خارجية وينشر إعلانًا في سيرفرك عندما يظهر شيء جديد.
## يجب أن تتحقق ثلاثة أمور
هذا هو السبب الأكثر شيوعًا لظهور الإشعارات على أنها لا تعمل. الأمور الثلاثة كلها مطلوبة، وواحد منها فقط مرئي على صفحة الإشعارات نفسها.
كل منصة تتطلب على الأقل مستوى **بيسك**. تُرفض إضافة اشتراك على ستارتر برسالة تذكر اسم المنصة.
يُجرى الفحص مرتين — مرة عند إضافة العنصر، ومرة أخرى في اللحظة التي سيُرسل فيها الإعلان.
كل منصة لها مفتاحها الخاص في صفحة [إعداد السيرفر](/ar/server-management/setup)، وهو **معطّل افتراضيًا**. إعداد الإشعار نفسه لا يكفي.
لا تُظهر أي من صفحتَي الإشعارات حالة هذا المفتاح. سيبقى الموجز المُعدّ بالكامل والمدفوع باشتراك بريميوم صامتًا ولن يُطلق أبدًا، دون أي مؤشر في أي مكان في واجهة الإشعارات. **تحقق من إعداد السيرفر أولًا.**
يحتاج فيتوكس إلى صلاحيات **View Channel** و**Send Messages** و**Embed Links** في القناة المستهدفة. راجع أدناه.
## الحدود
**10 عناصر لكل منصة، لكل سيرفر** — 10 من ستريمرز تويتش، و10 قنوات يوتيوب، و10 subreddits، وهكذا.
هذا حد ثابت للمنتج. **لا** يزداد مع مستوى بريميوم أعلى، وهو نفسه في بيسك وماكس وبلاك.
## مدى سرعة وصول الإشعارات
يقوم فيتوكس باستطلاع كل منصة وفق جدول محدد. يصل الإعلان في الاستطلاع التالي بعد ظهور المحتوى.
| المنصة | يُفحص كل | فترة تهدئة لكل مصدر |
| -------- | -------- | ------------------- |
| تويتش | 60 ثانية | 10 دقائق |
| كيك | 60 ثانية | 10 دقائق |
| بلوسكاي | 60 ثانية | دقيقتان |
| ريديت | 3 دقائق | دقيقتان |
| ستيم | 3 دقائق | دقيقتان |
| يوتيوب | 5 دقائق | 10 دقائق |
| RSS | 5 دقائق | 5 دقائق |
| Podcasts | 5 دقائق | 5 دقائق |
**فترة التهدئة** هي حد أدنى بين إعلانين لنفس المصدر، مستقلة عن فاصل الاستطلاع. الـ subreddit الذي ينشر ثلاث مرات في دقيقة ينتج إعلانًا واحدًا لا ثلاثة.
يقوم بالاستطلاع مثيل واحد منتخب، لذا لا يستقبل السيرفر المزدحم أبدًا نسخًا مكررة من عمّال متوازيين.
### نموذجان مختلفان للتتبع
| النموذج | المنصات | السلوك |
| ------------------- | ------------ | ------------------------------------------------------------------------------------ |
| **الحالة المباشرة** | تويتش وكيك | يتتبع ما إذا كان البث مباشرًا أو غير متصل، ويُعلن في اللحظة التي *تتغير* فيها الحالة |
| **المحتوى الجديد** | الستة الأخرى | يتتبع العناصر الفردية ويُعلن كل عنصر جديد مرة واحدة |
**إضافة ستريمر يبث بالفعل لا تُنتج شيئًا.** يتفعّل متتبع الحالة المباشرة فقط عند الانتقال من غير متصل → متصل. إذا أضفت شخصًا أثناء بثه، فإن أول إعلان تحصل عليه سيكون بثه *التالي*.
اختبر بشخص غير متصل حاليًا، أو انتظر ببساطة.
تُتبع حالة البث/عدم البث **لكل ستريمر، وليس لكل سيرفر**. إذا تابع عدة سيرفرات نفس الستريمر، فإنها تعتمد على حالة مشتركة واحدة.
## ما لن يُعلَن عنه
إضافة اشتراك لا تُعبِّئ المحتوى القديم أبدًا. يُعلَن فقط عن المحتوى المنشور بعد إضافتك للعنصر، لذا لا تُغرَق قناتك أثناء الإعداد.
بالنسبة للمنصات الست القائمة على المحتوى، أي شيء نُشر منذ أكثر من ساعتين يُتجاهل حتى لو لم يره فيتوكس من قبل. هذا يمنع إغراق قناتك بمتراكم بعد انقطاع.
العنصر الذي لا يوفر موجزه تاريخ نشر مقروءًا يتجاوز هذا الفحص ويمكن الإعلان عنه بغض النظر عن العمر. هذا أحيانًا هو سبب ظهور عنصر RSS قديم.
كل عنصر أُعلن عنه يُتذكّر لمدة **7 أيام**، لكل سيرفر، لذلك لا يمكن أن يُنتج إعادة تشغيل أو استطلاع بطيء نسخة مكررة. يحصل السيرفران اللذان يتابعان نفس الموجز كل منهما على نسخته الخاصة — رؤية سيرفر لعنصر لا تكبت ظهوره لسيرفر آخر.
يُعلن فقط عن المنشورات الأصلية. تُصفَّى الردود وإعادة النشر مرتين. **منشورات الاقتباس لا تُصفَّى** وسيُعلن عنها.
يُعلّم أي عنصر يُرى بينما يكون اشتراك بريميوم غير نشط على أنه مرئي لمدة 7 أيام رغم عدم نشر أي شيء. الترقية لا تُعلن عنه بأثر رجعي.
بعد إعادة تفعيل بريميوم، توقّع فترة هادئة حتى يظهر محتوى جديد فعلًا.
## أذونات ديسكورد
تُفحص على الأذونات المباشرة للبوت في القناة المستهدفة وقت الإرسال:
| الإذن | السبب |
| ----------------- | ---------------------------------------------------------------------------------- |
| **View Channel** | لا يمكن لفيتوكس النشر في قناة لا يمكنه رؤيتها |
| **Send Messages** | لنشر الإعلان |
| **Embed Links** | كل إشعار عبارة عن Embed. بدون هذا يُرفض الرسالة تمامًا، حتى لو مُنحت Send Messages |
**فشل الإذن يفقد ذلك العنصر بشكل دائم.** يُعلَّم العنصر على أنه مرئي قبل محاولة الإرسال، ولا توجد إعادة محاولة. أصلح الأذونات *قبل* نشر المحتوى الذي يهمك — لا بعده.
إذا كانت القناة تحتوي على تجاوزات أذونات مخصصة، تحقق من الأذونات *الفعالة* للبوت هناك بدلًا من دوره على مستوى السيرفر. Embed Links هو الأكثر غيابًا في الغالب.
## تخصيص الإعلان
| الخيار | ما يفعله |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| **قناة ديسكورد** | حيث يُنشر الإعلان. يُعيَّن لكل عنصر مُتتبَع، حتى يمكن للستريمرز المختلفين النشر في قنوات مختلفة |
| **دور المنشن** | دور يُنبّه مع الإعلان |
| **Embed مخصص** | تحكم كامل في العنوان والوصف واللون والمؤلف والتذييل والصورة المصغرة والصورة والحقول |
| **رسالة مخصصة** | نص عادي يُستخدم كنص الـ Embed. **متاح فقط في RSS وPodcasts** |
يظهر عنصر التحكم في الرسالة المخصصة فقط في صفحتَي RSS وPodcast. تستخدم المنصات الست الأخرى Embed مخصصًا بدلًا من ذلك.
### حدود حجم الـ Embed
| الحقل | الحد |
| ---------------------------- | ----------------------------- |
| العنوان | 256 حرفًا |
| الوصف | 4,096 حرفًا |
| اسم المؤلف | 256 حرفًا |
| نص التذييل | 2,048 حرفًا |
| الحقول | 25، كل منها 256 / 1,024 حرفًا |
| روابط الصورة والصورة المصغرة | 500 حرف، بدون SVG |
### المتغيرات
تدعم حقول الـ Embed والرسائل متغيرات بين أقواس معقوفة، مثل `{streamer.name}`. لكل منصة مجموعتها الخاصة، مذكورة في صفحة تلك المنصة.
**يصبح المتغير غير المعروف نصًا فارغًا، لا خطأ.** وحقل الـ Embed الذي ينتهي عنوانه أو قيمته فارغين يُسقط من الرسالة تمامًا.
لذا فإن الحقل الذي يستمر في الاختفاء يعني تقريبًا دائمًا متغيرًا مكتوبًا بشكل خاطئ، أو متغيرًا غير موجود لتلك المنصة. تحقق من الاسم مقابل القائمة في صفحة المنصة — القائمة المنسدلة في المحرر هي المرجعية.
متغيرات بث تويتش وكيك (`{stream.title}` و`{stream.viewers}` وهكذا) موجودة فقط في الإعلان **المباشر**. عند استخدامها في Embed غير متصل تُحل إلى لا شيء ويختفي حقلها.
## المنشنز
يُنبّه دور المنشن الذي تُعدّه بشكل طبيعي.
المنشنز في Embed الإشعار **ليست** محصورة بالدور المُعدّ. سيتم تنبيه دور أو مستخدم مذكور في رسالة أو نص Embed مخصص. كن حذرًا مع `@everyone` في قالب مخصص.
## إعدادان لا يمكنك تغييرهما
**مفتاح التفعيل الرئيسي** و**لون Embed** لكل منصة مخزّنان ولكن ليس لهما تحكم فعال في لوحة التحكم. تستخدم كل منصة لونها الافتراضي للعلامة التجارية، ولا يمكن تبديل المفتاح الرئيسي.
استخدم مفتاح [إعداد السيرفر](/ar/server-management/setup) لإيقاف منصة، وEmbed مخصص لتعيين لون.
## استكشاف الأخطاء وإصلاحها
بالترتيب:
1. مفتاح المنصة في صفحة **إعداد السيرفر** مفعّل — هذا معطّل افتراضيًا وغير مرئي من هنا
2. لدى السيرفر بريميوم **بيسك** نشط أو أعلى
3. القناة المستهدفة لا تزال موجودة
4. لدى فيتوكس **View Channel + Send Messages + Embed Links** هناك
5. بالنسبة لـ تويتش وكيك — انتقل الستريمر إلى وضع عدم الاتصال ثم عاد منذ إضافتك له
إعلانات عدم الاتصال **معطّلة افتراضيًا** في تويتش وكيك. فعّلها على الستريمر المُتتبَع.
عنوانه أو قيمته حُلّت إلى فارغ وأُسقط الحقل. تقريبًا دائمًا متغير مكتوب بشكل خاطئ أو خاص بمنصة خاطئة.
عشرة لكل منصة هو الحد الأقصى ولا يتغير مع المستوى. أزل واحدًا أولًا.
يُحفظ الإعداد ولا يُحذف، ويُستأنف تلقائيًا. لكن أي شيء نُشر خلال الانقطاع مُعلَّم بالفعل على أنه مرئي ولن يُعلن عنه بأثر رجعي.
لا يُرسل حقل قناة مُفرَّغ، لذا يُحتفظ بالقناة السابقة ولا يُعرض أي خطأ. اختر قناة مختلفة بدلًا من مسحها.