Telegram Botları ve Stars: Ücretli Eylem Rehberi

Bir içerik üreticinin zaten bir Telegram kitlesi varsa, bir bot bu kitleyi ücretli eylemlere dönüştürebilir: bir rapor, bir dosya, bir kredi paketi, özel bir komut, bir mini hizmet veya medyayla ilgili bir kilit açma.

Garip kısım düğme değil. Devir teslim. Alıcının yeterli Stars'a, botun temiz bir faturaya ihtiyacı var ve ücretli eylem yalnızca Telegram ödemeyi onayladıktan sonra açılmalı.

Bu rehber, Telegram Stars ile bot tarafından teslim edilen bir ücretli eylem planlayan içerik üreticileri ve operatörler içindir. Okurlarınız bakiyenin kendisine hâlâ yabancıysa, Telegram Stars nedir ile başlayın. Alıcıların lansmandan önce Stars'a ihtiyacı varsa, bot istemi yayına girmeden önce onları Telegram Stars yükle sayfasına yönlendirin.

Hızlı yanıt

Bir Telegram bot ücretli eylemi, teklifi küçük ve doğrulanabilir tuttuğunuzda en iyi şekilde çalışır.

Bu akışı kullanın:

1. Tek bir ücretli eylem tanımlayın.
2. Alıcıya ne alacağını gösterin.
3. O eylem için bir Stars faturası gönderin.
4. Ödemeyi kabul etmeden önce ön ödeme isteğini kontrol edin.
5. Yalnızca başarılı bir ödeme olayından sonra teslim edin.
6. Destek ve iadeler tahmine kalmasın diye ödeme referansını saklayın.
7. Alıcılara kilit açma anından önce nasıl Stars edineceklerini söyleyin.

Telegram'ın Stars ödeme belgeleri, dijital ürün ve hizmetler için temel fatura sırasını anlatır: sendInvoice, pre_checkout_query, answerPreCheckoutQuery, successful_payment ve ardından teslimat. Bot API bu ödemeler için Stars para birimi etiketi olarak XTR kullanır.

İşte teknik omurga bu. İçerik üreticinin işi daha basit: ücretli eylemi, alıcının neden Stars harcadığını bilecek kadar net hale getirmek.

Bu rehber neyi kapsar

Bu rehberi, şunlar gibi bot tarafından teslim edilen ücretli eylemler için kullanın:

• indirilebilir bir dosyanın kilidini açma;
• özel bir rapor oluşturma;
• bir bot hesabına kredi ekleme;
• ücretli bir komut açma;
• özel bir kontrol listesi, komut paketi, grafik veya şablon teslim etme;
• bir bot tarafından yürütülen tek seferlik bir hizmete erişim verme.

Bunları her Telegram Stars akışıyla karıştırmayın.

Ücretli medya; ücretli fotoğraflar, videolar ve desteklenen medya kilidi açma içindir. Ürününüz bir medya yayını ise, Telegram ücretli medya alıcı rehberini ve Telegram ücretli medyayı Stars ile fiyatlandırma rehberini okuyun.

Star Abonelikleri, aylık ücretli bir davet bağlantısıyla bir kanala erişimi sınırlar. Mini uygulamalar da Stars kullanabilir, ancak alıcı akışı farklıdır. Durum buysa, Telegram mini uygulamalarını Stars ile ödeme rehberini kullanın.

Önce daha geniş haritaya ihtiyacınız varsa, Telegram içeriğini Stars ile paraya dönüştürme ile başlayın.

Adım 1: ücretli eylemi tanımlayın

Faturayla başlamayın. Alıcının aldığı şeyle başlayın.

Zayıf ücretli eylem vaatleri şöyle olur:

• "Premium erişim."
• "Daha fazlasının kilidini aç."
• "Botu destekle."
• "Ekstra içerik al."

Bu cümleler destek soruları yaratır çünkü alıcı ödemeden sonra neyin değiştiğini anlayamaz.

Daha güçlü bir ücretli eylem vaadi özgüldür:

• "Tek bir özel denetim raporu oluştur."
• "Tam PDF şablon paketinin kilidini aç."
• "Bot bakiyene 50 kredi ekle."
• "Gelişmiş grafik komutunu bir kez çalıştır."
• "Bu ders için özel kontrol listesini aç."

Herhangi bir şeyi fiyatlandırmadan önce tek bir cümle yazın:

Ödemeden sonra alıcı ________ alır.

Cümle belirsizse, bot akışı da belirsiz hissettirir.

Adım 2: Stars faturasını gönderin

Standart bir bot faturası için Telegram'ın Bot API yöntemi sendInvoice'dır. Stars ödemeleri için fatura, XTR para birimi etiketini kullanır.

