رفع اشکال¶

`BALE_BOT_TOKEN` تنظیم نشده است¶

پکیج پیش از ساخت نشانی، توکن خالی یا غیررشته‌ای را با LogicException رد می‌کند. BALE_BOT_TOKEN را در محیط برنامه تنظیم کنید و کش پیکربندی را متناسب با استقرار خود نوسازی کنید.

نوع خطا چیست؟¶

BaleRequestException: بله یک ساختار پاسخ معتبر با ok: false برگردانده است.
RequestException: پاسخ اچ‌تی‌تی‌پی ناموفق یا دانلود محتوای دودویی ناموفق است که ساختار پاسخ معتبر بله ندارد.
UnexpectedValueException: پاسخ موفق، result یا اطلاعات فایل با قرارداد مورد انتظار سازگار نیست.

وب‌هوک ۴۱۹ یا نشانی اشتباه¶

در routes/web.php، درخواست خارجی بله توکن محافظت درخواست ندارد. دقیقاً همان نشانی وب‌هوک را در bootstrap/app.php از محافظت درخواست خارج کنید؛ مثلاً bale/webhook. یا مسیر را با طراحی امنیتی خودتان در محل مناسب قرار دهید. نشانی داده‌شده به setWebhook باید نشانی عمومی دقیق همان مسیر باشد. پکیج مسیر، کنترل‌کننده یا اعتبارسنجی راز نمی‌سازد.

مسیر محلی رشته‌ای آپلود نمی‌شود¶

رشته در متدهای رسانه فقط file_id بله یا نشانی اچ‌تی‌تی‌پی است. برای بارگذاری، SplFileInfo بدهید:

new SplFileInfo(storage_path('app/file.pdf'))

`replyToMessage` خطا می‌دهد¶

ورودی باید دادهٔ خام پیام بله با message_id و chat.id عددی باشد. شیء، رشته یا پیام ناقص را تبدیل نکنید؛ دادهٔ رویداد را همان‌طور که دریافت شده بررسی کنید.

فایل دانلود نشد¶

downloadFile ابتدا getFile را فراخوانی می‌کند. نتیجه باید file_path غیرخالی داشته باشد، وگرنه UnexpectedValueException رخ می‌دهد. نشانی دانلود حاوی توکن است؛ آن را ثبت گزارش یا عمومی نکنید. برای تازه‌ماندن پیوند، در هر دریافت از getFile جدید استفاده کنید.

`attach://` برای گروه رسانه کار نمی‌کند¶

هر ارجاعی مانند attach://first باید یک فایل پیوست با کلید دقیق first و SplFileInfo قابل‌خواندن داشته باشد. برای بارگذاری چندبخشی، پکیج فیلدهای دادهٔ ساخت‌یافته مانند media را سریال‌سازی می‌کند.

دریافت دوره‌ای بیش از انتظار طول می‌کشد¶

getUpdates در دریافت طولانی‌مدت فقط یک درخواست می‌سازد. timeout بله را در options قرار دهید؛ پکیج برای زمان‌انتظار اچ‌تی‌تی‌پی مهلت اضافی مناسب می‌افزاید. حلقه، صف، فاصلهٔ افزایشی تلاش مجدد و ذخیرهٔ offset جزو این پکیج نیستند.

فرض نکنید رفتار تلگرام برقرار است¶

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