كيفية إنشاء بوت محادثة في ديسكورد

يمكن لبوت ديسكورد القيام بكل ما هو متاح في القنوات الأخرى، بالإضافة إلى التفاعل المباشر مع خادمك: الرد في القنوات والمواضيع والرسائل المباشرة، وإضافة التفاعلات، واستقبال وإرسال الملفات، وتحرير أو حذف رسائله الخاصة. تشمل الميزات الإضافية الإشراف (المهلات، والطرد، والحظر، وحذف الرسائل)، وإدارة الأدوار، وإنشاء قنوات للتذاكر، وأوامر الشرطة المائلة.

يستغرق الإعداد حوالي عشر دقائق ويتكون من جزأين: أولاً، إنشاء البوت في جانب ديسكورد، ثم توصيله بمشروعك في Mavibot.

الخطوة 1. إنشاء تطبيق

افتح بوابة مطوري ديسكورد وانقر على تطبيق جديد. أدخل اسمًا — سيراه أعضاء الخادم.

في قسم التثبيت، اضبط رابط التثبيت على لا شيء. ستقوم بإنشاء رابط تثبيت البوت بنفسك في الخطوة 4 مع الصلاحيات المطلوبة.

الخطوة 2. تكوين البوت

انتقل إلى قسم البوت.

عطّل البوت العام. وإلا، سيتمكن أي شخص من إضافة بوتك إلى خادمه.

فعّل الأذونات المميزة المطلوبة — بدونها، لن يرسل ديسكورد بيانات معينة إلى البوت:

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

الخطوة 3. الحصول على رمز البوت

في نفس قسم البوت، انقر على إعادة تعيين الرمز وانسخ الرمز الذي يظهر. يتم عرضه مرة واحدة فقط — احفظه، حيث ستحتاجه في الخطوة 6.

مهم! يوفر الرمز وصولاً كاملاً إلى بوتك. لا تنشره أو تشاركه. إذا تم اختراق الرمز، انقر على إعادة تعيين الرمز مرة أخرى. سيتوقف الرمز القديم عن العمل فورًا، وستحتاج إلى إعادة توصيل البوت في Mavibot باستخدام الرمز الجديد.

الخطوة 4. تحديد الصلاحيات

افتح OAuth2 → مولد الرابط.

تحت النطاقات، حدد:

• bot — البوت نفسه؛
• applications.commands — إذا كنت تخطط لاستخدام أوامر الشرطة المائلة. بدون هذا النطاق، لا يمكن تسجيل الأوامر على الخادم.

سيظهر قسم صلاحيات البوت أدناه. حدد فقط الصلاحيات التي يحتاجها بوتك فعليًا — من الأفضل عدم منح صلاحيات غير ضرورية.

الحد الأدنى من الصلاحيات للرسائل

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

صلاحيات إضافية للإشراف والأتمتة

الصلاحية	ما تُستخدم من أجله
إدارة الرسائل	حذف رسائل المستخدمين الآخرين وإدارة الرسائل المثبتة
إدارة الأعضاء	المهلات (الكتم)
طرد الأعضاء	إزالة الأعضاء من الخادم
حظر الأعضاء	حظر وإلغاء حظر الأعضاء
إدارة الأدوار	تعيين وإزالة الأدوار
إدارة الأسماء المستعارة	تغيير الأسماء المستعارة للأعضاء
إدارة القنوات	إنشاء وحذف القنوات، بما في ذلك قنوات التذاكر
إنشاء دعوة فورية	إنشاء روابط الدعوة

يمكن أيضًا تغيير الصلاحيات لاحقًا في إعدادات دور البوت على الخادم دون إعادة توصيل البوت.

الخطوة 5. إضافة البوت إلى خادمك

انسخ الرابط الذي تم إنشاؤه في أسفل صفحة مولد الرابط، وافتحه في متصفحك، وحدد الخادم.

يمكن فقط لمالك الخادم أو عضو لديه صلاحية إدارة الخادم إضافة البوت.

بعد إضافة البوت، تحقق من ترتيب الأدوار:

إعدادات الخادم → الأدوار

يجب أن يكون دور البوت أعلى من الأدوار التي سيعينها وفوق أدوار الأعضاء الذين يحتاج إلى الإشراف عليهم.

هذا قيد من ديسكورد: لا يمكن للبوت تعيين دور في نفس مستواه أو أعلى من دوره، ولا يمكنه فرض مهلة أو حظر عضو يكون دوره أعلى من دور البوت.

الخطوة 6. اترك حقل عنوان نقطة نهاية التفاعلات فارغًا

عد إلى قسم المعلومات العامة لتطبيقك وتأكد من أن حقل عنوان نقطة نهاية التفاعلات فارغ.

إذا تم تحديد أي شيء في هذا الحقل، يتوقف ديسكورد عن إرسال نقرات الأزرار وتفاعلات أوامر الشرطة المائلة إلى البوت — يتم إرسالها إلى العنوان المحدد بدلاً من ذلك.

