LaraGram API Server یک پیادهسازی از Telegram Bot API Server با زبان PHP و مبتنی بر LaraGram MTProto است که امکان اجرای سرور اختصاصی Bot API تلگرام را بدون نیاز به بیلد کردن نسخه رسمی telegram-bot-api و وابستگی به سرویسهای تونلسازی مانند ngrok فراهم میکند.
⚙️ معماری و نحوه عملکرد
این پروژه با استفاده از پروتکل MTProto و ایجاد یک لایهی سازگار با Telegram Bot API، درخواستهای استاندارد رباتهای تلگرامی را پردازش میکند.
LaraGram API Server بهعنوان یک جایگزین سازگار با سرور رسمی Telegram Bot API طراحی شده است؛ بنابراین، رابط HTTP، ساختار پاسخها، پیامهای خطا و متدهای Bot API را پشتیبانی میکند و میتواند بدون وابستگی به فریمورک LaraGram، در کنار کتابخانههای رباتنویسی در زبانهای مختلف مورد استفاده قرار بگیرد.
✨ قابلیتهای کلیدی
سازگاری با Bot API رسمی: پشتیبانی از تمام متدهای Telegram Bot API و سازگاری با ابزارها و کتابخانههای موجود.
بدون نیاز به بیلد دستی: نصب مستقیم از طریق Composer، بدون نیاز به کامپایل سورس کد سرور رسمی تلگرام.
اجرای مستقل و لوکال: امکان اجرای سرور روی لوکالهاست یا زیرساخت اختصاصی.
پشتیبانی از Local Mode: امکان آپلود فایل تا حجم ۲۰۰۰ مگابایت، دانلود فایل بدون محدودیت حجم و استفاده از مسیر محلی فایلها.
پشتیبانی از Webhook: امکان استفاده از IP و پورت دلخواه برای دریافت آپدیتها و پیکربندی اتصالات Webhook.
مدیریت و مانیتورینگ: پشتیبانی از گزارشگیری، ثبت لاگ و مشاهده آمار درخواستها، آپدیتها و مصرف منابع.
آماده برای محیط Production: قابلیت اجرا بهصورت سرویس پایدار با ابزارهایی مانند systemd.
📦 نصب و راهاندازی
پیشنیازهای اصلی شامل PHP 8.3 یا بالاتر، افزونه Swoole و افزونههای JSON و Mbstring است.
نصب سراسری پکیج تنها با اجرای دستور زیر انجام میشود:
composer global require laraxgram/apiserver
پس از دریافت api_id و api_hash از پنل توسعهدهندگان تلگرام، میتوانید سرور را اجرا کنید:
laragram-server --api-id=YOUR_API_ID --api-hash=YOUR_API_HASH --local
همچنین امکان نصب پکیج بهصورت وابستگی پروژه و استفاده مستقیم از آن در اکوسیستم LaraGram وجود دارد.
📚 مستندات و راهنمای کامل
برای مشاهده پیشنیازها، تنظیمات، گزینههای اجرایی، نحوه استفاده در LaraGram، مدیریت فایلها و راهاندازی Production، مستندات رسمی پروژه را مطالعه کنید:
🔗 https://laraxgram.github.io/v4/apiserver
و در نهایت با استار دادن به گیتهاب پروژه و معرفی به دیگران از اون حمایت کنید:
🔗 https://github.com/laraXgram/APIServer
راستش چند وقتی هست که پیامکهای تبلیغاتی و اسپم، شدیدا اعصابم رو خرد میکرد و دیگه با دلار ۲۷۰ تومنی، تحملِ حواسپرتی برای اساماسِ کد تخفیف ۵ هزار تومنی اسنپ و یا به خصوص وصایای امام 🍌 ممکن نبود.
برای همین تصمیم گرفتم پروژهای رو که اولین کامیتش مربوط به ۲ سال پیش بود و بعد از اون هم دیگه ادامه پیدا نکرد، بالاخره به سرانجام برسونم.
«قیچی» یک اپلیکیشن مدیریت پیامک اندرویدی هست که با MAUI + ML.NET توسعه داده شده و تنها یک هدف داره: خفه کردن پیامکهای اسپم و تبلیغاتی. قیچی به عنوان اپلیکیشن پیشفرض گوشیتون تنظیم میشه و دقیقاً همون کاری رو میکنه که هر SMS Manager دیگهای انجام میده؛ با این تفاوت که یک مدل ML خیلی سبک هم داخلش تعبیه شده که هدفش تشخیص پیامکهای تبلیغاتی در کسری از میلیثانیه و بهصورت کاملا آفلاین روی دیوایس شخص هست.
بنابراین هیچ دادهای به سمت سرور ارسال نمیشه و همهچیز کاملا آفلاین و امنه. ضمن اینکه تمام بخشهای پروژه اعم از دیتاست، سورس اپلیکیشن و مدل ML اپنسورس هستن و بیلد برنامه هم مستقیما توسط GitHub Actions گرفته میشه. یعنی اینطوری بگم که خیالتون از هر بابت راحت باشه.
دیتاست فعلی در حال حاضر خیلی جامع نیست و حدود ۶ هزار پیامِ لیبلخورده رو شامل میشه؛ اما طبق برآورد و تستهایی که داشتم، همین دیتاست کوچیک هم (که از منابع مختلفی جمعآوری شده) تا حد خوبی جوابگوی نیاز برنامه است.
همچنین داخل برنامه این امکان تعبیه شده که شما بهصورت گزینشی (و با حذف خودکار یا دستیِ اطلاعات حساس)، پیامکهای تبلیغاتی یا پیامکهای غیرتبلیغاتیای که به اشتباه تبلیغ تشخیص داده شدن رو گزارش کنید تا این دیتاست به مرور زمان کاملتر بشه و عملکرد مدل ارتقا پیدا کنه. (اگر هم نکردین چالشی نیست، خودم میکنم 😭)
نسخهی فعلی در واقع حداقل نسخهی قابل ارائه هست و احتمالا باگهای زیادی خواهد داشت. ولی خب از اونجایی که مورد استفادهی روزمرهی خودم هست، به مرور زمان بهبود پیدا میکنه.
🔗 سورس پروژه و توضیحات تکمیلی:
https://github.com/MahdiyarGHD/GheychiApp
📥 دانلود نسخهی اولیه از گیتهاب:
https://github.com/MahdiyarGHD/GheychiApp/releases
اگر دوست داشتید، با گزارش باگ، مشارکت در توسعه یا حتی یک ⭐️ روی گیتهاب میتونید کمک کنید قیچی بهتر بشه.
لاراگرام یک full-stack و ai-ready فریمورک برای توسعه ربات های تلگرامی هست
شما یک ربات تلگرامی میسازید، و در کنارش با همون لاراگرام پنل ادمین یا مشتری تحت وب هم میسازید و به رباتتون وصل میکنید
در کنارش میتونید یوزربات هارو هم هندل کنید و همچنین برای رباتتون مینی اپ بسازید
بخش مهم ترش این هست که تمام این کار هارو ai به تنهایی میتونه براتون انجام بده
تصویری که میبینید یک پنل ادمین متصل به ربات تلگرامی هست که تماما توسط ai در یکی دو ساعت ساخته شده
این تمام ماجرا نیست، لاراگرام پنل مانیتورینگ و لاگر پیشرفته هم در اختیارتون میذاره تا از هیچ مشکلی در رباتتون بی خبر نمونید
پکیج LaraGram Sentinel منتشر شد؛ یک پنل مانیتورینگ که هیچ چیزی از زیر دستش در نمیره!
تمام آپدیتها، کوئریها، لاگها، Exceptionها و اتفاقات مهم ربات رو با جزئیات کامل ثبت و نمایش میده.
🔹 تمام Updateها؛ شامل Preview گرافیکی چت کاربر، JSON آپدیت، Timeline کامل Update و کلی اطلاعات دیگه
🔹 تمام API Callها با جزئیات کامل
🔹 دستهبندی کاربران و Track فعالیت هر کاربر
🔹 لیست Listenerها، تعداد Call، میانگین زمان اجرا و شناسایی Handlerهای کند
🔹 Exceptionها با جزئیات کامل، چند خط از کد محل خطا، Timeline و Trace
🔹 لاگها با Context کامل
🔹 کوئریهای دیتابیس، شناسایی Queryهای کند، نتیجه Query و جزئیات اجرا
🔹 نتایج Jobها
🔹 جزئیات Cacheها
🔹 Requestهای HTTP و نتایج آنها
🔹 جزئیات Commandها
🔹 نتایج Taskهای زمانبندیشده
🔹 قابلیت ارسال Alert به اکانت تلگرام
🔹 مانیتور Performance و Network سرور
🔹 یک Playground برای تست ربات
⚡️ نصب Sentinel سادهست؛ با یک Command روی رباتهای LaraGram نصب میشه و تمام جزئیات رباتتون قابل مانیتوره.
با استار دادن به پروژه و معرفی اون به دوستانتون ازش حمایت کنید.