GetMyBot Bilgi Tabanı

Mesajlar ve düğmeler

Botun yanıtını metin, fotoğraf, mesaj altı düğmeler ve yanıtı kaydeden sorularla oluşturun.

Bu sayfada

Botun metin, fotoğraf ve «Seç» düğmesi göndermesi için Mesaj gönder eylemini ekleyin. Yanıt, blok denen ayrı parçalardan oluşur. Örneğin önce ürün fotoğrafı, sonra altında düğmeler bulunan açıklama gönderin. Mesaj altındaki düğmelere satır içi düğme de denir.

Aynı eylemde soru sorup yanıtı bekleyebilirsiniz. Örneğin telefon numarasını isteyip müşteri kartına kaydedin. Aşağıda blokları, düğmeleri ve soru ayarlarını bulabilirsiniz.

Mesaj blokları

Blok ekle düğmesine basıp gönderilecek türü seçin. Metin karşılama mesajı, fotoğraf ve ders programı dosyası gibi blokları bir arada kullanabilirsiniz.

  • Metin: yerleştirmeler ve düğmeler içeren, en fazla 4096 karakterlik biçimlendirilmiş metin.
  • Fotoğraf: açıklamalı görsel.
  • Dosya: açıklamalı belge.
  • Sesli mesaj: Telegram'ın sesli mesaj olarak gösterdiği OGG/OPUS, MP3 veya M4A ses dosyası; en fazla 50 MB (sendVoice).
  • GIF: sessiz animasyon veya MP4; en fazla 50 MB (sendAnimation).
  • Video mesajı: en fazla 60 saniyelik kare MP4 (sendVideoNote). Açıklama içermez. Medya kitaplığındaki dosya her gönderimde yeniden yüklenir; Telegram, başka yöntemle alınmış file_id değerini sendVoice, sendAnimation veya sendVideoNote içinde kabul etmez.
  • Karusel: her biri fotoğraf, açıklama ve kendi düğmelerini içeren 2–10 kart. Telegram'da, bütün fotoğraflar için uygun file_id varsa, kartlar «‹ ›» düğmeleriyle tek mesaj içinde gösterilir ve bot editMessageMedia ile kartı değiştirir. ID, kartta belirtilmiş veya medya kitaplığındaki dosyadan alınmış olabilir. Fotoğraflardan birinin ID'si elde edilemezse bütün kartlar ayrı fotoğraf mesajları olarak gönderilir. VK gibi diğer kanallarda da ayrı mesajlar kullanılır. Her kartın açıklaması ve düğmeleri korunur.
  • Gecikme: sonraki bloktan önce saniye cinsinden bekleme.
  • Yapay zekâ: isteme göre modelin ürettiği yanıt.
  • Tepki: başka bir tepkiyi çağırır; isteğe bağlı olarak tamamlanmasını bekler.

Sesli mesaj, GIF, video mesajı ve karusel de diğer bloklar gibi tepkilerde çalışır ve tepkinin hızlı toplu gönderimine katılır (bkz. Toplu gönderimler).

Blokları sürükleyip sıralayabilirsiniz. Gösterim modu Sırayla veya farklı yanıtlar için Rastgele olabilir. Botun ana menüsünü değiştirmeden bırakabilir, yeniden ayarlayabilir veya gizleyebilirsiniz.

Blok seçenekleri

Metin ve medya bloklarında şu ayarlar bulunur: sabitle, sessiz gönder, iletmeye karşı koru, spoiler, bağlantı önizlemesi olmasın, N saniye sonra otomatik sil.

Satır içi düğmeler

Blok içinde Düğme metni ve Tür seçerek düğme ekleyin:

  • Metin: düğme yazısını kişinin yanıtı olarak gönderir. Telegram ve VK'da yanıt klavyesidir; tıklama soruya yanıt verebilir veya metne bağlı tepkiyi başlatabilir. WhatsApp, Instagram, Messenger ve web widget'ında kalıcı klavye yerine yanıt düğmesi kullanılır.
  • Bağlantı: URL açar.
  • Web uygulaması: Telegram Mini App açar. Bkz. Mini App.
  • Tepki çağır: tıklamayla başka bir tepkiyi başlatır.
  • Satır içi sorgu: geçerli sohbetin giriş alanına «@bot sorgu» yerleştirir veya başka sohbet seçtirir (switch_inline_query / switch_inline_query_current_chat). Yalnızca Telegram'da, @BotFather üzerinden /setinline ile inline modu açtıktan sonra kullanılabilir. GetMyBot bu sorguları yanıtlamaz (answerInlineQuery uygulanmamıştır); düğme yalnızca sorgu metnini hazırlar, arama yapmaz.
  • Hazır metin: https://t.me/<bot>?text=… bağlantısı botun sohbetini açar ve metni giriş alanına koyar; hiçbir şey göndermez (prefill).
  • Ödeme bağlantısı: zorunlu ödeme URL'sini açar. Ödeme Ödeme oluştur eylemiyle hazırlanır. Bu, Telegram'ın yerel faturası değil, dış ödeme sayfasına geçiştir.
  • Bildirim: tıklanınca metin gösterir; tepki başlatmaz veya düğmenin kayıtlı Carry verisini aktarmaz. Telegram'da en fazla 200 karakterlik kısa bildirim veya açılır pencere, VK'da pencere olmadan en fazla 90 karakterlik kısa şerit gösterilir.

