Geliştirici paneli inkiveta.com

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.

BlokNası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, belgeimage_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 / sendRichMessageDraft ile 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: true verirsen balonda Durdur düğmesi çıkar; basılınca sana stopped_message_generation update'i gelir. keep_on_stop taslağı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 sana widget_query gelir; 15 sn içinde answerWidgetQuery ile yanıtla. Veriyi sonradan editMessageWidgetData ile 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.

  1. 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).
  2. sendGame ile oyunu gönder (game_short_name). Mesajın ilk düğmesi oyunu başlatır.
  3. Düğmeye basılınca callback_query.game_short_name gelir; answerCallbackQuery çağrısında url olarak oyun adresini ver.
  4. Skoru setGameScore ile kaydet, getGameHighScores ile 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.