Mesajlar ve Düğmeler

«Mesaj Gönder» eylemi, botun yanıtını bloklardan oluşturur ve buna inline düğmeler, ana menü ve diyalog adımları ekler. Bu, yapılandırıcının en zengin eylemidir — değişken yerleştirme ve düğmelerin referral parametreleri de buradan ayarlanır.

Mesaj Blokları

Mesaj, bloklardan oluşan bir dizidir (Blok Ekle düğmesi):

  • Metin — değişken yerleştirme ve düğmelerle biçimlendirilmiş metin (4096 karaktere kadar).
  • Fotoğraf — açıklamalı görsel.
  • Dosya — açıklamalı belge.
  • Gecikme — bir sonraki bloktan önce saniye cinsinden duraklama.
  • IA — bir promta göre model tarafından oluşturulan yanıt.
  • Tepki — başka bir tepkinin çağrısı (isteğe bağlı olarak işlenmesini bekleyerek).

Bloklar sürüklenip bırakılabilir. Blok gösterim modu — «Sırayla» veya «Rastgele» (değişken yanıtlar için). Botun ana menüsü değiştirilmeden bırakılabilir, yeni biri belirlenebilir veya gizlenebilir.

Blok Seçenekleri

Metin ve medya bloklarında bayraklar bulunur: sabitle, sessiz, iletmeyi koru, bozma (spoiler), bağlantı önizlemesini kapat, N saniye sonra otomatik sil.

Inline Düğmeler

Blokta düğmeler yapılandırılır (Düğme Metni + Tür):

  • Metin (callback) — bot tarafında tıklama işleyen düğme.
  • Bağlantı — URL açar.
  • Web Uygulaması — Telegram Mini App açar. Bkz. Mini App.
  • Tepki çağır — tıklama başka bir tepkiyi tetikler.
  • Ödeme Al ve Bildirim — «yakında» olarak işaretlenmiştir.

Düğme stili — normal, mavi (Primary), yeşil (Success) veya kırmızı (Danger). «Tek kullanımlık» bayrağı, tıklamanın ardından düğmeyi devre dışı bırakır.

Tıklama Davranışı

Callback düğmeleri için tıklama sırasında ne olacağı yapılandırılır: düğme metnini değiştir, mesajı değiştir (metinle veya bağlı bir tepkinin içeriğiyle), mesajı sil, answerCallbackQuery'yi atla. Tıklama aynı zamanda etiket ekleyebilir ve parametreler belirleyebilir.

Düğmedeki Parametreler (Carry)

«Carry — düğme tıklamasındaki veri anlık görüntüsü» bloğu, gönderim anında sabitlenmiş bir değerler kümesini düğmeye ekler. Tıklandığında bu değerler bağlama girer — böylece çok sayıda düğme olsa bile her düğme kendi parametrelerini taşır (per-invocation). Payload geçerlilik süresi saniye cinsinden belirlenir. Bu, «ürün seç → tam olarak onu sipariş et» senaryolarının temelidir.

Dinamik Düğmeler

«Listeden dinamik düğmeler» bloğu, ctx'teki bir diziyi düğmelere açar — her öğe için bir düğme. Şunlar yapılandırılır: ctx'teki liste anahtarı, öğe takma adı, satır başına düğme sayısı ve düğme şablonu ({{alias.alan}} destekler). Bu yöntemle kataloglar, kayıt listeleri ve koleksiyon verilerinden menüler oluşturulur. Ayrıntılar — Dinamik Düğmeler ve Parametreler.

Beklenen Yanıt (Diyalog Adımları)

Bir metin bloğu kullanıcı yanıtı bekleyebilir — bu, mesajı bir diyalog adımına dönüştürür ve yanıt gelene kadar senaryoyu duraklatır. Arka arkaya birkaç adım, sohbet içinde doğrudan bir anket veya sihirbaz oluşturur.

Beklenen İçerik Türü

Bot belirli bir yanıt türü bekleyebilir: metin, seçeneklerden seçim (seçenek düğmeleri), fotoğraf, video, video not, ses, belge, sesli mesaj, konum, kişi, takvim veya zar. Kullanıcı yanlış türde bir şey gönderirse adım, yanıtı uygunsuz sayar.

Metin Doğrulama

Metin yanıtı için format doğrulaması etkinleştirilebilir: telefon, e-posta, bağlantı, tarih, saat veya formüle uygunluk (düzenli ifade). Doğrulamayı geçemeyen yanıt reddedilir ve bot hata mesajını gösterir.

Yanıtı Kaydetme

Kullanıcı yanıtı bir parametreye kaydedilebilir — bu durumda {{param.anahtar}} yerleştirmelerinde ve koşullarda kullanılabilir olur. Böylece diyalog adımları mini müşteri profili oluşturur.

Hatalar, Hatırlatma ve Zaman Aşımı

  • Doğrulama hatası mesajı — yanıt doğrulamayı geçemezse ne gösterilecek.
  • Hatırlatma — kullanıcı sessiz kalırsa ne gönderilecek.
  • Zaman aşımıyla beklemeyi kaldır — ne kadar süre bekleneceği; zaman aşımında bir tepki tetiklenebilir (örneğin anketi nazikçe sonlandırmak için). Bu tepki, bağlantılarda «Bekleme Zaman Aşımı», yanıtın kendi tepkisi ise «Beklenen Yanıt» olarak görünür.

Değişken Yerleştirme

«Yerleştirmeler» düğmesi değişken ekler: gönderici verileri ({{first_name}}, {{username}}, {{user_id}}), olay verileri ({{text}}, {{chat_id}}, {{datetime}}) ve parametreler ({{param.anahtar}}). Tam liste ve formüller — Yerleştirmeler ve Formüller.

Sonraki Adımlar