Metin mi, hazır metin mi?

AmaçTür ve ayarTıklanınca
Formda «Evet» seçmekMetin, düğme yazısı «Evet»; mesaj yanıt beklemeli«Evet» diyalog adımına yanıt olarak iletilir
Mesaj yazmayı kolaylaştırmakHazır metin, düğme yazısı «Yaz», hazır metin «Sipariş vermek istiyorum»Bot sohbetinin giriş alanında taslak açılır; kişi düzenleyip kendisi gönderir

Düğme yazısı ve hazır metin ayrı alanlardır. Hazır metin kendi başına mesaj göndermez veya tepki başlatmaz.

Tepki çağır düğmesine basılması bota ayrı bir olay olarak ulaşır; teknik adı callback'tir. Satır içi sorgu ve Hazır metin düğmeleri Telegram uygulamasında çalıştığından böyle olay üretmez, answerCallbackQuery yanıtını veya Carry verisini desteklemez.

Düğme simgesi ve rengi

Düğme metninin önünde premium emoji gösterebilirsiniz. Simge alanına icon_custom_emoji_id değerini, yani pozitif 64-bit tam sayıyı girin. Örneğin 007, 7 olarak okunur. Harfler, sıfır, negatif veya çok büyük sayılar atılır; düğme simgesiz saklanır.

Telegram simgeyi yalnızca gerekli hakkı olan botlarda gösterir: Fragment üzerinden ek kullanıcı adı veya özel sohbet ya da gruba doğrudan gönderimde bot sahibinin Telegram Premium üyeliği. Diğer botlarda Telegram simgeyi yok sayar; yerine normal emoji koymaz.

Stil, rengi belirler: Normal renksiz, Birincil mavi, Başarı yeşil, Tehlike kırmızı. Teknik alan style olarak adlandırılır.

Tek kullanımlık (single_use) kayıtlı düğme verisinin yalnızca bir kez kullanılmasına izin verir; seçim onayı için uygundur. Düğme yazısını değiştirme ve mesajı silme davranışları ayrıca ayarlanır.

Düğme işaretleri

İşaret, açıp kapatabildiğiniz ek bir ayardır:

  • Yeni satırdan başlat: düğmeyi sonraki satıra taşır.
  • Tüm genişliği kapla: düğmeyi tek başına satıra koyar; sonraki düğme de yeni satırdan başlar.

Tahmini görünüm (köşeli parantezler düğmeyi temsil eder):

Tek satır:           [Katalog] [Yardım]

Yeni satır:          [Katalog]
                    [Yardım]

Tüm genişlik:        [         Yardım         ]

Satırlar ve renkler Telegram ile VK'da kullanılabilir. Satır düzeni yeniden açıp düzenledikten sonra da korunur. Telegram premium emoji yalnızca uygun bağlantıda gösterilir. Telegram içinde aç seçeneği yoktur: Bot API bu davranışı böyle bir işaretle yönetmeye izin vermez.

Kanal sınırları

Blok veya tek düğme için bağlantı seçin. Tüm kanallar seçilirse düzenleyici ortak desteklenen özellikleri kullanır. Desteklenmeyen düğme türü kaydedilemez.

  • Telegram: URL, Mini App, tepki, bildirim/alert, satırlar, renkler ve botun hakkı varsa özel emoji.
  • VK: URL, tepki, snackbar, satırlar ve renkler. VK Mini App ile VK Pay yalnızca uygun VK bağlantısı seçilirse kullanılabilir.
  • WhatsApp: aynı mesajda başka düğme olmadan tek bir CTA URL düğmesi. Yanıt düğmelerinde en fazla 3 normal düğme; 4–10 düğme liste olarak gösterilir. Yazı en fazla 20 karakterdir. Satır, renk, Mini App ve bildirim desteklenmez.
  • Instagram / Messenger: mevcut bağlayıcı yalnızca yanıt düğmelerini (quick replies) iletir; yazı en fazla 20 karakterdir. URL, Mini App, bildirim, satır ve renk desteklenmez.
  • Web widget'ı: URL ve yanıt düğmeleri; satır, renk ve bildirim yoktur.
  • Email: ödeme bağlantısı dahil bağlantılar; yanıt düğmesi ve bildirim yoktur.