Pratik bir fatura kontrol listesi:

• currency değerini XTR yapın;
• Telegram belgelerinin izin verdiği yerde Stars ödemeleri için sağlayıcı jetonunu boş tutun;
• bir Stars ödemesi için tek bir fiyat kalemi kullanın;
• dahili sipariş referansınızı payload içine koyun;
• başlığı ve açıklamayı, alıcının eylemi tanıyabileceği kadar kısa tutun;
• aynı payload'u ilgisiz eylemler için yeniden kullanmayın.

Payload önemlidir çünkü ödeme ekranı tüm sipariş sisteminiz değildir. Botunuzun yine de bu faturanın hangi kullanıcıya, eyleme ve fiyata ait olduğunu bilmesi gerekir.

İyi dahili payload verileri genellikle şunları içerir:

• alıcı kullanıcı kimliği;
• ücretli eylem kimliği;
• beklenen Stars tutarı;
• sipariş zaman damgası;
• nonce veya benzersiz sipariş kimliği;
• created, pending, paid, delivered veya refunded gibi bir durum.

Herkese açık fatura metnini insani tutun. Alıcı, dahili kimlikleri veya geliştirici dilini görmemeli.

Kötü fatura başlığı:

SKU_XTR_CMD_ADV_2026

Daha iyi fatura başlığı:

Gelişmiş grafik raporu

Kötü fatura açıklaması:

Geri çağırma doğrulamasından sonra ücretli eylemi yürüt.

Daha iyi fatura açıklaması:

Bu bottan tek bir özel grafik raporunun kilidini aç.

Adım 3: ön ödemeyi bir korkuluk gibi ele alın

Telegram, ödeme tamamlanmadan önce bir ön ödeme sorgusu gönderir. Bunu bir formalite değil, son bir güvenlik kontrolü olarak ele alın.

Onaylamadan önce şunları doğrulayın:

• kullanıcı hâlâ siparişle eşleşiyor;
• ücretli eylem hâlâ var;
• beklenen Stars tutarı hâlâ uyuşuyor;
• eylem hâlâ kullanılabilir;
• sipariş daha önce ödenmemiş veya iptal edilmemiş;
• payload süresi dolmamış.

Bir şey uyuşmuyorsa, ön ödeme sorgusunu net bir hata mesajıyla reddedin. Eski bir faturanın yanlış eylemin kilidini açmasına izin vermeyin.

Bu, sınırlı ürünler, süreli erişim veya üretilmiş çıktılar satan botlar için özellikle önemlidir. Bir kullanıcı, teklif değiştikten sonra eski bir fatura bağlantısına dokunabilir. Botunuz ne yapacağını bilmeli.

Adım 4: yalnızca başarıdan sonra teslim edin

Düğmeye dokunmak ödeme değildir. Ön ödeme onayı teslimat değildir. Telegram başarılı ödeme olayını gönderdikten sonra teslim edin.

Temiz bir teslimat akışı şöyledir:

1. successful_payment alın.
2. Onu dahili siparişle eşleştirin.
3. Telegram ödeme tahsilat kimliğini saklayın.
4. Siparişi ödendi olarak işaretleyin.
5. Ücretli eylemi teslim edin.
6. Siparişi teslim edildi olarak işaretleyin.
7. Alıcıya kısa bir onay mesajı gönderin.

Ücretli eylem anlıksa, örneğin bir dosya veya kredi paketi, teslimat onaydan hemen sonra olabilir. İşleme gerektiriyorsa, alıcıya ne olduğunu ve sonra ne bekleyeceğini söyleyin.

Desteği pratik tutun. Sipariş kimliğini, ücretli eylemi, Stars tutarını, ödeme tahsilat kimliğini ve teslimat durumunu saklarsanız, sohbet geçmişini eşelemeden destek sorularının çoğunu yanıtlayabilirsiniz.

Adım 5: alıcının yükleme zamanını belirgin yapın

Alıcı tarafı unutmaya yatkındır. İçerik üreticiler botu genelde zaten Stars'ları varken test eder. Gerçek alıcılar boş bakiyeyle gelebilir.

Telegram'ın Stars ödeme belgeleri, kullanıcıların dijital ürün ve hizmetler için ödeme yapmadan önce gerekirse Stars edinebileceğini söyler. Bu, ekstra adımın her alıcı için sürtünmesiz olduğu anlamına gelmez. Ücretli eyleminiz belirli bir saatte yayına giriyorsa, kitleyi erkenden uyarın.

Basit bir lansman mesajı şöyle diyebilir:

