Skip to content

Latest commit

 

History

History
77 lines (55 loc) · 3.05 KB

README.Arabic.md

File metadata and controls

77 lines (55 loc) · 3.05 KB

سالم حارس البوابة - روبوت

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

Bot Icon

المميزات

  • حل مسألة رياضية محددة بزمن معين لتصفية المستخدمين غير المرغوب فيهم أو المزعجين.
  • يدعم اللغة العربية.
  • يعتمد على المتغيرات البيئية لضبط الإعدادات.

سير العمل

هذا هو مسار عملية التحقق

graph TD
    A[عضو جديد ينضم إلى المجموعة] --> B[ممنوع من إرسال الرسائل]
    B --> C[استلام زر التحقق]
    C --> D[الضغط على الزر]
    D --> E[إعادة التوجيه إلى محادثة البوت]
    E --> F[بدء التحقق - عملية رياضية بسيطة]
    F --> G{هل الإجابة صحيحة؟}
    G -->|نعم| H[منح صلاحيات الدردشة]
    H --> I[البوت يرسل رسالة ترحيب للمجموعة]
    G -->|لا| J[الإزالة من المجموعة]
    F --> K{انتهاء المهلة بعد 15 ثانية}
    K -->|انتهاء الوقت| J[الإزالة من المجموعة]
    C --> L[حذف الرسالة بعد 20 ثانية]
Loading

البدء

المتطلبات الأساسية

  • إصدار Go 1.20 أو أحدث.
  • الحصول على الرمز السري للبوت من خلال BotFather

التثبيت

  1. نسخ المستودع:
git clone https://github.com/zakaria-chahboun/telegram_gatekeeper_bot.git
cd telegram_gatekeeper_bot
  1. تثبيت الاعتماديات:
go mod tidy
  1. إعداد المتغيرات البيئية:

أنشئ ملفًا باسم .env في المجلد الجذري للمشروع وأضف المتغيرات البيئية الخاصة بك:

BOT_TOKEN=your-telegram-bot-token
  1. تشغيل البوت:
go run main.go

الاستخدام

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

المساهمة

المساهمات مرحب بها! لا تتردد في فتح تقارير الأخطاء أو إرسال طلبات السحب PRs.

الترخيص

هذا المشروع مرخص تحت رخصة MIT. للاطلاع على التفاصيل، راجع ملف الترخيص.