Listeden oluşturulan düğmelerde sütun sayısı yalnızca satırları destekleyen kanallarda seçilebilir. Diğer kanallarda düzeni kanal belirler. Düğme sayısı ve yazı uzunluğu sınırları gönderim sırasında kontrol edilir.

Tıklama davranışı

Tıklamayı bota ileten düğmelerde, kanal destekliyorsa mesajı başka metinle veya tepki içeriğiyle değiştirebilir, mesajı silebilir, etiket ekleyebilir veya parametre kaydedebilirsiniz. Düğmenin kendi yazısını değiştirme yalnızca Telegram'da vardır: örneğin «Kaydol» yazısı tıklayınca «Seçildi» olur. VK'da mesaj düzenlenebilse de düğme yazısı değiştirilemez.

Telegram, botun tıklamayı answerCallbackQuery ile onaylamasını bekler. GetMyBot bunu normalde kendisi yapar ve düğmedeki yükleniyor göstergesini kaldırır. answerCallbackQuery atla ayarı bu onayı kapatır.

Tepki düğmesinin Tıklama metni alanına «Ders seçildi» gibi kısa bir onay yazabilirsiniz (Telegram'da en fazla 200, VK'da en fazla 90 karakter; yerleştirmeler çalışır). Telegram bunu genellikle sohbetin üzerinde kısa süre gösterir. Yalnızca Telegram'da bulunan Açılır pencere olarak göster işareti, show_alert ile answerCallbackQuery penceresi açar. Alan boşsa bot yalnızca yükleniyor göstergesini kaldırır. answerCallbackQuery atla açıksa ne metin ne pencere gönderilir.

Düğmedeki veriler (Carry)

Carry, düğmenin hangi öğeyle ilgili olduğunu hatırlamasını sağlar. Örneğin palto ve elbisede aynı «Satın al» düğmesi bulunabilir. İlkine product_id=101, ikincisine product_id=102 kaydedin. Elbisenin düğmesine basılınca sonraki tepki {{ctx.product_id}} değerini 102 olarak alır.

Düzenleyicideki ayarın adı Tıklama verileri. Anahtar değerin adını belirler; değer sayı, metin veya yerleştirme olabilir. Bot veriyi mesajı gönderirken saklar, tıklanınca tepkinin geçici ctx verilerine aktarır. Her düğmenin kendi değerleri vardır.

Geçerlilik süresi (ttl_seconds, TTL) saniye cinsindendir: 3600 bir saattir. 0 varsayılan 30 günü kullanır. Süre bitince verilere erişilemez. Tek kullanımlık (single_use) ilk tıklamadan sonra verileri siler. Kaydedilen fiyat, katalog fiyatı değişince kendiliğinden güncellenmez; ödemeden önce ürün ID'siyle güncel fiyatı kontrol edin.

Adım adım kurulum ve kalıcı parametrelerden farkı: Dinamik düğmeler ve parametreler.

Dinamik düğmeler

Ürün veya dersler zaten bir listede bulunuyorsa her düğmeyi elle eklemeyin. Listeden dinamik düğmeler bloğu her öğe için düğme oluşturur. Listenin ctx içindeki yerini, bir öğenin takma adını, satır başına düğme sayısını ve metin şablonunu seçin. Örneğin {{item.name}} sıradaki ürünün adını ekler. Ayrıntılar: Dinamik düğmeler ve parametreler.

Metinde premium emoji

Metin bloğundaki Premium emoji biçimlendirme düğmesi <tg-emoji emoji-id="…">🙂</tg-emoji> ekler. Telegram Premium kullanan alıcı, etiket içindeki yedek emoji yerine özel emojiyi görür; diğerleri yedek emojiyi görür. Blokta HTML veya Markdown kullanılsa da çalışır. Emoji ID'si en fazla 32 basamaklı sayıdır; getCustomEmojiStickers ile veya emojili mesajı @idstickerbot gibi bir bota ileterek öğrenebilirsiniz.

