PHPackages meysammaghsoudi/bale-messenger - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. meysammaghsoudi/bale-messenger ActiveLibrary[Mail & Notifications](/categories/mail) meysammaghsoudi/bale-messenger ============================== پکیج لاراول برای ارسال پیام‌های زیبا به پیام‌رسان بله با پشتیبانی از قالب‌بندی پیشرفته و Message Builder 1.0.0(2mo ago)00MITPHPPHP ^8.1 Since Feb 28Pushed 2mo agoCompare [ Source](https://github.com/meysam1366/bale-messenger)[ Packagist](https://packagist.org/packages/meysammaghsoudi/bale-messenger)[ RSS](/packages/meysammaghsoudi-bale-messenger/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (5)Versions (2)Used By (0) پکیج لاراول بله (Laravel Bale Messenger) ======================================== [](#پکیج-لاراول-بله-laravel-bale-messenger) **پکیج لاراول برای ارسال پیام‌های زیبا به پیام‌رسان بله** [نصب](#نصب) • [استفاده پایه](#استفاده-پایه) • [MessageBuilder](#messagebuilder) • [نوتیفیکیشن‌ها](#نوتیفیکیشنها) • [قالب‌های آماده](#قالبهای-آماده) --- معرفی ----- [](#معرفی) این پکیج به شما امکان می‌دهد به سادگی از طریق برنامه لاراول خود به پیام‌رسان بله پیام ارسال کنید. با استفاده از **MessageBuilder** می‌توانید پیام‌های زیبا و فرمت‌شده بسازید و از قالب‌های آماده برای نوتیفیکیشن‌های رایج استفاده کنید. ### ویژگی‌ها [](#ویژگی‌ها) - ✅ ارسال پیام متنی با قالب‌بندی Markdown و HTML - ✅ ارسال عکس، ویدیو، فایل و موقعیت مکانی - ✅ **MessageBuilder** برای ساخت پیام‌های زیبا - ✅ قالب‌های آماده نوتیفیکیشن (سفارش، پرداخت، خطا و...) - ✅ پشتیبانی از **Laravel Notifications** - ✅ کیبوردهای اینلاین و معمولی - ✅ کارت‌ها و جدول‌های زیبا --- نصب --- [](#نصب) ### ۱. نصب با Composer [](#۱-نصب-با-composer) ``` composer require meysammaghsoudi/bale-messenger ``` ### ۲. انتشار فایل کانفیگ [](#۲-انتشار-فایل-کانفیگ) ``` php artisan vendor:publish --tag=bale-config ``` ### ۳. تنظیم متغیرهای محیطی [](#۳-تنظیم-متغیرهای-محیطی) فایل `.env` را باز کنید و توکن ربات بله را اضافه کنید: ``` BALE_BOT_TOKEN=your_bot_token_here BALE_DEFAULT_CHAT_ID=123456789 ``` --- استفاده پایه ------------ [](#استفاده-پایه) ### ارسال پیام ساده [](#ارسال-پیام-ساده) ``` use meysammaghsoudi\BaleMessenger\Facades\Bale; // ارسال پیام ساده Bale::send('سلام! این یک پیام تست است.', 123456789); // یا با تعیین چت پیش‌فرض Bale::to(123456789)->send('سلام دنیا!'); ``` ### ارسال پیام‌های زیبا [](#ارسال-پیام‌های-زیبا) ``` use meysammaghsoudi\BaleMessenger\Facades\Bale; // پیام موفقیت Bale::sendSuccess('ثبت‌نام موفق', 'کاربر با موفقیت ثبت‌نام شد.'); // پیام خطا Bale::sendError('خطا در پرداخت', 'لطفاً مجدداً تلاش کنید.'); // پیام هشدار Bale::sendWarning('موجودی کم', 'موجودی محصول رو به اتمام است.'); // پیام اطلاع‌رسانی Bale::sendInfo('به‌روزرسانی',نسخه جدید سیستم منتشر شد.'); ``` ### ارسال رسانه [](#ارسال-رسانه) ``` // ارسال عکس Bale::sendPhoto('https://example.com/image.jpg', 'توضیحات عکس'); // ارسال فایل Bale::sendDocument('https://example.com/file.pdf', 'فایل گزارش'); // ارسال ویدیو Bale::sendVideo('https://example.com/video.mp4', 'ویدیو معرفی'); // ارسال موقعیت مکانی Bale::sendLocation(35.6892, 51.3890); // تهران ``` --- MessageBuilder -------------- [](#messagebuilder) با **MessageBuilder** می‌توانید پیام‌های زیبا و حرفه‌ای بسازید: ### مثال پایه [](#مثال-پایه) ``` use meysammaghsoudi\BaleMessenger\Facades\Bale; $message = Bale::message() ->header('گزارش فروش', 1) ->separator() ->bold('تاریخ: ')->text(now()->format('Y/m/d'))->newLine() ->bold('فروش کل: ')->text('۱۵,۰۰۰,۰۰۰ تومان')->newLine() ->bold('تعداد سفارش: ')->text('۱۲۵')->newLine() ->separator() ->emoji('📈 ')->text('رشد ۲۳٪ نسبت به هفته گذشته'); Bale::sendBuilder($message, 123456789); ``` ### قالب‌بندی متن [](#قالب‌بندی-متن) ``` $message = Bale::message() ->bold('متن بولد')->newLine() ->italic('متن ایتالیک')->newLine() ->strikethrough('متن خط‌خورده')->newLine() ->code('کد برنامه')->newLine() ->codeBlock('echo "Hello World";', 'php')->newLine() ->link('لینک به سایت', 'https://example.com'); ``` ### کارت اطلاعاتی [](#کارت-اطلاعاتی) ``` $message = Bale::message() ->card('اطلاعات کاربر', [ 'نام' => 'علی محمدی', 'ایمیل' => 'ali@example.com', 'تلفن' => '۰۹۱۲۱۲۳۴۵۶۷', 'شهر' => 'تهران', ]); ``` ### لیست‌ها [](#لیست‌ها) ``` $message = Bale::message() ->header('لیست وظایف', 2) ->separator() ->listItem('تماس با مشتری') ->listItem('ارسال فاکتور') ->listItem('پیگیری سفارش') ->listItem('بکاپ گیری', '✓'); ``` ### جدول [](#جدول) ``` $message = Bale::message() ->table( ['محصول', 'تعداد', 'قیمت'], [ ['گوشی A15', '۲', '۳۵,۰۰۰,۰۰۰'], ['لپ‌تاپ HP', '۱', '۴۵,۰۰۰,۰۰۰'], ['هدفون', '۳', '۱,۵۰۰,۰۰۰'], ] ); ``` ### دکمه‌های اینلاین [](#دکمه‌های-اینلاین) ``` $message = Bale::message() ->text('لطفاً یک گزینه انتخاب کنید:') ->inlineRow([ 'تأیید' => 'confirm', 'رد' => 'reject', ]) ->inlineButton('مشاهده جزئیات', 'https://example.com/details', 'url'); ``` ### دکمه‌های معمولی [](#دکمه‌های-معمولی) ``` $message = Bale::message() ->text('منوی اصلی:') ->buttonRow(['محصولات', 'سفارشات']) ->buttonRow(['پشتیبانی', 'درباره ما']); ``` --- نوتیفیکیشن‌ها ------------- [](#نوتیفیکیشن‌ها) ### استفاده از سیستم Notifications لاراول [](#استفاده-از-سیستم-notifications-لاراول) ``` use Illuminate\Notifications\Notification; use meysammaghsoudi\BaleMessenger\Messages\MessageBuilder; class OrderCreatedNotification extends Notification { protected $order; public function __construct($order) { $this->order = $order; } public function via($notifiable): array { return ['bale']; } public function toBale($notifiable): MessageBuilder { return MessageBuilder::create() ->emoji('🛒 ')->bold('سفارش جدید')->newLine() ->separator() ->bold('شماره: ')->text('#' . $this->order->id)->newLine() ->bold('مشتری: ')->text($this->order->customer_name)->newLine() ->bold('مبلغ: ')->text(number_format($this->order->total) . ' تومان'); } } ``` ### تعریف route در مدل [](#تعریف-route-در-مدل) ``` use Illuminate\Notifications\Notifiable; class User extends Model { use Notifiable; public function routeNotificationForBale(): int { return $this->bale_chat_id; } } ``` ### ارسال نوتیفیکیشن [](#ارسال-نوتیفیکیشن) ``` $user = User::find(1); $user->notify(new OrderCreatedNotification($order)); ``` --- قالب‌های آماده -------------- [](#قالب‌های-آماده) ### نوتیفیکیشن‌های سریع [](#نوتیفیکیشن‌های-سریع) ``` use meysammaghsoudi\BaleMessenger\Facades\Bale; // کاربر جدید Bale::notifyNewUser([ 'name' => 'علی محمدی', 'email' => 'ali@example.com', 'phone' => '۰۹۱۲۱۲۳۴۵۶۷', ]); // سفارش جدید Bale::notifyNewOrder([ 'id' => 1234, 'customer' => 'علی محمدی', 'amount' => 1500000, 'items_count' => 3, ]); // پرداخت موفق Bale::notifyPayment([ 'transaction_id' => 'TXN123456', 'amount' => 500000, 'payer' => 'علی محمدی', ]); // خطای سیستم Bale::notifyError('Database connection failed', [ 'file' => 'app/Services/OrderService.php', 'line' => 45, ]); // گزارش روزانه Bale::notifyDailyReport([ 'سفارشات جدید' => '۱۵', 'فروش کل' => '۲۵,۰۰۰,۰۰۰ تومان', 'کاربران جدید' => '۸', ]); ``` ### استفاده از قالب‌های کلاسی [](#استفاده-از-قالب‌های-کلاسی) ``` use meysammaghsoudi\BaleMessenger\Support\Templates\OrderNotification; $orderNotification = (new OrderNotification()) ->orderId(1234) ->customer('علی محمدی') ->amount(1500000) ->itemsCount(3) ->status('در انتظار پرداخت') ->button('مشاهده سفارش', 'https://example.com/orders/1234'); Bale::sendNotification($orderNotification); ``` --- API کامل -------- [](#api-کامل) ### متدهای اصلی [](#متدهای-اصلی) متدتوضیحات`send($text, $chatId, $options)`ارسال پیام متنی`sendBuilder($builder, $chatId)`ارسال از MessageBuilder`sendPhoto($photo, $caption, $chatId, $options)`ارسال عکس`sendDocument($document, $caption, $chatId, $options)`ارسال فایل`sendVideo($video, $caption, $chatId, $options)`ارسال ویدیو`sendLocation($lat, $long, $chatId, $options)`ارسال موقعیت`sendSuccess($title, $message, $chatId)`پیام موفقیت`sendError($title, $message, $chatId)`پیام خطا`sendWarning($title, $message, $chatId)`پیام هشدار`sendInfo($title, $message, $chatId)`پیام اطلاع‌رسانی`typing($chatId)`نمایش وضعیت تایپ`getMe()`اطلاعات ربات`ping()`سنجش سرعت--- مستندات API بله --------------- [](#مستندات-api-بله) این پکیج از API رسمی بله استفاده می‌کند: - مستندات: - Endpoint: `https://tapi.bale.ai` --- مجوز ---- [](#مجوز) این پکیج تحت مجوز MIT منتشر شده است. --- مشارکت ------ [](#مشارکت) برای مشارکت در توسعه این پکیج، لطفاً Pull Request ارسال کنید یا Issue ثبت کنید. ### Health Score 35 — LowBetter than 79% of packages Maintenance86 Actively maintained with recent releases Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 74d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/195bf2b4232b39ba0eb476f0ce9dc072fb124741c9205e93611b106e36f7b831?d=identicon)[meysam1366](/maintainers/meysam1366) --- Top Contributors [![meysam1366](https://avatars.githubusercontent.com/u/1081400?v=4)](https://github.com/meysam1366 "meysam1366 (4 commits)") --- Tags laravelnotificationbotMessengeriranpersianBale ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/meysammaghsoudi-bale-messenger/health.svg) ``` [![Health](https://phpackages.com/badges/meysammaghsoudi-bale-messenger/health.svg)](https://phpackages.com/packages/meysammaghsoudi-bale-messenger) ``` ### Alternatives [laravel-notification-channels/telegram Telegram Notifications Channel for Laravel 1.1k3.4M35](/packages/laravel-notification-channels-telegram)[laravel-notification-channels/discord Laravel notification driver for Discord. 2371.3M11](/packages/laravel-notification-channels-discord)[s-ichikawa/laravel-sendgrid-driver This library adds a 'sendgrid' mail driver to Laravel. 4139.3M1](/packages/s-ichikawa-laravel-sendgrid-driver)[laravel-notification-channels/twilio Provides Twilio notification channel for Laravel 2587.7M12](/packages/laravel-notification-channels-twilio)[gr8shivam/laravel-sms-api A modern, flexible Laravel package for integrating any SMS gateway with REST API support 10138.4k](/packages/gr8shivam-laravel-sms-api)[hooman-mirghasemi/laravel-iran-sms Laravel Sms 241.8k](/packages/hooman-mirghasemi-laravel-iran-sms) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)