Chatbotlar için Telegram düğmeleri

Makaleyi okumanızı öneririz Buton.

Telegram'da hem yanıt düğmelerini (normal veya klavye düğmeleri) hem de Inline 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): en fazla satır başına 12 düğme.

• Satır içi düğmeler: En fazla satır başına 8 düğme.

• Düğme metni: Şunlarla sınırlıdır: 32 karakter.

• Buton rengi: özelleştirilemez. Düğmeler varsayılan platform stilini kullanır.

Bir blokta düğme nasıl oluşturulur

Bir chatbotta herhangi bir düğme oluşturmak için blok ayarlarına gidin ve şuna tıklayın: "Düğmeler" sekmesine gidin:

Ardından düğme ekleme ve düzenleme ayarları açılacaktır. Sonra tıklayın Ekle:

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 çağırma sorgusu gönderir.

• Telegram WebApp – Telegram içinde küçük bir uygulama (ör. bir widget veya web sitesi) açar.

• Telegram girişi – kullanıcıları Telegram hesapları üzerinden yetkilendirir.

Telegram'da ödeme, telefon numarası veya konum isteği ve bağlantı gönderme gibi başka düğmeler de mevcuttur.

Paylaş düğmesi

Düğme oluştururken "Paylaş (yalnızca Telegram)" seçin ve alanları doldurun (isteğe bağlı ek metin alanı):

Bu düğme, listeden bir kişi seçerek bilgileri iletmenizi sağlar.

Paylaşmak istediğiniz URL'yi düğmenin "Bağlantıyı paylaş" alanına yapıştırın.

alanına girin. Bir kişi seçildikten sonra, "Bağlantıyı paylaş" ve "Ek metin" alanlarındaki içerik gönderilecektir. Bunu Telegram kanal gönderilerine ve diğer içeriklere bağlantı 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 önce hedef alan için yetkilendirilmesi gerekir. Bu yapılandırma şunun üzerinden yapılır: @BotFather.

Yapılandırma adımları:

1. Bir sohbet açın @BotFather.

2. Listeden botunuzu seçin.

3. Seçin Bot Ayarları > Alan adı ve web sitenizin alan adını ekleyin.

Sonraki adımda, Alan adı düğmesine tıklayın:

Not: Düğmede şu yazacaktır: Alan adını düzenle eğer bir alan adı varsa veya Alan adı ayarla eğer eklenmesi gerekiyorsa.

Botunuz için alan adını ayarlamanız istenecektir:

Doğru alan adı biçimi:

Alan adınızı şu şekilde girin: mavibot.ai veya şu şekilde: yourdomain.com eğer MaviBot'a bağlı bir web siteniz varsa.

Sonraki adım:

Alan adınız doğrulanıp yapılandırıldıktan sonra, yetkilendirme düğmesini oluşturmaya devam edebilirsiniz.

içinde 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 girin.

Ayrı bir bot yetkilendirme için kullanılıyorsa kalan alanlar 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 bot adına mesaj gönderme izni iste":

Telegram giriş düğmesi

Geri arama düğmesi

Geri çağırma düğmesi, istemci bir şeyi görürken biz botta herhangi bir huni bloğunu başlatmak için gereken geri çağırmayı aldığımız bir geri bildirim düğmesidir.

Bunu oluşturmak oldukça basit: Düğmeler alanında Ekle düğmesine tıklayın. Açılan formda metni girin, türü belirtin - Geri çağırma düğmesi (Telegram) ve düğmeye tıkladığınızda geri dönmesi gereken Geri çağırma metni giriniz:

Görünüşte düğme normal bir inline düğme gibi görünür:

Düğmeye tıkladıktan sonra, yapılandırılmış Geri çağırma müşterinin kartında göreceksiniz:

Önemli!

Telegram, Geri çağırma klavye düğmelerini desteklemez.

Lütfen dikkat edin!

Eğer "Geri çağırma" düğme türü seçildiğinde, düğme yalnızca düğme metni geri çağırma metninden farklıysa geri çağırma olarak görüntülenir.

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 App düğmesi türünü seçin ve web uygulaması olarak açılacak web sitesinin bağlantısını sağlayın:

• Bir bağlantıyı bir değişken üzerinden belirtebilirsiniz:

Bağlantı için bir değişken kullanmak, hedef sayfa veya web sitesi adresi sık sık değiştiğinde oldukça pratiktir.

Nasıl çalışır:

1. Bir değişken tanımlayın (ör. landing_page_url) proje ayarlarınızda.

