Düğme makalesini okumanızı öneririz.
Telegram'da hem yanıt düğmelerini (normal veya klavye düğmeleri) hem de Satır İçi düğmeleri (metin içindeki düğmeler) kullanabilirsiniz.
Önemli: düğme sınırlamaları
Düğme oluştururken lütfen aşağıdaki platform kısıtlamalarının farkında olun:
- Yanıt düğmeleri (klavye): Satır başına maksimum 12 düğme.
- Satır İçi düğmeler: Satır başına maksimum 8 düğme.
- Düğme metni: 32 karakterle sınırlıdır.
- Düğme rengi: özelleştirilemez. Düğmeler varsayılan platform stilini kullanır.
Blokta düğme oluşturma
Bir sohbet robotunda herhangi bir düğme oluşturmak için blok ayarlarına gidin ve "Düğmeler" sekmesine tıklayın:
Ardından düğme ekleme ve düzenleme ayarları açılacaktır. Ardından Ekle'ye tıklayın:
Düğmenin etiketini, eylemini ve ek seçeneklerini tanımlamanıza olanak tanıyan bir ayarlar penceresi açılacaktır.
Aşağıdaki düğme türleri yalnızca Telegram botu için kullanılabilir:
- Paylaş düğmesi – kullanıcıların içerik paylaşmasına olanak tanır.
- Geri arama düğmesi – botunuza sessiz bir geri arama sorgusu gönderir.
- Telegram WebApp – Telegram içinde bir mini uygulama (örneğin, bir widget veya web sitesi) açar.
- Telegram girişi – kullanıcıları Telegram hesapları aracılığıyla yetkilendirir.
Telegram'da ödeme, telefon numarası veya konum isteme ve bağlantı gönderme gibi başka düğmeler de mevcuttur.
Paylaş düğmesi
Düğmeyi oluştururken "Paylaş (Yalnızca Telegram)" seçeneğini belirleyin ve alanları doldurun (isteğe bağlı ek metin alanı):
Bu düğme, listenizden bir kişi seçerek bilgileri iletmenizi sağlar.
Düğmenin "Paylaş bağlantısı" alanına paylaşmak istediğiniz URL'yi girin.
Bir kişi seçildikten sonra, "Paylaş bağlantısı" ve "Ek metin" alanlarındaki içerik gönderilecektir. Telegram kanal gönderilerine ve diğer içeriklere bağlantılar paylaşmak için kullanın.
Dikkat! Bazı iOS cihazlarda doğru çalışmayabilir.
Web sitesi giriş düğmesi
Giriş düğmesinin çalışması için botunuzun öncelikle hedef alan adı için yetkilendirilmesi gerekir. Bu yapılandırma @BotFather aracılığıyla yapılır.
Yapılandırma adımları:
- @BotFather ile bir sohbet açın.
- Listeden botunuzu seçin.
- Bot Ayarları > Alan Adı'nı seçin ve web sitenizin alan adını ekleyin.
Ardından, Alan Adı düğmesine gidin:
Not: Bir alan adı varsa düğme Alan adını düzenle, eklenmesi gerekiyorsa Alan adını ayarla şeklinde okunacaktır.
Botunuz için alan adını ayarlamanız istenecektir:
Doğru alan adı biçimi:
Alan adınızı mavibot.ai veya MaviBot'a bağlı bir web siteniz varsa yourdomain.com olarak girin.
Sonraki adım:
Alan adınız doğrulandıktan ve yapılandırıldıktan sonra yetkilendirme düğmesini oluşturmaya devam edebilirsiniz.
Metin alanına düğmede görünecek etiketi girin.
Ardından, yetkilendirmenin gerçekleşeceği sayfanın URL'sini Bağlantı alanına sağlayın.
Kalan alanlar, yetkilendirme için ayrı bir bot kullanılıyorsa gerekli olacaktır (bu bot için mesaj gönderme izni almanız gerekir): özellikle, botun adını belirtmeniz gerekecektir.
Belirtilen bottan mesaj gönderebilmeniz gerekiyorsa, "Kullanıcıdan bottan mesaj gönderme izni iste" kutusunu işaretlediğinizden emin olun:
Telegram giriş düğmesi
Geri arama düğmesi
Geri arama düğmesi, müşterinin bir şey gördüğü ve botta huninin herhangi bir bloğunu başlatmak için ihtiyacımız olan geri aramayı aldığımız bir geri bildirim düğmesidir.
Oluşturmak oldukça basittir: Düğmeler alanında Ekle düğmesine tıklayın. Açılan formda metni girin, türü - Geri arama düğmesi (Telegram) olarak belirtin ve düğmeye tıklandığında dönmesi gereken Geri arama metnini girin:
Görsel olarak düğme, normal bir satır içi düğmeye benzer:
Düğmeye tıkladıktan sonra, müşteri kartında yapılandırılmış Geri aramayı göreceksiniz:
Bu önemlidir!
Telegram, Geri arama klavye düğmelerini desteklemez.
Lütfen dikkat!
"Geri arama" düğme türü seçilirse, düğme yalnızca düğmenin metni geri aramanın metninden farklıysa geri arama olarak görüntülenecektir.
Telegram Web Uygulaması düğmesi
Bu düğme, web sitesini Telegram'da bir web uygulaması olarak açmanıza olanak tanır.
Düğmeyi eklerken etiketini belirtin, Telegram Web Uygulaması düğmesi türünü seçin ve web uygulaması olarak açılacak web sitesine bağlantıyı sağlayın:
- Bir değişken aracılığıyla bir bağlantı belirtebilirsiniz:
Hedef sayfa veya web sitesi adresi sık sık değiştiğinde, bir bağlantı için değişken kullanmak oldukça pratiktir.
Nasıl çalışır:
- Proje ayarlarınızda bir değişken tanımlayın (örneğin,
landing_page_url). - Bu değişkene (örneğin,
#{landing_page_url}) tüm akışlarınızdaki tüm Web Uygulaması düğmelerinde başvurun.
Fayda: her bir düğme bloğundaki URL'yi manuel olarak güncellemek yerine, proje ayarlarında değişkenin değerini yalnızca bir kez değiştirmeniz yeterlidir ve tüm düğmeler otomatik olarak güncellenecektir.
Alternatif: elbette, düğme ayarlarında doğrudan statik bir URL de belirtebilirsiniz.
Telegram API işlevleri için düğme oluşturma
Telegram Bot API ile doğrudan çalışmak, özellikle yeni başlayanlar için zorlayıcı olabilirken, MaviBot çok daha erişilebilir bir alternatif sunar.
Yöntem: oluşturulan kodu kullanma
Gelişmiş ayarlardan önceden oluşturulmuş düğme kodunu kullanarak API çağrılarını manuel olarak yazma ihtiyacını ortadan kaldırabilirsiniz.
Adımlar:
- Blok ayarlarınıza gidin ve Düğmeler bölümünü açın.
- Gerekli tüm düğmelerinizi (metin, bağlantılar, işlevler) eklemek ve yapılandırmak için arayüzü kullanın.
- Sistem arka planda otomatik olarak doğru Telegram API kodunu oluşturacaktır.
Bu yaklaşım, platform alttaki teknik uygulamayı hallederken görsel olarak karmaşık klavyeler oluşturmanıza olanak tanır.
Düğmeleriniz için oluşturulan Telegram API kodunu görüntülemek üzere "Gelişmiş Ayarlar" seçeneğine tıklayın.
Düğmelerinizi test edin, ardından Gelişmiş Ayarlar'dan oluşturulan kodu buttons gibi bir değişkene kopyalayın.
Bu işlev, Telegram API aracılığıyla aşağıdaki parametrelerle bir mesaj gönderir: tg_send_message (platform_id, text,client_message_id, reply_markup, sparse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities):
reply_markup parametresindeki işleve buttons değişkenini iletin:
Düğmeleriniz, tanımladığınız düzen ve stille sohbette görünecektir.
Yanıt düğmelerini silme
Klavye düğmeleri genellikle otomatik olarak kaybolurken, bazen görünür kalabilirler.
Kalıcı yanıt düğmelerini zorla temizlemek için Gelişmiş Ayarlar alanına aşağıdaki kodu ekleyin:
[{"buttons":[],"one_time":true,"index_in_line":0,"line":0}]
Bu boş düğme yapılandırması, Telegram'a özel klavyeyi gizlemesini söyler.
Telegram'da klavye menü düğmeleri
Bu özelliği yalnızca ileri düzey kullanıcılar için kullanmanızı öneririz!
Klavye düğmeleri
Klavye düğmelerini (yanıt) kalıcı bir Telegram menüsü olarak kullanabilmek için, tg_permanent_reply_buttons değişkenine herhangi bir değer atamanız yeterlidir (değişken projenin bir sabiti olarak bildirilir).
Değişken: tg_permanent_reply_buttons
tg_permanent_reply_buttons değişkenini ayarlamak, yanıt klavyesinin (mesajın altındaki düğmeler) görünürlüğü üzerinde tam manuel kontrol sağlar. Platform tarafından tüm otomatik gizleme davranışı devre dışı bırakılır.
Kapsam: bu ayar, değişken etkinken bottaki tüm yanıt düğmeleri için geçerlidir.
Otomatik davranışa dönme
Standart otomatik klavye gizlemeyi geri yüklemek için:
-
tg_permanent_reply_buttonsdeğişkenini proje ayarlarınızdan kaldırın. - Değişken etkinken oluşturulmuş yanıt düğmelerini yeniden oluşturun. "Kalıcı" kural altında oluşturulan düğmeler bu durumu korur ve yeni, otomatik davranışı devralmak için yeniden oluşturulmalıdır.
Telegram'da menü oluşturma
Telegram botunu oluşturan kişi böyle bir menü yapabilir.
Bunu yapmak için Telegram'da Botfather'a yazın.
/mybots komutunu girin, botlarınızın listesi açılır. İhtiyacınız olanı seçin. Sizin için bir menü açılır. Burada Botu Düzenle'yi ve ardından Komutları Düzenle'yi seçmeniz gerekir.
Tüm komutları ve açıklamalarını tek bir mesaja girin, komut adları için küçük harfler kullanın. Liste güncellendiğinde bir onay alacaksınız.
Artık Telegram'da botla sohbetinizde menüyü görebilir ve kullanabilirsiniz.
Menü düğmesine tıkladığınızda, daha önce BotFather'da kaydedilmiş komutların bir listesi açılacaktır:
Ardından, Mavibot'a gidin, bu telegram botunun bağlı olduğu projeyi açın.
Başlangıç veya Tetikleyici bloklarını oluşturun, koşullara komutları ve "Mesaj metni" alanına yanıt olarak alınacak metinleri yazın.
Örnek:
İki tür düğmeyi birleştirme
Görselleştirmek istediğiniz bir yanıt düğmesi (klavye) içeren bir blok oluşturun.
Yanıt düğmelerini kaldırmadan yerleştirilmesi gereken satır içi düğmelerle (metin içindeki düğmeler) sonraki bloğu (0 saniyelik bir zamanlayıcı) oluşturun. Örneğin: [{"type": "inline", "text": "DÜĞME ADI", "line": 0, "index_in_line": 0}]
İşte sonuç:
Önemli: aynı blokta düğme eklerken bu sırayı izlemelisiniz:
- Önce, tüm Yanıt (klavye) düğmelerini ekleyin.
- Ardından, herhangi bir Satır İçi düğme ekleyin.
Bu sıra tersine çevrilirse, bir sonraki mesaj bloğu gönderildiğinde yanıt düğmeleri kaldırılacaktır.