> ## 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.

# إشعارات تويتش

> أعلن في ديسكورد عندما يبث ستريمر تويتش أو ينهي بثه، مع embed قابل للتخصيص بالكامل.

<Info>
  يتطلب **بيسك**. حتى **10 ستريمرز** لكل سيرفر. راجع [كيف تعمل الإشعارات](/ar/notifications/overview) للقواعد المشتركة بين جميع المنصات.
</Info>

## إضافة ستريمر

ابحث عن القناة بالاسم — يبحث عنها فيتوكس على تويتش ويؤكد وجودها قبل الإضافة. اسم مستخدم لا يُحل يُرفض بـ **Twitch user not found**.

أسماء المستخدمين من 1 إلى 25 حرفًا، أحرف وأرقام وشُرَط سفلية فقط.

## الإعدادات

| الإعداد                     | الافتراضي     | ملاحظات                                                                        |
| --------------------------- | ------------- | ------------------------------------------------------------------------------ |
| **قناة ديسكورد**            | —             | مطلوبة. تُعيَّن لكل ستريمر، حتى يمكن للستريمرز المختلفين النشر في قنوات مختلفة |
| **الإشعار عند الاتصال**     | **مفعّل**     | إعلان البث المباشر                                                             |
| **الإشعار عند عدم الاتصال** | **معطّل**     | إعلان ثانٍ عند انتهاء البث                                                     |
| **دور المنشن**              | لا شيء        | يُنبَّه مع الإعلان                                                             |
| **Embed إشعار مخصص**        | افتراضي تويتش | بنفسجي، مع عنوان البث واللعبة وعدد المشاهدين                                   |

## المتغيرات

| المتغير              | يُحل إلى                                  |
| -------------------- | ----------------------------------------- |
| `{streamer.name}`    | اسم عرض الستريمر                          |
| `{streamer.url}`     | رابط قناة تويتش الخاصة به                 |
| `{streamer.avatar}`  | صورته الشخصية                             |
| `{stream.title}`     | عنوان البث — **إعلان مباشر فقط**          |
| `{stream.game}`      | الفئة التي يتم بثها — **مباشر فقط**       |
| `{stream.viewers}`   | عدد المشاهدين وقت الإعلان — **مباشر فقط** |
| `{stream.thumbnail}` | صورة معاينة البث — **مباشر فقط**          |

<Warning>
  متغيرات `{stream.*}` الأربعة ليس لها قيمة في إعلان **عدم الاتصال**. أي حقل Embed مبني منها يختفي من تلك الرسالة. اجعل Embed عدم الاتصال الخاص بك مقتصرًا على متغيرات `{streamer.*}` فقط.
</Warning>

## كيف يُكتشف البث المباشر

يفحص فيتوكس كل **60 ثانية** ويتتبع ما إذا كانت القناة مباشرة.

<Steps>
  <Step title="غير متصل → مباشر">
    يُطلق الإعلان، خاضعًا لـ **فترة تهدئة 10 دقائق** لكل ستريمر.
  </Step>

  <Step title="لا يزال مباشرًا">
    لا شيء. تُحدَّث الحالة ببساطة — بث طويل يُنتج إعلانًا واحدًا بالضبط.
  </Step>

  <Step title="مباشر → غير متصل">
    يُطلق إعلان عدم الاتصال، إذا فعّلته.
  </Step>
</Steps>

<Warning>
  **إضافة ستريمر يبث بالفعل لا تُعلن عن أي شيء.** يُطلق المتتبع عند الانتقال، وليس على الحالة الحالية. سيكون أول إعلان لك هو بثه التالي.
</Warning>

<Note>
  البث الذي ينقطع لفترة وجيزة ويعيد الاتصال داخل نافذة التهدئة يُنتج إعلانًا واحدًا، لا اثنين — هذا متعمّد، ولذلك تكون فترة التهدئة 10 دقائق بدلًا من دقيقة واحدة.
</Note>

## إعداد من العالم الحقيقي

<Steps>
  <Step title="فعّل تويتش في إعداد السيرفر">
    إنه معطّل افتراضيًا. لا شيء يعمل حتى يكون هذا مفعّلًا.
  </Step>

  <Step title="أضف الستريمر">
    ابحث عن اسمه واخترها من النتائج.
  </Step>

  <Step title="اختر قناة ودورًا">
    قناة `#going-live` مخصصة ودور `@Stream Ping` ينضم إليه الأعضاء عبر [الرولات ذاتية التعيين](/ar/engagement/self-roles) هو النمط الذي تستقر عليه معظم السيرفرات.
  </Step>

  <Step title="تحقق من أذونات البوت هناك">
    View Channel، وSend Messages، و**Embed Links**.
  </Step>

  <Step title="انتظر بثه التالي">
    لا تحكم عليه بإضافة شخص أثناء بثه.
  </Step>
</Steps>

## استكشاف الأخطاء وإصلاحها

<AccordionGroup>
  <Accordion title="بثّ ولم يُنشر شيء">
    تحقق من مفتاح تويتش في إعداد السيرفر، وأن بريميوم نشط، وEmbed Links في القناة. إذا أضفته أثناء بثه بالفعل، فهذا متوقع — انتظر البث التالي.
  </Accordion>

  <Accordion title="اللعبة أو عدد المشاهدين مفقود">
    أنت تنظر إلى إعلان عدم الاتصال. تلك المتغيرات موجودة فقط أثناء البث.
  </Accordion>

  <Accordion title="تغيير القناة لم يتم">
    مسح حقل القناة لا يُرسل شيئًا ويحتفظ بالقيمة القديمة بصمت. اختر قناة مختلفة بدلًا من مسحها.
  </Accordion>

  <Accordion title="يتابع سيرفران نفس الستريمر وحصل سيرفر واحد فقط على المنشن">
    كلاهما يجب أن يُطلق. إذا فشلت أذونات قناة أحدهما، فسيُفقد ذلك العنصر دون إعادة محاولة — تحقق من Embed Links على الجانب الفاشل.
  </Accordion>
</AccordionGroup>

<Card title="كيك" icon="tower-broadcast" horizontal href="/ar/notifications/kick">
  نفس نموذج المباشر/غير المتصل على كيك.
</Card>