Telegram Mini App ile Teklif Formu Nasıl Tasarlanır?

Telegram Mini App ile teklif formu nasıl tasarlanır?

Telegram Mini App teklif formu, kullanıcıya sohbet içinde çok sayıda komut yazdırmadan yapılandırılmış bilgi toplamaya yarayan küçük bir web arayüzüdür. Bot, uygun düğmeyle arayüzü açar; form gerekli alanları gösterir; gönderimden sonra sunucu veriyi doğrular ve talebi ilgili ekibe aktarır. Ancak Mini App'in açılması kullanıcı kimliğinin otomatik doğrulandığı anlamına gelmez. Telegram'ın Mini Apps dokümanı, initData değerinin sunucu tarafında doğrulanması gerektiğini ve initDataUnsafe alanına güvenilmemesi gerektiğini açıkça söylüyor.

Bu yaklaşım, kısa bir sohbet mesajıyla anlatılamayan proje ihtiyaçlarında yararlı olabilir. Ama formu gereksiz büyütürseniz kullanıcı Telegram'dan çıkmadan da yorulur. Amaç ilk temas için gereken bilgiyi düzenli almak, ayrıntılı keşfi sonradan yapmaktır. Webinle açısından bu içerik bir ürün vaadi değil, bot ve web arayüzü birleşiminin nasıl kapsamlandırılacağına dair teknik bir rehberdir.

Hangi talep için Mini App gerekir?

Yalnızca ad ve kısa mesaj isteyen bir akışta normal bot soruları yeterli olabilir. Mini App, seçeneklerin koşullu değiştiği, birden fazla hizmetin seçildiği veya dosya ve kapsam bilgisinin açık biçimde gözden geçirilmesi gereken taleplerde daha anlamlıdır. Önce kullanıcı yolculuğunu çizin: Botta hangi mesaj Mini App'i açıyor, kullanıcı yarım bırakırsa ne oluyor, tamamlanan talep kime iletiliyor? Formu sırf yeni bir teknoloji kullanmak için eklemeyin.

Teklif alanları hizmete göre değişebilir. Web yazılımı için mevcut site adresi ve hedeflenen iş akışı; otomasyon için kullanılan sistemler ve manuel adımlar; mobil uygulama için hedef kullanıcı ve platform bilgisi istenebilir. Her alanın karar sürecindeki rolünü yazın. “Belki lazım olur” diye kişisel veya ticari verileri toplamak yerine ilk görüşmeyi başlatacak en küçük veri kümesini seçin. Talebin gönderildiği an, kullanıcının verdiği bilgiler ve sonraki iletişim beklentisi açık olmalıdır.

Form botta nasıl açılmalı?

Telegram farklı Mini App açılış yolları sunar. Klavye düğmesi, satır içi düğme ve menü düğmesi aynı görünse bile veri dönüşü ve kullanıcı bağlamı bakımından aynı değildir. Telegram, klavye düğmesiyle açılan Mini App'in sendData kullanarak bota servis mesajı gönderebildiğini; bu yöntemin her açılış biçiminde mevcut olmadığını belirtiyor. Bu nedenle “bütün Mini App formları sendData ile gönderilir” varsayımı yanlış bir mimari karara yol açabilir. Arayüzü hangi düğmeden başlatacağınızı veri akışıyla beraber seçin.

Menü düğmesi sık kullanılan işlem için hızlı erişim sağlayabilir, fakat mevcut bot komut menüsünü tamamen gizlemek gerekip gerekmediği ayrı bir kullanıcı deneyimi kararıdır. Kullanıcı hâlâ insan desteği, yardım veya durum sorgusu istiyorsa bu yollar görünür kalmalıdır. Telegram bot komut menüsü rehberimiz sohbet tarafındaki başlangıç davranışını ele alır; Mini App formu bu akışın üzerine eklenir.

Kimlik ve talep verisi nasıl doğrulanmalı?

Kullanıcının tarayıcı tarafında gördüğü kimlik alanını güvenilir veritabanı kaydı saymayın. Telegram'ın kılavuzu, Mini App'ten gelen initData verisinin botun sunucusunda bütünlük kontrolünden geçirilmesini anlatır. Form alanları da ayrıca doğrulanmalıdır: boş zorunlu alan, beklenmeyen dosya türü, aşırı uzun açıklama veya geçersiz bağlantı ayrı hata mesajları üretmelidir. İstemcide yapılan kontrol kullanıcıya yardımcı olur; sunucu tarafındaki kontrolün yerini almaz.

