> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# روبوت Discord

> تكوين روبوت Discord الخاص بك

## نظرة عامة

يمكنك الوصول إلى Gorbit Cloud أو مثيل المستضافة الذاتية الخاص بك من خلال روبوت Discord.

<Note>
  إذا كنت تريد استخدام Gorbit Cloud، يجب عليك استخدام تطبيق GorbitBot Discord الرسمي.

  مثيلات المستضافة الذاتية يجب أن تنشئ تطبيق Discord الخاص بها في بوابة المطور.
</Note>

## التكوين

### GorbitBot الرسمي

ستحتاج أن تكون مسؤولاً على خادم Discord ومسؤولاً في مثيل Gorbit الخاص بك لتثبيت وتكوين GorbitBot.

<Steps>
  <Step title="ثبّت GorbitBot في خادم Discord الخاص بك">
    انقر [هنا](https://discord.com/oauth2/authorize?client_id=1460722463431327804)
    لتثبيت GorbitBot الرسمي في خادم Discord الخاص بك.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/install_discordbot.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=f6724ff361c9197bebb475dc26716fe6" alt="Install GorbitBot in Discord server" style={{maxHeight: '400px'}} width="834" height="1048" data-path="assets/admins/discord_bot/install_discordbot.png" />
  </Step>

  <Step title="اسمح بالوصول إلى قناة نصية خاصة">
    انتقل إلى إعدادات القناة وانقر على علامة تبويب "الأذونات".

    أضف GorbitBot إلى قائمة "المستخدمون المسموح لهم".

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/discord_private_channel_config.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=b22d5dcbc7ad8ec144fb89405b39be1f" alt="Allow GorbitBot to access a private text channel" width="1996" height="1050" data-path="assets/admins/discord_bot/discord_private_channel_config.png" />
  </Step>

  <Step title="أنشئ مفتاح تسجيل في Gorbit">
    أنشئ أو سجل دخولك إلى حسابك على [Gorbit Cloud](https://cloud.gorbit.app).

    انتقل إلى لوحة إدارة Gorbit > روبوتات Discord وانقر على زر **إضافة خادم**.

    انسخ مفتاح التسجيل.

    <Note>
      سيُعرض مفتاح التسجيل مرة واحدة فقط. إذا فقدته،
      احذف تكوين الخادم وأنشئ واحدًا جديدًا.

      يُبطل المفتاح بمجرد استخدامه ولا يسمح بأي وصول آخر لمثيل Gorbit الخاص بك.
    </Note>
  </Step>

  <Step title="سجّل خادمك في Gorbit">
    أرسل مفتاح التسجيل في القناة الخاصة التي سمحت لـ GorbitBot بالوصول إليها.

    يجب أن يستجيب GorbitBot برسالة تؤكد أن الخادم تم تسجيله.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/register_server.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=e4c4851866a452265bdc9d3a9081d5db" alt="GorbitBot registered in Gorbit" width="1582" height="208" data-path="assets/admins/discord_bot/register_server.png" />

    في Gorbit، يجب أن ترى حالة الخادم **مسجل**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/configured_discord_server.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=4064737a61c0bca9b0adbb643b3b1e61" alt="GorbitBot registered in Gorbit" width="1798" height="1146" data-path="assets/admins/discord_bot/configured_discord_server.png" />
  </Step>

  <Step title="تكوين سلوك القناة">
    انقر على أيقونة القلم بجانب اسم الخادم لتكوين سلوك الروبوت.

    <Tip>
      افتراضيًا، لن يستجيب الروبوت في أي قناة. يجب عليك اختيار القنوات التي تريد أن يستجيب فيها الروبوت.

      نوصي بشدة بتكوين **وكيل مخصص** مع وصول بيانات محدد للروبوت.
      وإلا قد يجيب من بيانات مفهرسة خاصة.
    </Tip>

    يمكنك تخصيص:

    * الوكيل الافتراضي الذي يشغل ردود الروبوت
    * تجاوزات الوكيل لقنوات محددة
    * ما إذا كان يجب أن يستجيب الروبوت لجميع الرسائل أو فقط للرسائل الموسومة بـ @GorbitBot
    * ما إذا كان الروبوت يستجيب في الردود أو الخيوط

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/discord_channel_configs.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=d112ddfbef5316289d16f5e50df5633e" alt="Configure Channel Behavior" width="2348" height="1774" data-path="assets/admins/discord_bot/discord_channel_configs.png" />
  </Step>
</Steps>

### روبوت Discord مستضاف ذاتيًا

إذا كنت تريد نشر روبوت Discord الخاص بك مع مثيل Gorbit المستضاف ذاتيًا،
ستحتاج لإعداد تطبيق Discord الخاص بك.

<Info>
  في بوابة المطور، سترى إشارات إلى "Guilds". هذا هو المصطلح الداخلي لـ Discord للخوادم.
</Info>

<Steps>
  <Step title="أنشئ تطبيق Discord جديد">
    انتقل إلى [بوابة مطور Discord](https://discord.com/developers/applications)
    وانقر على **تطبيق جديد**.

    أعطِ تطبيقك اسمًا وانقر على **إنشاء**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/new_discord_app.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=c1a97dfe0cb832e05d9bd8609c4502f9" alt="Create a new Discord app" width="2272" height="1070" data-path="assets/admins/discord_bot/new_discord_app.png" />
  </Step>

  <Step title="تكوين الأذونات وإعدادات التثبيت">
    انتقل إلى علامة تبويب **التثبيت**.

    ألغِ تحديد **تثبيت المستخدم**. لا يمكن تثبيت تطبيق Discord للاستخدام الشخصي.
    يجب تثبيته في الخوادم فقط.

    أضف النطاقات التالية:

    ```
    - bot
    - applications.commands
    ```

    أضف الأذونات التالية:

    ```
    - View channels
    - Send messages
    - Send messages in threads
    - Create public threads
    - Create private threads
    - Read message history
    - Add reactions
    ```

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/installation_config.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=4f25e6e31e52a670ec45a5c71299d93f" alt="Discord installation configuration" width="2950" height="2112" data-path="assets/admins/discord_bot/installation_config.png" />
  </Step>

  <Step title="تفعيل نوايا البوابة المميزة">
    في علامة تبويب **Bot**، انتقل لأسفل إلى قسم **نوايا البوابة المميزة** وفعّل جميع المفاتيح الثلاثة:

    * Presence Intent
    * Server Members Intent
    * Message Content Intent

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/privileged_gateway_intents.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=13cde6edc36439d0409e18da3b4a61d5" alt="Discord privileged gateway intents" width="4056" height="1254" data-path="assets/admins/discord_bot/privileged_gateway_intents.png" />
  </Step>

  <Step title="ثبّت التطبيق في خادم Discord الخاص بك">
    استخدم **رابط التثبيت** في علامة تبويب **التثبيت** لتثبيت التطبيق في خادم Discord الخاص بك.
  </Step>

  <Step title="اسمح لتطبيقك بالوصول إلى قناة نصية خاصة">
    انتقل إلى إعدادات القناة وانقر على علامة تبويب "الأذونات".

    أضف تطبيقك إلى قائمة "المستخدمون المسموح لهم".

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/discord_private_channel_config.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=b22d5dcbc7ad8ec144fb89405b39be1f" alt="Allow GorbitBot to access a private text channel" width="1996" height="1050" data-path="assets/admins/discord_bot/discord_private_channel_config.png" />
  </Step>

  <Step title="استرجع رمز الروبوت الخاص بك">
    في بوابة المطور، انتقل إلى علامة تبويب **Bot** وابحث عن قسم **الرمز**.

    انقر على **إعادة تعيين الرمز** وانسخ رمز الروبوت الخاص بك.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/bot_token_config.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=5f8347e2acc536d4be5bbbb0a0905fc3" alt="Discord bot token configuration" width="2180" height="1472" data-path="assets/admins/discord_bot/bot_token_config.png" />
  </Step>

  <Step title="تكوين تطبيقك في Gorbit">
    انتقل إلى لوحة إدارة Gorbit > روبوتات Discord.

    الصق رمز الروبوت في حقل **رمز الروبوت** وانقر **إنشاء!**

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/configure_discord_bot_token.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=cb0018e53b23eba518bf37c67aaffd75" alt="Discord bot token" width="1798" height="1038" data-path="assets/admins/discord_bot/configure_discord_bot_token.png" />
  </Step>

  <Step title="أنشئ مفتاح تسجيل في Gorbit">
    انقر على زر **إضافة خادم** وانسخ مفتاح التسجيل.

    <Note>
      سيُعرض مفتاح التسجيل مرة واحدة فقط. إذا فقدته،
      احذف تكوين الخادم وأنشئ واحدًا جديدًا.

      يُبطل المفتاح بمجرد استخدامه ولا يسمح بأي وصول آخر لمثيل Gorbit الخاص بك.
    </Note>
  </Step>

  <Step title="سجّل خادمك في Gorbit">
    أرسل مفتاح التسجيل في القناة الخاصة التي سمحت لتطبيقك بالوصول إليها.

    يجب أن يستجيب روبوت Gorbit برسالة تؤكد أن الخادم تم تسجيله.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/register_server.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=e4c4851866a452265bdc9d3a9081d5db" alt="GorbitBot registered in Gorbit" width="1582" height="208" data-path="assets/admins/discord_bot/register_server.png" />

    في Gorbit، يجب أن ترى حالة الخادم **مسجل**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/configured_discord_server.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=4064737a61c0bca9b0adbb643b3b1e61" alt="GorbitBot registered in Gorbit" width="1798" height="1146" data-path="assets/admins/discord_bot/configured_discord_server.png" />
  </Step>

  <Step title="تكوين سلوك القناة">
    انقر على أيقونة القلم بجانب اسم الخادم لتكوين سلوك الروبوت.

    <Tip>
      افتراضيًا، لن يستجيب الروبوت في أي قناة. يجب عليك اختيار القنوات التي تريد أن يستجيب فيها الروبوت.

      نوصي بشدة بتكوين **وكيل مخصص** مع وصول بيانات محدد للروبوت.
      وإلا قد يجيب من بيانات مفهرسة خاصة.
    </Tip>

    يمكنك تخصيص:

    * الوكيل الافتراضي الذي يشغل ردود الروبوت
    * تجاوزات الوكيل لقنوات محددة
    * ما إذا كان يجب أن يستجيب الروبوت لجميع الرسائل أو فقط للرسائل الموسومة بـ @GorbitBot
    * ما إذا كان الروبوت يستجيب في الردود أو الخيوط

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/discord_bot/discord_channel_configs.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=d112ddfbef5316289d16f5e50df5633e" alt="Configure Channel Behavior" width="2348" height="1774" data-path="assets/admins/discord_bot/discord_channel_configs.png" />
  </Step>
</Steps>

## الأسئلة الشائعة

### لماذا لا أستطيع رؤية جميع قنواتي في Gorbit؟

إذا أضفت أو أزلت قنوات من خادم Discord الخاص بك، ستحتاج لمزامنة القنوات مع Gorbit.

شغّل `!sync-channels` في أي قناة نصية يمكن لـ GorbitBot الوصول إليها.

### `!` مستخدم بالفعل لأمر آخر!

`!sync-channels` هو حاليًا الأمر الوحيد المدعوم لـ GorbitBot.

إذا كنت تستضيف ذاتيًا، يمكنك تعيين متغير البيئة `DISCORD_BOT_INVOKE_CHAR` لتغيير بادئة الأمر.

إذا كنت تستخدم GorbitBot الرسمي، للأسف، لا يمكننا تغيير البادئة. ومع ذلك،
لا يزال بإمكانك تشغيل الأمر بإنشاء قناة خاصة يمكن لـ GorbitBot فقط الوصول إليها.

### روبوت Discord الخاص بي متصل لكن لا يستجيب لأي رسائل

إذا كنت ترى هذا السلوك، قد تواجه الخطأ التالي (في حاوية الخلفية):

```
api_client.py  182: Failed to connect to API: Cannot connect to host 127.0.0.1:8080
```

لإصلاح هذا، تأكد من أن لديك أحدث ملفات docker-compose.yml بتشغيل `git pull` في مستودع Gorbit الخاص بك.
تحقق من أن `API_SERVER_PROTOCOL` و `API_SERVER_HOST` موجودة في ملف compose الخاص بك.