من منظور المستخدم، يبدو هذا وكأن الأزرار في رسائل البوت لا تعمل، بينما ترجع أوامر الشرطة المائلة "لم يستجب التطبيق."

الخطوة 7. توصيل البوت بمشروعك

في مشروعك في Mavibot، افتح قسم القنوات، وانقر على ديسكورد، والصق الرمز من الخطوة 3.

بعد بضع ثوانٍ، يجب أن يظهر البوت متصلاً بالإنترنت على خادم ديسكورد الخاص بك. إذا لم يحدث ذلك، تأكد من نسخ الرمز بالكامل وعدم احتوائه على مسافات إضافية.

تحقق من أن كل شيء يعمل

أرسل رسالة في أي قناة خادم يجب أن تؤدي إلى أحد ردود البوت — يجب أن يرد البوت.

إذا كان البوت متصلاً بالإنترنت لكنه لا يستجيب، فمن المرجح أن إذن محتوى الرسالة غير مفعل.

انضم إلى الخادم باستخدام حساب آخر أو اطلب من زميل الانضمام — يجب أن يتم تشغيل تحية العضو الجديد. إذا لم يحدث ذلك، تحقق من إذن أعضاء الخادم.

انقر على زر في رسالة البوت. إذا لم يحدث شيء، تحقق من عنوان نقطة نهاية التفاعلات.

أشياء مهمة يجب معرفتها

محادثة القناة مشتركة بين الجميع

يكتب جميع أعضاء القناة في نفس المحادثة، تمامًا كما في الدردشة الجماعية.

تشير المتغيرات مثل "من أرسل الرسالة" إلى مؤلف أحدث رسالة ويتم استبدالها بالرسالة التالية — اقرأها وعالجها فورًا في نفس الكتلة.

يتم التعامل مع الرسائل المباشرة مع البوت وأحداث الأعضاء مثل الانضمام والمغادرة وتغييرات الأدوار في محادثة منفصلة لذلك العضو.

الرسائل المباشرة مقيدة من قبل ديسكورد

يمكن للبوت إرسال رسالة مباشرة إلى عضو فقط إذا كان العضو يشارك الخادم مع البوت ولم يقم بتعطيل الرسائل المباشرة من أعضاء الخادم في إعدادات الخصوصية الخاصة به.

إذا قام العضو بتعطيل الرسائل المباشرة، لا يمكن تسليم الرسالة — هذا قيد من ديسكورد ولا يمكن تجاوزه.

بيانات webhook الكاملة

إذا قمت بتعيين أي قيمة لمتغير save_webhook، فسيتم حفظ جميع بيانات الحدث الواردة في متغير discord_webhook.

نادرًا ما يكون هذا مطلوبًا — كل ما قد تحتاجه من webhook متاح بالفعل من خلال متغيرات منفصلة.

المشكلات الشائعة

ما يحدث	السبب
البوت متصل بالإنترنت لكنه لا يستجيب للنص	إذن محتوى الرسالة غير مفعل
لا يتم استقبال أحداث الانضمام والمغادرة وتغيير الدور	إذن أعضاء الخادم غير مفعل
الأزرار لا تعمل وأوامر الشرطة المائلة ترجع "لم يستجب التطبيق"	عنوان نقطة نهاية التفاعلات مملوء
لا يمكن تسجيل أوامر الشرطة المائلة	تمت إضافة البوت بدون نطاق applications.commands — أنشئ رابط تثبيت جديد وأضف البوت مرة أخرى
لا يمكن للبوت تعيين دور	دور البوت ليس أعلى من الدور المستهدف، أو البوت لا يمتلك صلاحية إدارة الأدوار. لا يمكن تعيين الأدوار التي تديرها التكاملات، بما في ذلك أدوار البوتات الأخرى، ودور @everyone
لا يمكن للبوت فرض مهلة أو حظر عضو	دور العضو أعلى من دور البوت، أو البوت لا يمتلك صلاحية إدارة الأعضاء / حظر الأعضاء
لا يمكن للبوت رؤية قناة معينة	تتجاوز صلاحيات مستوى القناة صلاحيات مستوى الخادم. تحقق من صلاحيات دور البوت في إعدادات تلك القناة
لا يمكن حذف الرسائل	البوت لا يمتلك صلاحية إدارة الرسائل. يسمح ديسكورد بالحذف الجماعي فقط للرسائل التي يقل عمرها عن 14 يومًا

ما التالي

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

للاطلاع على وظائف إدارة الخادم المتاحة من تدفق البوت الخاص بك، راجع "وظائف واجهة برمجة تطبيقات ديسكورد."

لمعرفة كيفية بناء تدفق الرسائل نفسه، راجع "كيفية إنشاء بوت محادثة للأعمال."

للسماح للذكاء الاصطناعي بالتواصل مع العملاء في ديسكورد، فعّل مساعد الذكاء الاصطناعي — راجع قسم "مساعد الذكاء الاصطناعي."