ساخت و پیکربندی بات
هنگام ساخت نمونه ربات، می‌توانید پارامترهای زیر را به سازنده کلاس Bot بدهید:
| پارامتر | نوع | پیش‌فرض | توضیح |
|---|---|---|---|
token |
str | None |
توکن احراز هویت بات. اگر خالی یا نامعتبر باشد، از کاربر در ترمینال درخواست می‌شود. |
token_string |
str | None |
نسخهٔ رمزنگاری‌شدهٔ توکن. اولویت آن از token بیشتر است. |
password |
str | None |
رمز عبور برای رمزگشایی token_string (در صورت استفاده). |
base_url |
str | "https://botapi.shad.ir/v3" |
آدرس پایهٔ API. |
timeout |
int/float | 30 |
مدت زمان انتظار برای هر درخواست (ثانیه). |
max_retries |
int | 5 |
حداکثر تعداد تلاش مجدد در صورت خطای شبکه. |
show_welcome |
bool | True |
نمایش پیام خوش‌آمدگویی کتابخانه هنگام راه‌اندازی. |
run_all_handlers |
bool | True |
اگر True باشد، همهٔ هندلرهایی که شرطشان با رویداد مطابقت دارد اجرا می‌شوند. اگر False باشد، تنها اولین هندلر مطابق اجرا می‌شود. |
نکات مهم
-
اولویت
token_string: اگر همtokenو همtoken_stringرا بدهید،token_stringاستفاده می‌شود (و در صورت نیاز باpasswordرمزگشایی می‌شود). -
run_all_handlers: اگر چند هندلر با یک رویداد مطابقت داشته باشند، باTrueهمه اجرا می‌شوند و باFalseفقط اولی.