2. Bu değişkene referans verin (ör. #{landing_page_url}) tüm akışlarınızdaki Web App düğmelerinde kullanın.

Avantajı: URL'yi her bir düğme bloğunda manuel olarak güncellemek yerine, proje ayarlarında değişkenin değerini yalnızca bir kez değiştirmeniz yeterlidir; tüm düğmeler otomatik olarak güncellenecektir.

Alternatif: elbette, düğme ayarlarında doğrudan sabit bir URL de belirtebilirsiniz.

Telegram API işlevleri için düğmeler nasıl oluşturulur

Telegram Bot API ile doğrudan çalışmak, özellikle yeni başlayanlar için zor olabilir; ancak MaviBot çok daha erişilebilir bir alternatif sunar.

Yöntem: oluşturulmuş kodu kullanın

Şunu kullanabilirsiniz: önceden oluşturulmuş düğme kodunu gelişmiş ayarlardan, böylece API çağrılarını manuel olarak yazmanız gerekmez.

Adımlar:

1. Blok ayarlarınıza gidin ve şunu açın: Düğmeler bölümünde görünecektir.

2. Gerekli tüm düğmeleri (metin, bağlantılar, işlevler) eklemek ve yapılandırmak için arayüzü kullanın.

3. Sistem doğru Telegram API kodunu arka planda otomatik olarak oluşturacaktır.

Bu yaklaşım, platform alttaki teknik uygulamayı üstlenirken karmaşık klavyeleri görsel olarak oluşturmanıza olanak tanır.

Tıklayın "Gelişmiş Ayarlar" düğmeleriniz için oluşturulan Telegram API kodunu görüntülemek için.

Düğmelerinizi test edin, ardından oluşturulan kodu şuradan kopyalayın: Gelişmiş Ayarlar şunun gibi bir değişken içine: buttons.

Bu işlev, Telegram API üzerinden 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):

Düğmeler değişkenini işlevde reply_markup parametresine aktarın:

Düğmeleriniz, tanımladığınız düzen ve stille sohbette görünecektir.

Yanıt düğmeleri nasıl silinir

Klavye düğmeleri genellikle otomatik olarak kaybolsa da, bazen görünür kalabilirler.

Kalan yanıt düğmelerini zorla temizlemek için, aşağıdaki kodu içine ekleyin: Gelişmiş Ayarlar alanını bulun:

[{"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 atamak yeterlidir (değişken proje için sabit olarak tanımlıdır).

Değişken: tg_permanent_reply_buttons

Değişkeni ayarlamak, yanıt klavyesinin (mesajın altındaki düğmeler) görünürlüğü üzerinde tam manuel kontrol sağlar. Platformun tüm otomatik gizleme davranışı devre dışı bırakılır. tg_permanent_reply_buttons Değişkeni ayarlamak size tam manuel kontrol yanıt klavyesinin görünürlüğü üzerinde (mesajın altındaki düğmeler). Platformun tüm otomatik gizleme davranışı devre dışı bırakılır.

Kapsam: bu ayar tüm değişken etkin olduğu sürece botta oluşturulan yanıt düğmelerine uygulanır.

Otomatik davranışa geri dönme

Standart otomatik klavye gizlemeyi geri yüklemek için:

1. Şunu kaldırın: tg_permanent_reply_buttons değişkeni proje ayarlarınızdan.

2. Herhangi bir yanıt düğmesini yeniden oluşturun başlangıçta değişken aktifken oluşturulmuş olanlar. "kalıcı" kuralı altında oluşturulan düğmeler bu durumu korur ve yeni, otomatik davranışı devralmak için yeniden oluşturulmaları gerekir.

Telegram'da menü nasıl oluşturulur

Telegram botunu oluşturan kişi böyle bir menü yapabilir.

Bunu yapmak için şuraya yazın: Botfather Telegram'da.

/mybots komutunu girin ve botlarınızın listesi açılır. İhtiyacınız olanı seçin. Sizin için bir menü açılır. Burada şunu seçmeniz gerekir: Botu Düzenle, ve ardından Komutları Düzenle.

Tüm komutları ve açıklamalarını tek bir mesajda girin; komut adları için küçük harf kullanın. Liste güncellendiğinde bir onay alacaksınız.

Artık Telegram sohbetinizde botla 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.

blokları Başlat veya Tetikleyici oluşturun, koşullara komutları yazın ve "Mesaj metni" alanına — karşılık olarak alınacak metinleri.

Örnek:

İki düğme türü nasıl birleştirilir

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 inline düğmeler (metin içindeki düğmeler) içeren bir 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:

1. Önce, tüm Yanıt (klavye) düğmelerini ekleyin.

2. Sonra, herhangi bir Inline düğme ekleyin.

Bu sıra ters çevrilirse, sonraki mesaj bloğu gönderildiğinde yanıt düğmeleri kaldırılacaktır.