Kullanıcıya yazma kuralları
Telegram'daki gibi, kullanıcı uygulamayı başlattıktan sonra uygulama ilk mesajı atabilir ve kullanıcı yazmadan da yazabilir — varsayılan budur. Farkı şu: inkiveta'da kullanıcı kendi ayarlarından (bütün uygulamalar için) ya da uygulamanın ayarlarından (yalnız o uygulama için) iki tercihi kapatabilir.
İki tercih#
"Sen yazmadan yazabilir" kapalıysa uygulama, kullanıcının son etkileşiminden (mesaj, düğmeye basma, bileşen eylemi, anket yanıtı, ödeme ön onayı) sonraki 24 saat içinde:
- yeni mesaj ya da bileşen gönderebilir,
- bir mesajın içeriğini düzenleyebilir (
editMessageText,editMessageCaption,editMessageMedia,setGameScore, widget verisi, bileşen güncelleme).
24 saat dolunca kullanıcı tekrar bir şey yapana dek yazamaz.
"İlk mesajı atabilir" kapalıysa uygulama /start'ı alır ama kullanıcı Başlat'tan sonra ilk kez bir şey yapana dek (/start sayılmaz) hiçbir şey gönderemez.
Muaf olanlar#
- İçerik taşımayan düzenlemeler: düğmeleri kaldıran ya da aynı bırakan
editMessageReplyMarkup,stopPoll. Düğme etiketi metin sayılır: yeni ya da değişen bir satır içi klavye kurallara tabidir. - Canlı konum: izinle gönderilmiş bir canlı konum,
live_periodbitene dek (gönderimden en çok 24 saat)editMessageLiveLocationile güncellenipstopMessageLiveLocationile durdurulabilir. - Uygulamanın kendi olayları (ör. süresi dolan anketin kapanması).
403 hatasını doğru oku#
Pencere dışında gönderim, başlatılmamış sohbete gönderimle aynı Telegram metnini alır:
403 Forbidden: bot can't initiate conversation with a user
Dikkat: Birçok bot örneği ve kütüphane her
403'ü "kullanıcı botu engelledi" sayıp kullanıcıyı listeden siler. inkiveta'da bu yanlıştır.description'a bak:
description | Anlamı | Ne yapmalı |
|---|---|---|
Forbidden: bot was blocked by the user | Kullanıcı engelledi | Göndermeyi bırak. Engeli kaldırırsa my_chat_member gelir |
Forbidden: bot can't initiate conversation with a user | Sohbet başlatılmamış ya da kullanıcının tercihi şu an izin vermiyor | Kullanıcıyı silme. Bir sonraki etkileşiminde yeniden yazabilirsin |
Forbidden: bot is suspended | Uygulaman askıda | Atölye → Destek |
pythonfrom telegram.error import Forbidden
try:
await bot.send_message(chat_id, "Siparişin yola çıktı!")
except Forbidden as e:
if "blocked by the user" in e.message:
kullaniciyi_pasif_yap(chat_id)
# "can't initiate conversation": kullanıcıyı tut, sonraki etkileşimini bekle
Bildirim sıklığı#
Kullanıcı her uygulama için bildirim sıklığını seçer: her an, yalnız önemliler ya da günde bir özet. Mesajın her durumda sohbete anında düşer; değişen yalnız telefonun bildirim gösterip göstermediğidir. Önemli bir bildirim (randevu hatırlatması, sipariş durumu) için bileşenlerde inki_importance: "high" kullan — ama her mesajı "önemli" işaretleme; kullanıcılar seni engeller ve bu Keşfet sıranı düşürür.
Dokununca sohbet yerine doğrudan Mini App'inin açılmasını istediğin bildirimler için Mini App bildirimlerini kullan: sohbete yazılmaz, kullanıcının bildirim merkezine düşer; kategoriyle gider, kullanıcı kategori kategori kapatabilir ve aynı yazma kurallarına uyar. Sıklık ayarı bu bildirimlerin de telefona gidişini belirler ("günde bir özet"te yalnız bildirim merkezinde kalır).
Kullanıcı sıklığı değiştirince my_chat_member (member → member) + inki_frequency: {"old":"all","new":"important"} gelir.
İyi davranış#
- Kullanıcı istemediği sürece reklam ya da toplu duyuru gönderme. Şikâyet oranı %1'i aşarsa Keşfet'ten çıkarsın; ağır ihlallerde uygulama askıya alınır.
- Kampanya, tanıtım ya da ürün duyurusu göndereceksen kullanıcıdan bunun için ayrı ve isteğe bağlı izin al: kutular boş başlasın, izin kanal kanal verilsin (ör. uygulama mesajı ayrı, e-posta ayrı), izin vermemek hiçbir özelliği kilitlemesin ve izni geri almanın yolu uygulamanın içinde görünsün. Kimin, ne zaman, hangi metin sürümüyle izin verdiğini ve geri aldığını kaydet; "istemiyorum" yanıtını da sakla ki aynı soruyu tekrar tekrar sorma. Bu izin, kullanıcının inkiveta'daki "Sen yazmadan yazabilir" ayarının yerine geçmez: o kapalıysa yine yazamazsın.
- Kullanıcıdan parola, kart bilgisi, doğrulama kodu isteme. Uygulama bunu algılayıp kullanıcıya uyarı gösterir.
- Hız limitlerine uy;
429alırsanretry_afterkadar bekle (Limitler).