Düğmeler ve klavyeler
Düğmeler, kullanıcının yazmadan seçim yapmasını sağlar. İki tür vardır: mesajın altına yapışan satır içi düğmeler ve yazma alanının yerine açılan yanıt klavyesi. İkisi de reply_markup alanıyla gönderilir.
Satır içi düğmeler#
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/sendMessage" -H 'Content-Type: application/json' -d '{
"chat_id": 4185489292941965,
"text": "Hangi hizmet?",
"reply_markup": {"inline_keyboard": [
[{"text":"Kesim","callback_data":"hizmet:kesim"}, {"text":"Boya","callback_data":"hizmet:boya"}],
[{"text":"Fiyat listesi","url":"https://ornek.com/fiyat"}],
[{"text":"İptal","callback_data":"iptal","style":"danger"}]
]}
}'
Her iç dizi bir satırdır. Bir düğmenin tek bir eylemi olur:
| Alan | Basılınca |
|---|---|
callback_data (1–64 bayt) | Sana callback_query gelir |
url | Bağlantı açılır (kullanıcıya onay sorulur) |
web_app | Mini App'in açılır |
login_url | Kendi sitene inkiveta hesabıyla oturum açtırır (adres, uygulamanın doğrulanmış Mini App alan adında olmalı) |
copy_text | Metin panoya kopyalanır |
pay | Fatura mesajında ödeme düğmesi (Ödemeler) |
callback_game | Oyun mesajında oyunu başlatır (Oyunlar) |
Düğme stili: style = primary (yeşil dolgu), success, danger (kırmızı). disabled: true düğmeyi soluk ve basılamaz yapar. Inline mod olmadığından switch_inline_query* düğmeleri yoktur.
callback_query'ye yanıt#
Kullanıcı callback_data'lı düğmeye basınca gelir:
json{"update_id":5523,"callback_query":{"id":"7a1c9e…","from":{"id":4185489292941965,"is_bot":false,"first_name":"Kullanıcı"},
"message":{"message_id":42,"chat":{"id":4185489292941965,"type":"private"},"text":"Hangi hizmet?"},
"data":"hizmet:boya"}}
10 saniye içinde answerCallbackQuery çağır; yoksa kullanıcının düğmesi dönmeye devam eder:
pythonfrom telegram.ext import CallbackQueryHandler
async def dugme(update, context):
q = update.callback_query
await q.answer("Boya seçildi") # kısa bildirim (toast)
await q.edit_message_text("Boya için uygun saatler…") # mesajı güncelle
app.add_handler(CallbackQueryHandler(dugme, pattern=r"^hizmet:"))
textkısa bir bildirim gösterir;show_alert: trueonu pencere yapar.urlile bir oyun ya da Mini App adresi açtırabilirsin.- Geç ya da ikinci yanıt:
400 Bad Request: query is too old and response timeout expired or query ID is invalid.
İpucu:
callback_data64 baytla sınırlı. Büyük durumu kendi veritabanında tut, düğmeye yalnız kısa bir anahtar koy (sip:8f3a).
Yanıt klavyesi#
Yazma alanının yerine hazır yanıt düğmeleri koyar. Basılan düğmenin metni kullanıcı mesajı olarak gelir.
json{"chat_id":4185489292941965,"text":"Konumunu paylaşır mısın?",
"reply_markup":{"keyboard":[[{"text":"📍 Konumumu gönder","request_location":true}],
[{"text":"📞 Numaramı paylaş","request_contact":true}],
[{"text":"Vazgeç"}]],
"resize_keyboard":true,"one_time_keyboard":true,
"input_field_placeholder":"Bir seçenek seç"}}
request_location/request_contact: kullanıcı her seferinde onaylar; onaylarsamessage.location/message.contactgelir.resize_keyboard,one_time_keyboard,is_persistent,input_field_placeholder(≤ 64) desteklenir.- Klavyeyi kaldırmak:
{"remove_keyboard": true}. Kullanıcıyı yanıt yazmaya zorlamak:{"force_reply": true}.
Komut menüsü ve menü düğmesi#
setMyCommandsile verdiğin komutlar kullanıcı/yazınca listelenir (Atölye).setChatMenuButtonyazma alanının yanındaki düğmeyi belirler: komut listesi ya da bir Mini App.- Yazma alanının üstüne en çok 6 kısayol düğmesi koymak için hızlı eylemler'i kullan.
Hangi seçimi ne ile yapmalı?#
| İhtiyaç | Önerilen |
|---|---|
| 2–6 basit seçenek | Satır içi düğmeler |
| Tarih / saat seçtirmek | [calendar](/gelistiriciler/bilesenler#calendar), [time_strip](/gelistiriciler/bilesenler#time-strip) bileşenleri |
| Uzun listeden seçim | [dropdown](/gelistiriciler/bilesenler#dropdown), [search_select](/gelistiriciler/bilesenler#search-select) |
| Birden çok alanlı form | [multistep_form](/gelistiriciler/bilesenler#multistep-form) |
| Konum / telefon | Yanıt klavyesi ya da [location_pick](/gelistiriciler/bilesenler#location-pick) |
| Her zaman erişilebilen kısayollar | Hızlı eylemler |