Bot token'ı arayüze veya tarayıcı koduna konmamalıdır. Üçüncü taraf CRM'e aktarım yapılacaksa hangi verinin hangi yetkiyle gönderildiği belirlenmeli, hata halinde talep kaybolmamalıdır. Kullanıcının Telegram kimliği ile işletmenin müşteri kaydını eşleştirmek gerekiyorsa yanlış kişiye ait hesabın bağlanmasını önleyecek açık bir doğrulama adımı tasarlayın. Sadece görüntülenen kullanıcı adına güvenmek uygun değildir.

Tekrar gönderim ve yarım kalan form ne olacak?

Mobil bağlantı kesildiğinde kullanıcı gönder düğmesine tekrar basabilir. Sunucu aynı talebi iki ayrı satış fırsatı olarak açmamalı; form oturumu veya talep anahtarıyla mükerrer kayıtlar ayırt edilmelidir. Kullanıcı formu kapatıp döndüğünde eski taslak gösterilecekse ne kadar süre saklanacağı ve hangi cihazda erişileceği açıklanmalıdır. Güvenlik ve gizlilik gereksinimi yüksek bilgiler için taslağı kalıcı tutmamak daha doğru olabilir.

Başarı mesajı yalnızca “Gönderildi” dememeli. Talebin alındığını, sonraki adımın ne olduğunu ve kullanıcı gerekirse nasıl düzeltme yapacağını açıkça göstermelidir. CRM bağlantısı geçici olarak çalışmıyorsa talep önce güvenilir biçimde kaydedilmeli; ekip incelemesi için hata durumu oluşturulmalıdır. Başarısız aktarımı kullanıcıya başarılı işlem gibi göstermek satış ve güven sorunudur.

2026 API değişiklikleri neden izlenmeli?

Telegram'ın 2026 Bot API değişiklik günlüğü, Mini Apps ile ilgili yeni yeteneklerin ve köken güvenliği değişikliklerinin yıl içinde geldiğini gösteriyor. Bu, bugün kurulan her akışın otomatik olarak yeni yetenekleri kullanması gerektiği anlamına gelmez. Özellikle üçüncü taraf sayfalara yönlendirme veya çok alan adlı arayüz kullanımı varsa güncel istemci davranışıyla sınama yapılmalıdır. Dokümandaki yöntemi projeye sabitlemeden önce kullanılan bot kütüphanesinin ve Telegram istemcisinin destek durumunu kontrol edin.

Sürüm notlarını düzenli gözden geçirmek, eski örnek kodu körü körüne kopyalamayı önler. Yeni bir düğme veya veri aktarım yöntemi geldiğinde mevcut formun neden o yöntemi kullandığını açıklayabilen kısa bir teknik karar kaydı tutun. Bu kayıt, botu sonraki geliştiricinin devralmasını kolaylaştırır ve gereksiz yeniden yazımı azaltır.

Canlıya çıkmadan önce kabul listesi

Bot düğmesini farklı Telegram istemcilerinde açın, formu yarım bırakıp tekrar deneyin, geçersiz veri ve ağ kesintisini test edin. Sunucuya gelen kimlik verisinin doğrulandığını, aynı talebin iki kez yazılmadığını ve CRM devri hata verdiğinde ekibin haberdar olduğunu kontrol edin. Formun mobil klavye ve ekran okuyucuyla kullanılabilir olması da kabul ölçütüdür. Kullanıcının hangi bilgileri neden verdiğini ve talebin nasıl yanıtlanacağını netleştirin.

Webinle'nin bot yazılımları ve entegrasyonlar hizmeti, sohbetten yapılandırılmış talep akışına geçmek isteyen işletmeler için ilgili kapsamdır. Mevcut botunuzun giriş düğmesini, toplamak istediğiniz alanları ve talebin hangi sisteme düşeceğini paylaşın. Böylece Mini App'in gerçekten gerekli olup olmadığı ve nasıl güvenli bağlanacağı birlikte değerlendirilebilir.