التطبيقات والرموز

أنشئ بوتًا في بوابة المطورين، وغيّر إعداداته، وثبّته في سيرفر.

ما تحتاج إليه

حساب في زرزور. سجّل في التطبيق إن لم يكن لديك حساب. لكل بوت مالك. يستطيع الحساب إنشاء 7 بوتات في الأسبوع: يُحتسب كل إنشاء لمدة 7 أيام، ولا يعيد حذف البوت هذه المحاولة.

أنشئ تطبيقًا

التطبيق وبوته شيء واحد: معرّف التطبيق ومعرّف البوت ومعرّف مستخدم البوت قيمة واحدة.

1. افتح بوابة المطورين. ستطلب منك تسجيل الدخول. تجدها أيضًا في الإعدادات ← بوابة المطورين.
2. اختر تطبيق جديد.
3. أدخل اسم مستخدم للبوت. اقرأ قواعد البوتات، وفعّل مفتاح قبولها، ثم اختر إنشاء.
4. يظهر الرمز مرة واحدة. انسخه الآن واحفظه في مكان آمن: لا يخزن زرزور سوى بصمة له ولا يستطيع عرضه مرة أخرى.

تبويب نظرة عامة

تبويب الأوامر

يسرد الأوامر العامة للبوت. تستطيع لصق قائمة JSON هناك بدل التسجيل من الكود. انظر أوامر الشرطة المائلة.

ثبّت البوت في سيرفر

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

أسرع طريقة لسيرفر الاختبار الخاص بك:

1. افتح تطبيقك، تبويب نظرة عامة، واختر إضافة إلى سيرفر.
2. اختر السيرفر.

للتثبيت بصلاحيات محددة، أو ليثبّته غيرك:

1. افتح تطبيقك، تبويب OAuth2، قسم مولّد الروابط.
2. حدد bot.install والصلاحيات التي يحتاج إليها البوت.
3. انسخ رابط الدعوة وافتحه، أو أرسله إلى مسؤول السيرفر.
4. يختار الشخص سيرفرًا ويؤكد.

تصبح الصلاحيات دورًا باسم البوت. ينشئ زرزور هذا الدور ويديره: يستطيع الناس رفعه، لكن لا يستطيعون حذفه ما دام البوت موجودًا. لا تطلب إلا ما يستخدمه البوت.

Reply to commands     nothing extra
Send messages         SendMessage, ViewChannel (members have these by default)
Moderate              KickMembers, BanMembers, TimeoutMembers, ManageMessages

لا يحصل البوت على دور إلا إذا حمل الرابط صلاحيات. مع إضافة إلى سيرفر يكون عضوًا عاديًا بصلاحيات السيرفر الافتراضية.

بعد التثبيت، ارفع دور البوت فوق الأعضاء الذين سيشرف عليهم. انظر الترتيب.

حد السيرفرات والتوثيق

يستطيع البوت غير الموثق دخول 100 سيرفر. بعدها يفشل التثبيت بالخطأ BotNeedsVerification. وبعد 100 سيرفر لا يحتفظ إلا بالصلاحيات الخاصة التي وافق عليها زرزور. في تبويب نظرة عامة، اختر التوثيق وصف البوت. وهذا الطلب نفسه في صورة استدعاء، للمالك بعد تسجيل دخوله:

curl -X POST "https://api.zrzur.com/bots/YOUR_BOT_ID/verification" \
  -H "x-session-token: YOUR_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -d '{
    "statement": "Keeps notes and warnings for one gaming community.",
    "website": "https://example.com/bot",
    "support": "https://example.com/help",
    "privacy_policy_url": "https://example.com/privacy",
    "terms_of_service_url": "https://example.com/terms",
    "intents": 0
  }'

يبقى طلب واحد مفتوحًا في كل مرة، وبعد الرفض تستطيع الطلب مجددًا بعد أسبوع. يجيب GET /bots/{target}/verification بالحقول verified وrequest مع status (Pending أو Approved أو Denied أو Revoked) وcan_apply_at.

الأخطاء الشائعة

التالي

• شغّل بوتك
• حماية الرموز