Bot bağlantısı ve hazır metin

t.me/<bot>?start=<parametre> bağlantısı Telegram'da /start <parametre> komutunu çalıştırır. Bu bağlantıyla sohbeti parametre taşıyarak açıp /start komutunu çalıştırmamak mümkün değildir. Amacınıza göre şu seçeneklerden birini seçin:

  • Sessiz /start: /start komutu tetikleyicisinde uygun Başlangıç bağlantısı etiketi ile tepki oluşturun; Mesaj gönder eylemini bloksuz bırakabilirsiniz. /start için görünür yanıt gelmez, ama etiket olay bağlamında bulunur ve aynı tepkinin koşul ve eylemlerinde kullanılabilir.
  • Hazır metin: https://t.me/<bot>?text=<metin> bağlantısı (Hazır metin veya normal bağlantı düğmesi), sohbeti açıp metni giriş alanına koyar; hiçbir şey göndermez. /start çalışmaz, mesajı kişi kendisi gönderir.
  • Bağlantıyı açınca «kullanıcı adına» otomatik mesaj: Bot API bunu sağlamaz; bot kullanıcı adına mesaj gönderemez. En yakın yol ?start= deep link'i ve istediğiniz metinle bot adına yanıt veren tepkidir.

Beklenen yanıt (diyalog adımları)

Metin bloğu kullanıcının yanıtını bekleyebilir. Bu durumda mesaj diyalog adımına dönüşür ve akış yanıt gelene kadar duraklar. Birkaç adımı art arda kullanarak sohbet içinde form veya yönlendirmeli akış oluşturabilirsiniz.

Beklenen içerik türü

Bot belirli bir yanıt türü bekleyebilir: metin, seçeneklerden seçim (seçenek düğmeleri), fotoğraf, video, video mesajı, ses, belge, sesli mesaj, konum, kişi, takvim veya zar. Kişi başka tür gönderirse adım yanıtı uygun saymaz.

Metni doğrulama

Metin yanıtında telefon, e-posta, bağlantı, tarih, saat veya formülle doğrulama açabilirsiniz. Örneğin telefon beklerken rastgele metin kabul edilmez; bot hata mesajını gösterir. Formül doğrulaması genişletilmiş formül kullanır: başarıda boş metin, ret durumunda hata metni döndürmelidir.

Yanıtı kaydetme

Kişinin yanıtını parametreye kaydedebilirsiniz. Sonraki adımlarda {{param.anahtar}} yerleştirmesiyle veya koşullarda kullanılabilir. Diyalog adımları böylece müşterinin küçük profilini doldurur.

Hatalar, hatırlatma ve zaman aşımı

  • Doğrulama hatası mesajı: uygun olmayan yanıtta gösterilir.
  • Hatırlatma: kişi yanıt vermiyorsa gönderilir.
  • Zaman aşımı: botun yanıt beklemeyi ne zaman bırakacağını belirler. Süre dolduğunda başka bir tepki başlatabilirsiniz; örneğin formu nazikçe bitirmek için. Bu tepki bağlantılarda «Bekleme zaman aşımı», yanıtın tetiklediği tepki ise «Beklenen yanıt» olarak görünür.

Komutla adımdan çıkma

/cancel veya Rusça «отмена» sözcüğü beklemeyi kaldırır ve «Отменено.» yanıtını verir; iptal tepkisi ayarlanmışsa onu başlatır. Diğer komutlar varsayılan olarak normal metin gibi yanıt sayılır ve doğrulanır; böylece kişi yanıt verene kadar adım sürer. Bot komutları (örneğin /start) beklemeyi keser (escape_on_command) açılırsa, anket ortasındaki /start dahil herhangi bir komut beklemeyi sessizce kaldırır ve normal şekilde çalışır.

Yerleştirmeler

Yerleştirmeler düğmesi gönderenin {{first_name}}, {{username}}, {{user_id}} değerlerini; olayın {{text}}, {{chat_id}}, {{datetime}} değerlerini ve {{param.anahtar}} parametrelerini ekler. Tam liste ve formüller: Yerleştirmeler ve formüller.

Botun menü düğmesi

Menü düğmesi eylemi standart bot menüsünü, komutları veya metin ve URL taşıyan Mini App düğmesini seçer. Kapsamı geçerli sohbet veya botun genel ayarı olabilir. Örneğin yalnızca mevcut müşteri için kişisel Mini App belirleyebilirsiniz. Kullanılabilirlik kanalın özelliklerine bağlıdır.

Sonraki adımlar