Gateway Intents في Discord: ما الذي يُسمح للبوت بسماعه

ما هي البوابة

البوت يحتفظ باتصال دائم مع Discord يسمى البوابة gateway. عبرها يرسل Discord الأحداث فور وقوعها: أُرسلت رسالة، انضم عضو، بدأ شخص الكتابة، تغيرت قناة صوتية. بدون حدود، سيستقبل كل بوت كل حدث من كل خادم.

النوايا هي المرشح. في أول رسالة يرسلها البوت بعد الاتصال، يسرد النوايا التي يريدها كرقم واحد. ثم يرسل Discord الأحداث المطابقة فقط.

النوايا الشائعة

• Guilds: إنشاء الخوادم والقنوات والرتب أو تغييرها. تقريبا كل بوت يستخدمها.
• Guild messages: الرسائل في قنوات الخادم. نص تلك الرسائل يحتاج إلى نية مميزة، انظر أدناه.
• Guild voice states: من ينضم إلى القنوات الصوتية أو يغادرها. أدوات الموسيقى والصوت تحتاجها.
• Guild moderation: الحظر وإدخالات سجل التدقيق.
• Guild message reactions: التفاعلات التي تُضاف أو تُزال.

ثلاث نوايا خاصة: الحضور presence، وأعضاء الخادم server members، ومحتوى الرسالة message content. هي نوايا مميزة، لأنها تكشف بيانات شخصية أكثر، وتحتاج إلى موافقة إضافية للبوتات الكبيرة.

لماذا يهم ذلك لأصحاب الخوادم

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

النوايا أيضا إشارة إلى الخصوصية. البوت الذي يطلب فقط ما تحتاجه ميزاته أسهل في الثقة به.

النوايا وNoxyr

بوت Noxyr الرئيسي يُدار لك. إذا أعددت بوتا مخصصا بتطبيقك الخاص، فيجب تفعيل Server Members Intent وMessage Content Intent في بوابة مطوري Discord، كما يشرح دليل الإعداد. وهذه مطلوبة لميزات مثل رسائل الترحيب وأوامر البادئة. إذا كان البوت المخصص غير متصل، ابدأ بـدليل انقطاع البوت.

لمزيد من التفاصيل، انظر شرح نوايا البوابة المميزة.

فحص بوت لم تكتبه

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