چطور در لاراول به بله پیام بفرستیم؟

برای ارسال متن از متد رسمی sendMessage استفاده کنید. شناسهٔ گفتگو می‌تواند عدد صحیح یا شناسهٔ رشته‌ای مستند بله باشد.

use Sajaddp\Bale\Facades\Bale;

Bale::sendMessage(
    chatId: 123456789,
    text: 'سلام از Laravel',
);

پارامترهای الزامی متد بر کلید همنام در options مقدم‌اند. فقط گزینه‌هایی را بفرستید که بله برای همان متد مستند کرده است.

پاسخ به پیام

روش رسمی، ارسال reply_to_message_id با sendMessage است:

Bale::sendMessage(
    chatId: $message['chat']['id'],
    text: 'پاسخ شما',
    options: ['reply_to_message_id' => $message['message_id']],
);

replyToMessage متد کمکی پکیج برای همین روند تکراری است. ورودی آن باید دادهٔ خام پیام بله با message_id و chat.id عددی باشد؛ ورودی ناقص پیش از هر درخواست اچ‌تی‌تی‌پی با InvalidArgumentException رد می‌شود.

Bale::replyToMessage(
    message: $update['message'],
    text: 'پاسخ شما',
);

فوروارد، کپی و وضعیت گفتگو

forwardMessage و copyMessage متدهای رسمی جداگانه‌اند. برای نمایش وضعیت موقت گفتگو، مانند آغاز آپلود عکس، از sendChatAction استفاده کنید.

Bale::forwardMessage(chatId: '@target', fromChatId: 123456789, messageId: 42);
Bale::copyMessage(chatId: '@target', fromChatId: 123456789, messageId: 42);
Bale::sendChatAction(chatId: '@target', action: 'upload_photo');

ویرایش یا حذف پیام

ویرایش متن، زیرنویس یا دکمه‌ها و حذف پیام، هر کدام متد رسمی مستقلی دارند. بله برای نتیجهٔ متدهای ویرایش نوع مشخصی مستند نکرده است؛ لاراول بله نتیجهٔ خام بله را بازمی‌گرداند.

Bale::editMessageText(chatId: 123456789, messageId: 42, text: 'متن جدید');
Bale::editMessageCaption(chatId: 123456789, messageId: 42, options: ['caption' => 'زیرنویس جدید']);
Bale::editMessageReplyMarkup(chatId: 123456789, messageId: 42, options: ['reply_markup' => $replyMarkup]);
Bale::deleteMessage(chatId: 123456789, messageId: 42);

برای ساخت دکمه‌ها و پاسخ به آن‌ها، راهنمای دکمه‌ها و پاسخ انتخاب را ببینید. امضا و خروجی همهٔ متدها در مرجع رابط برنامه‌نویسی مرجع نهایی است.