Bot, ücretli raporun kilidini Telegram Stars ile açacak. Henüz yeterli Stars'ın yoksa, ödeme sırasında uğraşmamak için lansmandan önce yükle.

MyStars'ın doğal olarak oturduğu yer burası. İçerik üreticinin, ücretli eylemin kendisi için alıcıyı Telegram'dan çıkarması gerekmez. Yalnızca alıcıların kilit açma anından önce Stars'ı hazır bulundurmasına ihtiyaç vardır. Alıcıları, hayal kırıklığına uğramalarından sonra değil, yayından önce Telegram Stars yükle sayfasına yönlendirin.

Ayrıca ücretli medya yayınları yapıyorsanız, fragmanları, alıcı hatırlatmalarını ve lansman sonrası ölçümü planlamak için ücretli medya lansman planını kullanın.

Karar dalları

Ücretli değer bir dosya veya şablonsa

Ödemeyi tek seferlik tutun. Dosyayı başarılı ödemeden sonra teslim edin, ardından kısa, makbuz tarzı bir mesaj gönderin.

Alıcıyı dosyayı bir yöneticiden elle istemek zorunda bırakmayın. Bu, bir bot akışını destek kuyruğuna dönüştürür.

Ücretli değer üretilmiş bir raporsa

Alıcıya raporun anlık mı yoksa kuyruğa mı alındığını söyleyin.

Üretim başarısız olabiliyorsa, ödeme onayını teslimat durumundan ayırın:

• ödendi, oluşturuluyor;
• ödendi, teslim edildi;
• ödendi, başarısız - destek gerekiyor.

Bu, iadeleri ve desteği kolaylaştırır.

Ücretli değer kredilerse

Kredileri yalnızca başarılı ödemeden sonra ekleyin. Yeni bakiyeyi hemen gösterin.

Krediler sona eriyorsa, ödemeden önce söyleyin. Gizli sona erme kuralları şikâyet yaratır.

Ücretli değer medyaysa

Doğru akışı kullanın. Bir bot faturası dijital bir ürün veya hizmet satabilir, ancak ücretli medyanın kendi Bot API yöntemi ve ürün davranışı vardır. Bir fotoğraf/video/medya kilidi açma satıyorsanız, inşa etmeden önce akışı Telegram ücretli medya alıcı rehberiyle karşılaştırın.

Ücretli değer kanal erişimiyse

Bu, tek seferlik bir bot eylemi değil, bir Star Aboneliği veya başka bir erişim akışı olabilir. Aylık erişimi, tek seferlik ücretli eylemleri ve ücretli medyayı metninizde ayrı tutun.

Kaçınılacak hatalar

• Neyin kilidinin açıldığını söylemeden belirsiz bir premium vaadi satmak.
• Bir düğmeye dokunmayı ödeme saymak.
• Başarılı ödeme yerine ön ödemeden sonra teslim etmek.
• Telegram ödeme tahsilat kimliğini saklamayı unutmak.
• Bir payload biçimini ilgisiz eylemler için yeniden kullanmak.
• Eski fatura bağlantılarının değişmiş tekliflerin kilidini açmasına izin vermek.
• Sona ermeyi veya kullanım sınırlarını ödemeden sonrasına gizlemek.
• Alıcıya görünen fatura metninde geliştirici etiketleri kullanmak.
• Alıcıları yalnızca lansman başladıktan sonra yüklemeye yönlendirmek.
• Her Stars akışına ücretli gönderiler demek; bu, ücretli medyayı, abonelikleri, bot faturalarını ve yalnızca metinden oluşan kanal içeriğini karıştırabilir.

Sorun giderme

Alıcı ödediğini söylüyor ama bot kilidi açmadı

Olası nedenler:

• bot successful_payment almadı veya işlemedi;
• dahili sipariş kimliği payload ile eşleşmedi;
• ödemeden sonra teslimat başarısız oldu;
• bot siparişi ödendi olarak işaretledi ama teslim edildi olarak değil.

Çözüm:

• kullanıcı kimliği ve sipariş kimliğine göre arayın;
• saklanan ödeme tahsilat kimliğini kontrol edin;
• ücretli eylem durumunu doğrulayın;
• ödeme başarılıysa ve ürün geçerliyse elle teslim edin;
• aynı hata tekrarlamasın diye başarısızlığı kaydedin.

Alıcı Stars'ı olmadığı için ödeyemiyor

Olası neden:

• alıcı, yeterli Stars hazır olmadan ödeme anına ulaştı.

Çözüm:

