Geliştirici paneli inkiveta.com

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:

AlanBasılınca
callback_data (1–64 bayt)Sana callback_query gelir
urlBağlantı açılır (kullanıcıya onay sorulur)
web_appMini App'in açılır
login_urlKendi sitene inkiveta hesabıyla oturum açtırır (adres, uygulamanın doğrulanmış Mini App alan adında olmalı)
copy_textMetin panoya kopyalanır
payFatura mesajında ödeme düğmesi (Ödemeler)
callback_gameOyun 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:"))
  • text kısa bir bildirim gösterir; show_alert: true onu pencere yapar.
  • url ile 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_data 64 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; onaylarsa message.location / message.contact gelir.
  • 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#

  • setMyCommands ile verdiğin komutlar kullanıcı / yazınca listelenir (Atölye).
  • setChatMenuButton yazma 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çenekSatı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 / telefonYanıt klavyesi ya da [location_pick](/gelistiriciler/bilesenler#location-pick)
Her zaman erişilebilen kısayollarHızlı eylemler