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

# دليل إعداد بوت التذاكر

> انتقل من مفتاح الترخيص إلى بوت تذاكر Discord يعمل مباشرةً في نحو 10 دقائق.

يستضيف EchoAuth Tickets بوت تذاكر Discord الخاص بك نيابةً عنك. تنشئ حسابًا بمفتاح الترخيص، وتُعدّ البوت في متصفحك، وتنشره بنقرة واحدة. لا تحتاج إلى خادم ولا إلى أي برمجة.

> [!NOTE]
>
> **قبل أن تبدأ، جهّز ما يلي:**
>
> * مفتاح الترخيص من فاتورة SellAuth الخاصة بك (يبدو مثل `ECHO-XXXXX-XXXXX-XXXXX-XXXXX`)
> * صلاحية المسؤول على خادم Discord الخاص بك
> * حساب Discord يمكنه إنشاء التطبيقات في [Discord Developer Portal](https://discord.com/developers/applications)

## 1. أنشئ حسابك

**1. افتح صفحة التسجيل**

افتح لوحة EchoAuth Tickets وانقر على **Create an account** أسفل نموذج تسجيل الدخول. إذا استخدمت الرابط الموجود في فاتورتك، فمفتاح الترخيص معبّأ مسبقًا.

**2. أدخل مفتاح الترخيص وبيانات الدخول**

الصق **مفتاح الترخيص**، واختر **اسم مستخدم** (من 3 إلى 32 حرفًا: أحرف وأرقام و`.` و`_` و`-`) و**كلمة مرور** من 8 أحرف على الأقل. ثم انقر على **Create account**.

![نموذج Create your account مع حقول مفتاح الترخيص واسم المستخدم وكلمة المرور](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/register.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=963b556456e896df44c36bf5111ac365)

سجّل باستخدام مفتاح الترخيص من فاتورة SellAuth الخاصة بك

**3. تحقق من لوحة التحكم**

تصل إلى لوحة التحكم. تعرض عدد الأيام المتبقية في ترخيصك وحالة البوت وقائمة **Getting started**. يفتح كل عنصر في القائمة الإعداد الذي يحتاجه.

![لوحة التحكم تعرض ترخيصًا نشطًا وبوتًا لم يُنشر بعد وقائمة البدء](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=afdb4921c1fac548a8e7ea01642dcfdb)

لوحة التحكم مباشرةً بعد التسجيل. الإعداد عند 0/6

## 2. أنشئ بوت Discord الخاص بك

يعمل بوت التذاكر الخاص بك على تطبيق Discord خاص بك. تنشئه مرة واحدة في Discord Developer Portal.

**1. أنشئ تطبيقًا**

انتقل إلى [Discord Developer Portal](https://discord.com/developers/applications)، وانقر على **New Application**، وأعطه اسمًا (مثل اسم متجرك) ثم أنشئه.

**2. فعّل الـ intents المميزة**

افتح تبويب **Bot**. ضمن **Privileged Gateway Intents**، فعّل الثلاثة جميعًا:

* **Presence Intent**
* **Server Members Intent**
* **Message Content Intent**

انقر على **Save Changes**.

> [!WARNING]
>
> إذا كانت هذه الـ intents معطّلة، فلن يتمكن البوت من البدء أو لن يستطيع قراءة الرسائل داخل التذاكر.

**3. انسخ رمز البوت**

وأنت ما زلت في تبويب **Bot**، انقر على **Reset Token** وانسخ الرمز. ستلصقه في اللوحة في القسم التالي.

> [!WARNING]
>
> رمز البوت يعمل مثل كلمة المرور. لا تشاركه ولا تنشره في أي مكان. إذا تسرّب، فأعد ضبطه هنا والصق الرمز الجديد في اللوحة.

**4. ادعُ البوت إلى خادمك**

افتح **OAuth2 → URL Generator**. اختر النطاقين `bot` و`applications.commands`، ثم اختر الصلاحية **Administrator**. افتح الرابط الناتج وأضف البوت إلى خادمك.

**5. فعّل وضع المطوّر في Discord**

في Discord، انتقل إلى **User Settings → Advanced** وفعّل **Developer Mode**. يمكنك الآن النقر بزر الماوس الأيمن على الخوادم والقنوات والفئات والأدوار واختيار **Copy ID**. ستحتاج إلى هذه المعرّفات في الخطوات التالية.

## 3. اضبط البوت

انقر على **Configuration** في الشريط الجانبي. الإعدادات مجمّعة في تبويبات. تعرض **Live preview** على اليمين شكل رسائلك في Discord أثناء الكتابة.

كلما غيّرت شيئًا، يظهر شريط أسفل الصفحة. انقر على **Save** للاحتفاظ بتغييراتك، أو على **Save & Deploy** للحفظ وإعادة تشغيل البوت بالإعدادات الجديدة فورًا.

**1. General: أضف الرمز ومعرّف الخادم**

في تبويب **General**، املأ:

* **Bot Token**: الرمز من Developer Portal
* **Server ID**: انقر بزر الماوس الأيمن على أيقونة خادمك واختر **Copy Server ID**
* **Owner User ID** (اختياري): معرّف مستخدم Discord الخاص بك. لهذا المستخدم دائمًا حق الوصول إلى أوامر إدارة SellAuth.
* **Owner Role ID** (اختياري): دور يُسمح له باستخدام `/refund` و`/remove_password` و`/add_customer_balance` و`/redo_delivery` و`/replace`

![تبويب الإعدادات General مع تعبئة رمز البوت ومعرّف الخادم ومعرّف owner user وشريط التغييرات غير المحفوظة](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/general.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=c550d06ff7725d8856d3712e44097982)

تبويب General مع تعبئة الرمز ومعرّف الخادم. يظهر شريط الحفظ في الأسفل

**2. Ticket Behavior: اختر قناة السجلات**

في تبويب **Ticket Behavior**، اضبط **Logs channel ID**. ينشر البوت سجلات التذاكر هنا، ولا يعمل `/panel` بدونه. انقر بزر الماوس الأيمن على القناة في Discord واختر **Copy Channel ID**.

يمكنك أيضًا ضبط عدد التذاكر التي يمكن للمستخدم فتحها في آنٍ واحد، ومهلة الانتظار، وما إذا كان يحق للفريق وحده إغلاق التذاكر، وما إذا كانت التذاكر المغلقة تُؤرشف بدلًا من حذفها.

![تبويب Ticket Behavior مع تعبئة معرّف قناة السجلات](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-behavior.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=b73fdb6598b4fd49b20c56671d6b65ca)

تبويب Ticket Behavior. قناة السجلات مطلوبة

**3. Categories: حدّد أين تُفتح التذاكر ومن يمكنه الرد عليها**

في تبويب **Categories**، اختر فئة من اليسار (مثل **General Support**) واملأ:

* **Discord category ID**: فئة القنوات التي تُنشأ فيها التذاكر الجديدة. انقر بزر الماوس الأيمن على الفئة في Discord واختر **Copy Category ID**.
* **Support roles**: الصق معرّف دور واضغط **Enter**. يستطيع الأعضاء الذين لديهم هذه الأدوار رؤية التذاكر في هذه الفئة والرد عليها.

كرّر ذلك لكل فئة تستخدمها. لاستخدام فئات أكثر، افتح إحداها وفعّل **Enabled**. يعرض وضع الأزرار ما يصل إلى 5 فئات، ويعرض وضع القائمة المنسدلة ما يصل إلى 8. تحت **Form** يمكنك إضافة ما يصل إلى 5 أسئلة يجيب عنها المستخدمون قبل فتح التذكرة.

![تبويب Categories مع تعبئة معرّف فئة Discord ودور الدعم، بجانب معاينة لرسالة التذكرة](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/categories.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=82fa0f8f57ffe9b5cd68eaf5b5c1b4d3)

الفئة 1 مع معرّف فئة Discord ودور دعم

> [!TIP]
>
> اضبط **Function** لحقل النموذج على **SellAuth invoice lookup** ليبحث البوت عن الطلب تلقائيًا عندما يدخل العميل معرّف فاتورته.

**4. Ticket Panel: صمّم الرسالة التي ينقر عليها الأعضاء**

في تبويب **Ticket Panel**، حرّر عنوان اللوحة ورسالتها ولونها وصورها وتذييلها. فعّل **Use a dropdown menu** لعرض الفئات في قائمة منسدلة بدل الأزرار. تتحدث المعاينة أثناء الكتابة.

![تبويب Ticket Panel بجانب معاينة Discord للوحة Support Center مع قائمة منسدلة للفئات](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-panel.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=8eb97253931ed5ad11efb96f41c8cbba)

تبويب Ticket Panel مع المعاينة المباشرة لـ Discord

**5. SellAuth (اختياري): اربط متجرك**

لاستخدام أوامر SellAuth (`/invoice` و`/refund` و`/replace` وغيرها) وعمليات البحث عن الفواتير، افتح تبويب **SellAuth** وأدخل **API key** (dash.sellauth.com → Account → Developers) و**Shop ID** و**Shop currency** و**Shop domain**.

![تبويب تكامل SellAuth مع حقول مفتاح API ومعرّف المتجر والعملة والنطاق](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/sellauth.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=27f8ddc2f4a8db61dabb08029b3130cb)

تبويب SellAuth

## 4. انشر البوت

عُد إلى **Dashboard**. عندما تحمل العناصر الخمسة الأولى في القائمة علامة صح، انقر على **Deploy**. يبدأ البوت خلال ثوانٍ ويصبح متصلًا في خادمك.

![لوحة التحكم مع اكتمال خمس من ست خطوات إعداد وزر Deploy](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard-ready.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=e7426998aad99958eb32136d3d4b948f)

اكتملت كل الإعدادات. تبقّت خطوة النشر فقط

بعد أول نشر، استخدم **Save & Deploy** في صفحة Configuration لتطبيق التغييرات اللاحقة.

> [!NOTE]
>
> إذا فشل النشر، افتح **Logs** في الشريط الجانبي. أكثر الأسباب شيوعًا هي رمز بوت خاطئ أو intents معطّلة في Developer Portal.

## 5. انشر لوحة التذاكر في Discord

في خادم Discord الخاص بك، انتقل إلى القناة التي يجب أن يفتح الأعضاء التذاكر منها ونفّذ:

```text theme={null}
/panel
```

تحتاج إلى صلاحية **Administrator** لتنفيذ هذا الأمر. ينشر البوت اللوحة في تلك القناة. يختار الأعضاء الآن فئة ويجيبون عن النموذج، وتُفتح لهم ولأدوار الدعم لديك قناة تذكرة خاصة.

## جدّد ترخيصك أو مدّده

افتح **License & Account** في الشريط الجانبي. الصق مفتاحًا جديدًا ضمن **Redeem a license key** وانقر على **Redeem**. يُضاف الوقت فوق تاريخ انتهائك الحالي، لذا يمكنك التمديد مبكرًا دون خسارة أي أيام. يمكنك أيضًا تغيير كلمة المرور من هذه الصفحة.

![صفحة License and Account مع نموذج استبدال مفتاح الترخيص ونموذج تغيير كلمة المرور وسجل التراخيص](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/account.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=ae5f1857dd2f29e1320e152fe5a2ff17)

صفحة License & Account

> [!WARNING]
>
> عند انتهاء ترخيصك، يتوقف البوت. تبقى إعداداتك ونسخ المحادثات محفوظة. استبدل مفتاحًا جديدًا وانشر مرة أخرى لإعادة البوت إلى العمل.

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

> [accordion] البوت متصل لكن أوامر الشرطة المائلة لا تظهر
>
> تأكد من أنك دعوت البوت بنطاق `applications.commands` وأن **Slash commands** مفعّل في **Configuration → General → Commands**. قد يحتاج Discord إلى بضع دقائق لإظهار الأوامر الجديدة. وغالبًا ما تفيد إعادة تشغيل Discord.

> [accordion] /panel لا يفعل شيئًا
>
> تحقق من أن **Logs channel ID** في تبويب **Ticket Behavior** يشير إلى قناة موجودة في خادمك، وأن لديك صلاحية Administrator.

> [accordion] تُفتح التذاكر في المكان الخطأ أو لا يستطيع الفريق رؤيتها
>
> تحقق من **Discord category ID** و**Support roles** لتلك الفئة في تبويب **Categories**. لكل فئة إعداداتها الخاصة. تأكد من أن دور البوت لديه صلاحية إدارة القنوات في تلك الفئة.

> [accordion] لا أستطيع إنشاء حساب بمفتاحي
>
> انسخ المفتاح تمامًا كما يظهر في فاتورتك. يمكن استخدام كل مفتاح مرة واحدة فقط. إذا كان لديك حساب بالفعل، فسجّل الدخول واستبدل المفتاح ضمن **License & Account**.

ما زلت عالقًا؟ افتح تذكرة في [خادم الدعم](https://discord.echoauth.dev) الخاص بنا.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.