Zengin mesaj, akış, widget, oyun
Telegram Bot API 10.4'ün yeni zengin özellikleri inkiveta'da çalışır ve uygulamanın kendi çizicileriyle gösterilir.
Zengin mesaj (sendRichMessage)#
Başlık, paragraf, liste, tablo, kod, LaTeX formülü, alıntı, açılır bölüm, harita, galeri ve düğme satırlarını tek mesajda gönderirsin. inkiveta her bloğu karşılık gelen yerel bileşene çevirir; mesaj tek bir message_id altında, bileşenler alt alta çizilir. Sana dönen Message nesnesinde inki_components (sıralı liste) bulunur.
| Blok | Nasıl çizilir |
|---|---|
| Paragraf, başlık (1–3), kod, alıntı, liste, ayraç, dipnot | [rich_text](/gelistiriciler/bilesenler#rich-text) |
| Matematik (LaTeX) | rich_text içinde yerel formül çizimi |
| Açılır alıntı, Details | [accordion](/gelistiriciler/bilesenler#accordion) |
| Tablo | [table](/gelistiriciler/bilesenler#table) (8 sütundan fazlası kod bloğu, 50 satırdan fazlası birden çok tabloya bölünür) |
| Kolaj, slayt gösterisi | [gallery](/gelistiriciler/bilesenler#gallery) (en çok 10 görsel) |
| Harita | [location](/gelistiriciler/bilesenler#location) |
| Fotoğraf, video, ses, belge | image_card, video, audio, document |
| Düğme satırı | Normal satır içi düğmeler (basılınca callback_query) |
Satır içi biçimler: kalın, eğik, altı çizili, üstü çizili, spoiler, kod, vurgulu, alt/üst simge, https:// bağlantı, dipnot. E-posta, telefon, bahsetme, etiket gibi öğeler düz metne düşer.
Sınırlar: blokta ≤ 100 parça, listede ≤ 50 öğe, bileşende ≤ 100 blok, metin ≤ 4.096; çok uzun içerik otomatik bölünür.
Akışlı yanıt (yapay zekâ sohbet botları için)#
Bir dil modelinin cevabını kelime kelime göstermek için:
sendMessageDraft/sendRichMessageDraftile aynıdraft_id'yi tekrar tekrar göndererek balonu büyütürsün; kullanıcı yanıtın yazıldığını canlı görür.can_stop: trueverirsen balonda Durdur düğmesi çıkar; basılınca sanastopped_message_generationupdate'i gelir.keep_on_stoptaslağın kalıp kalmayacağını belirler.- Aynı sohbete kesin (normal) bir mesaj gönderdiğinde açık taslaklar kapanır.
sendRichMessageDraft'ta "düşünüyor" bloğu yalnız akış sırasında gösterge olarak çizilir, kalıcı mesaja yazılmaz.
Widget#
sendWidget küçük, kendi tasarımın olan bir HTML kartı gönderir (ör. bir hisse fiyat kartı, bir skor tablosu).
- HTML 1–32.768 bayt ve zlib ile sıkıştırınca ≤ 4.096 bayt.
- Genişlik ≥ 200, yükseklik 50–600.
- JavaScript kapalı ve ağ erişimi yok: yalıtılmış görünümde çizilir. Görseller ve fontlar yalnız
data:adresiyle; stil satır içi. public_data/chat_data≤ 1.024 bayt. Widget veri istediğinde sanawidget_querygelir; 15 sn içindeanswerWidgetQueryile yanıtla. Veriyi sonradaneditMessageWidgetDataile güncellersin.- Paylaşılan widget (
sendSharedWidget,editSharedWidgetData) yoktur.
İpucu: Etkileşimli bir şey istiyorsan widget yerine yerel bileşenler ya da Mini App kullan; widget yalnız görüntüdür.
Oyunlar#
HTML5 oyununu uygulaman üzerinden oynatabilirsin.
- Oyunu Atölye → Oyunlar'da kaydet: kısa ad, başlık, açıklama, fotoğraf ve oyun adresi. Adres, uygulamanın doğrulanmış Mini App alan adında olmalı (Mini App).
sendGameile oyunu gönder (game_short_name). Mesajın ilk düğmesi oyunu başlatır.- Düğmeye basılınca
callback_query.game_short_namegelir;answerCallbackQueryçağrısındaurlolarak oyun adresini ver. - Skoru
setGameScoreile kaydet,getGameHighScoresile sıralamayı al.
Çok oyunculu, gerçek zamanlı oyunda oyuncular bir oyun odasına bağlanır; odada oynanan oyunun skorunu setGameScore'a game_room_id vererek yazarsın.
Kayıtsız oyun adı GAME_SHORTNAME_INVALID döner. Uygulamanın Atölye kategorisi Oyun ise, ebeveyn denetiminde oyunları kapalı olan kullanıcılarda oyun ve Mini App açılmaz.