آماده استفاده در برنامه
رباتهای رسمی جترا
رباتساز جترا
@BotFather
ساخت ربات، دریافت یا تعویض توکن و مدیریت نام، توضیحات، فرمانها، حریم خصوصی و دسترسی گروه.
استیکرساز جترا
@Stickers
ساخت و مدیریت بستههای استیکر و ایموجی سفارشی، افزودن یا حذف مورد و انتشار بسته.
تأیید رسمی جترا
@verifybot
ثبت و پیگیری درخواست تأیید رسمی برای ربات، کانال یا سوپرگروه عمومی در جترا.
شناسهیاب جترا
پیداکردن آیدی عددی خود، کاربران، گروهها و کانالها با ارسال یوزرنیم یا لینک جترا و انتخاب از دکمههای ربات.
شروع سریع
- در جترا وارد @BotFather شوید و فرمان
/newbotرا ارسال کنید. - نام نمایشی و سپس نام کاربری ربات را انتخاب کنید.
- توکن ساختهشده را در متغیر امن سرور خود نگه دارید.
- با درخواست زیر اتصال را آزمایش کنید.
curl "https://jetra.ir/bot<TOKEN>/getMe"پاسخ موفق همیشه شامل ok: true و نتیجه در فیلد result است.
دریافت پیامها
برای شروع ساده از long polling استفاده کنید. رویدادهای فعلی جترا شامل message، edited_message و callback_query هستند.
curl -X POST "https://jetra.ir/bot<TOKEN>/getUpdates" \
-H "Content-Type: application/json" \
-d '{"offset":0,"limit":100,"timeout":30}'بعد از پردازش هر رویداد، درخواست بعدی را با offset = update_id + 1 بفرستید. همزمان نمیتوان از polling و webhook استفاده کرد.
ارسال پیام و دکمه
درخواستها میتوانند JSON، فرم معمولی یا برای بارگذاری فایل multipart/form-data باشند.
curl -X POST "https://jetra.ir/bot<TOKEN>/sendMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"text": "سلام از ربات جترا",
"reply_markup": {
"inline_keyboard": [[
{"text":"تأیید","callback_data":"confirm"}
]]
}
}'Webhook
برای محیط عملیاتی، یک نشانی عمومی HTTPS ثبت کنید. جترا هر رویداد را بهصورت JSON با درخواست POST ارسال میکند.
curl -X POST "https://jetra.ir/bot<TOKEN>/setWebhook" \
-H "Content-Type: application/json" \
-d '{
"url":"https://example.com/jetra-webhook",
"secret_token":"YOUR_WEBHOOK_SECRET",
"allowed_updates":["message","edited_message","callback_query"]
}'در صورت تعیین رمز، آن را از هدر X-Jetra-Bot-Api-Secret-Token بررسی کنید.
مرجع متدهای موجود
نام متدها به حروف بزرگ و کوچک حساس نیست. همه آنها با همان توکن BotFather فراخوانی میشوند.
حساب و فرمانها
getMeبررسی توکن و دریافت مشخصات رباتsetMyCommandsثبت فهرست فرمانهای رباتdeleteMyCommandsحذف فرمانهای ثبتشدهgetMyCommandsدریافت فرمانهای فعلیدریافت رویدادها
getUpdatesدریافت پیامها با long pollingsetWebhookارسال رویدادها به نشانی HTTPS شماdeleteWebhookحذف webhook و بازگشت به pollinggetWebhookInfoنمایش وضعیت و خطای آخر webhookارسال محتوا
sendMessageارسال پیام متنیsendRichMessageارسال پیام غنی اختصاصی جتراsendPhotoارسال عکسsendAnimationارسال پویانماییsendAudioارسال فایل صوتیsendDocumentارسال فایلsendLivePhotoارسال Live Photo جتراsendStickerارسال استیکرsendVideoارسال ویدئوsendVideoNoteارسال پیام ویدئویی گردsendVoiceارسال پیام صوتیsendContactارسال مخاطبsendLocationارسال موقعیت مکانیsendVenueارسال مکان همراه با عنوان و نشانیمدیریت پیام و دکمهها
editMessageTextویرایش متن پیامdeleteMessageحذف پیامanswerCallbackQueryپاسخ به کلیک دکمه درونخطیgetFileدریافت مسیر دانلود فایلپیام موقت اختصاصی جترا
editEphemeralMessageTextویرایش متن پیام موقتeditEphemeralMessageMediaویرایش رسانه پیام موقتeditEphemeralMessageCaptionویرایش توضیح پیام موقتeditEphemeralMessageReplyMarkupویرایش دکمههای پیام موقتdeleteEphemeralMessageحذف پیام موقتمنو و مینیاپ
setChatMenuButtonتنظیم دکمه منوی گفتوگوی رباتgetChatMenuButtonدریافت دکمه منوی فعلیsetUserEmojiStatusتنظیم وضعیت ایموجی کاربر با مجوز اوanswerWebAppQueryپاسخ به درخواست مینیاپsavePreparedInlineMessageذخیره پیام آماده برای اشتراکگذاری از مینیاپمحدودیتها و امنیت
- توکن، رمز کنترل ربات است؛ آن را در کد عمومی، مخزن یا پیام منتشر نکنید. در صورت افشا از
/revokeاستفاده کنید. - حداکثر اندازه هر فایل بارگذاریشده ۲۵ مگابایت است.
getUpdatesحداکثر ۱۰۰ رویداد و timeout حداکثر ۵۰ ثانیه میپذیرد.- Webhook فقط با HTTPS عمومی پذیرفته میشود؛ از
secret_tokenاستفاده کنید. - فقط متدهای فهرستشده در همین صفحه پشتیبانی میشوند.
answerInlineQuery، پرداخت،answerShippingQueryوanswerPreCheckoutQueryدر HTTP API فعلی قابل استفاده نیستند.