• lansman öncesi bir hatırlatma ekleyin;
• lansman talimatlarına bir Telegram Stars yükle bağlantısı ekleyin;
• botun ödeme mesajını kısa ve net tutun;
• yükleme rehberini uzun bir duyurunun içine gömmeyin.

Ön ödeme başarısız oluyor

Olası nedenler:

• siparişin süresi doldu;
• payload bozuk;
• beklenen tutar değişti;
• ücretli eylem artık kullanılabilir değil;
• bot siparişi zaten işledi.

Çözüm:

• net bir hata mesajı döndürün;
• kullanıcının yeni bir fatura oluşturmasına izin verin;
• açıklama olmadan sessizce başarısız olmaktan kaçının.

Bir iade veya destek talebi geliyor

Olası nedenler:

• alıcı yanlış eylem için ödeme yaptı;
• teslimat başarısız oldu;
• teklif metni belirsizdi;
• alıcı bir abonelik veya medya kilidi açma bekledi ama bir bot eylemi satın aldı.

Çözüm:

• ödeme tahsilat kimliğini ve teslimat günlüğünü kontrol edin;
• iadenin, politikanıza ve Telegram'ın mevcut yöntemlerine göre uygun olup olmadığına karar verin;
• birden çok alıcı aynı noktayı yanlış anlıyorsa teklifi yeniden yazın.

Sıkça sorulan sorular

Bir Telegram botu ücretli bir eylem için Stars kabul edebilir mi?

Evet, Telegram'ın Stars ödeme belgeleri botlar ve mini uygulamalar üzerinden satılan dijital ürün ve hizmetleri kapsar. Bir bot faturasında önemli parçalar Stars para birimi etiketi XTR, ön ödeme işleme, başarılı ödeme onayı ve ödemeden sonra teslimattır.

XTR ne anlama gelir?

XTR, Telegram'ın Bot API ödeme akışında Stars için kullandığı para birimi etiketidir. Stars'ı normal bir itibari para kodu gibi ele almak yerine, Stars faturaları için bunu kullanın.

Stars faturaları bir ödeme sağlayıcı jetonuna ihtiyaç duyar mı?

Telegram'ın Bot API belgeleri, bu parametrenin göründüğü Telegram Stars ödemelerinde boş bir sağlayıcı jetonu geçirmeyi söyler. API ayrıntıları değişebileceği için, uygulamadan önce güncel Bot API belgelerini kontrol edin.

Bot eylemi ne zaman teslim etmeli?

Başarılı ödeme olayından sonra; kullanıcı öde düğmesine dokunduktan sonra değil ve yalnızca ön ödeme onayından sonra da değil.

Alıcının yeterli Stars'ı yoksa ne olur?

Alıcıları lansmandan önce uyarın. Önce bakiyelerini hazırlayabilir, sonra bot faturası belirdiğinde Telegram içinde kilidi açabilirler. Daha fazla Stars gerekiyorsa onları Telegram Stars yükle sayfasına yönlendirin.

Bir bot ücretli eylemi, ücretli medya ile aynı şey mi?

Hayır. Ücretli medya; ücretli fotoğraflar, videolar ve desteklenen medya kilidi açma içindir. Bir bot ücretli eylemi bir dosya, rapor, kredi paketi, komut veya bot tarafından teslim edilen bir hizmet olabilir. Akışı ve metni ayrı tutun.

Stars ödemeleri iade edilebilir mi?

Telegram'ın Bot API'si başarılı Stars ödemeleri için refundStarPayment içerir. Desteği ve iade kararlarını düzgün yönetebilmek için ödeme tahsilat kimliğini ve dahili sipariş durumunuzu saklayın.

Kaynaklar ve kanıtlar

• Telegram Stars lansmanı: Telegram Stars: Pay for Digital Goods and More.
• Botlar için Stars ödeme akışı: Telegram Stars Payments.
• Bot fatura parametreleri: Bot API sendInvoice.
• Ücretli medya kapsamı: Bot API sendPaidMedia.
• Star Abonelikleri ve ücretli medya duyurusu: Telegram Super Channels, Star Reactions and Subscriptions.
• Stars koşulları ve bakiye kapsamı: Telegram Stars Terms.

Son kontrol listesi

Bir bot ücretli eylemini yayına almadan önce:

• ücretli eylem özgül;
• fatura başlığı insan tarafından okunabilir;
• payload tek bir dahili siparişe eşleniyor;
• Stars tutarı ödemeden önce kontrol ediliyor;
• teslimat başarılı ödemeden sonra gerçekleşiyor;
• destek, tahsilat kimliğini ve teslimat durumunu bulabiliyor;
• alıcılar, bot istemi gelmeden önce nasıl Stars yükleyeceklerini biliyor.