إنشاء بوت
الخطوة 1. قم بإنشاء تطبيق (اتبع الرابط).
الخطوة 2. أضف بوت (انقر على زر "إضافة بوت").
الخطوة 2.1. في قسم التثبيت، اختر رابط التثبيت → لا شيء.
الخطوة 2.2. في قسم البوت، قم بتعطيل البوت العام، ثم فعّل الصلاحيات التالية:
- صلاحية محتوى الرسائل
- صلاحية أعضاء الخادم
يمكنك أيضًا تفعيل صلاحية الحضور للاستخدام المستقبلي.
الخطوة 3. احصل على الرمز المميز (إعادة تعيين الرمز المميز).
الخطوة 4. أضف البوت إلى الخادم:
- اذهب إلى OAuth2 → مولد الرابط.
- في النطاقات، اختر bot.
- في صلاحيات البوت، اختر إرسال الرسائل، قراءة سجل الرسائل، وأي صلاحيات أخرى مطلوبة.
ثم افتح الرابط المُنشأ، واختر الخادم الذي تريد إضافة البوت إليه، وأكد التفويض.
للحصول على الويب هوك الكامل من ديسكورد، ببساطة قم بتعيين أي قيمة للمتغير save_webhook.
إذا تم تعيين المتغير، سيتم حفظ الويب هوك في discord_webhook.
ربط بوت ديسكورد في MaviBot
الآن اذهب إلى قسم "المراسلات" في مشروعك في MaviBot:
ثم الصق الرمز المميز المنسوخ من ديسكورد.
انقر على زر تم.
وظائف الحاسبة
الرد على رسالة
discord_reply_to_message(message_id, text) - تُستخدم هذه الوظيفة للرد على رسالة.
| المعاملات | الوصف |
|---|---|
| ! message_id | معرف الرسالة التي تريد الرد عليها. |
| ! text | نص رسالة الرد. |
حذف رسالة
discord_delete_message(message_id) - تُستخدم هذه الوظيفة لحذف رسالة.
| المعاملات | الوصف |
|---|---|
| ! message_id | معرف الرسالة المراد حذفها. |
تعديل رسالة
discord_edit_message(message_id, text) - تُستخدم هذه الوظيفة لتعديل رسالة.
| المعاملات | الوصف |
|---|---|
| ! message_id | معرف الرسالة المراد تعديلها. |
| ! text | النص الجديد للرسالة. |
تثبيت رسالة
discord_pin_message(message_id) - تُستخدم هذه الوظيفة لتثبيت رسالة.
| المعاملات | الوصف |
|---|---|
| ! message_id | معرف الرسالة المراد تثبيتها. |
إلغاء تثبيت رسالة
discord_unpin_message(message_id) - تُستخدم هذه الوظيفة لإلغاء تثبيت رسالة.
| المعاملات | الوصف |
|---|---|
| ! message_id | معرف الرسالة المراد إلغاء تثبيتها. |
إرسال تفاعل إلى رسالة
discord_send_reaction(message_id, reaction) - تُستخدم هذه الوظيفة لإرسال تفاعل إلى رسالة.
| المعاملات | الوصف |
|---|---|
| ! message_id | معرف الرسالة التي سيتم إرسال التفاعل إليها. |
| ! reaction | التفاعل المراد إرساله. يمكنك تقديم رمز تعبيري واحد (مثل ❤️) أو معرف رمز تعبيري مخصص على الخادم. معلومات حول كيفية الحصول على معرف الرمز التعبيري المخصص موضحة أدناه. |
إزالة تفاعل من رسالة في قناة
discord_delete_reaction(message_id, reaction, user_id) - تُستخدم هذه الوظيفة لإزالة تفاعل من رسالة في قناة.
| المعاملات | الوصف |
|---|---|
| ! message_id | معرف الرسالة التي سيتم إزالة التفاعل منها. |
| ! reaction | التفاعل المراد إزالته. يمكنك تقديم رمز تعبيري واحد (مثل ❤️) أو معرف رمز تعبيري مخصص على الخادم. معلومات حول كيفية الحصول على معرف الرمز التعبيري المخصص موضحة أدناه. |
| user_id | معرف المستخدم الذي تريد إزالة تفاعله. هذه المعلمة اختيارية إذا كنت تريد إزالة التفاعل من البوت الحالي. |
الاستدعاءات
عندما يرسل مستخدم تفاعلًا، يتم استلام استدعاء في الدردشة بالتنسيق التالي:
new_like ❤️ uid413984787162726410
حيث uid413984787162726410 هو معرف المستخدم الذي أرسل التفاعل.
كيفية الحصول على معرف الرمز التعبيري المخصص
إذا أرسلت تفاعلًا مخصصًا إلى رسالة في قناة ديسكورد، سيتم استلام استدعاء بالتنسيق التالي:
new_like beer:1479419477396291696 uid413984787162726410
حيث beer:1479419477396291696 هو معرف التفاعل. يمكنك نسخه لاستخدامه في الوظائف المتعلقة بالتفاعلات.
كيفية الحصول على معرف الرسالة
يمكنك الحصول على معرف رسالة العميل من الويب هوك إذا كان save_webhook مفعّلاً. مثال:
data = discord_webhook["data"]
msg_id = data["id"]
result = discord_reply_to_message(msg_id, "هذا رد على رسالة")