Geliştirici paneli inkiveta.com

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_period bitene dek (gönderimden en çok 24 saat) editMessageLiveLocation ile güncellenip stopMessageLiveLocation ile 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:

descriptionAnlamıNe yapmalı
Forbidden: bot was blocked by the userKullanıcı engellediGöndermeyi bırak. Engeli kaldırırsa my_chat_member gelir
Forbidden: bot can't initiate conversation with a userSohbet başlatılmamış ya da kullanıcının tercihi şu an izin vermiyorKullanıcıyı silme. Bir sonraki etkileşiminde yeniden yazabilirsin
Forbidden: bot is suspendedUygulaman askıdaAtö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; 429 alırsan retry_after kadar bekle (Limitler).