Geliştirici paneli inkiveta.com

Atölye: uygulamanı yönet

Atölye, uygulamanın yönetim panelidir. Uygulamada Keşfet → Kendi uygulamanı yap (ya da "Atölye · N uygulaman" kısayolu) yolundan, web sürümünde yan raydaki Keşfet'dan açılır. Kod yazmadan yapılan her ayar buradadır.

Atölye'de neler var?#

BölümNe yaparsın
Durum ve metriklerUygulaman yayında mı, askıda mı; aktif kullanıcı, ortalama yanıt süresi, 7 günlük mesaj, engelleme ve şikâyet oranı
ProfilAd, açıklama, fotoğraf, Keşfet kapağı, kategori, konum, barındırma ülkesi, aydınlatma bağlantısı
Ana sayfaUygulama açılınca görünen karşılama sayfası (koddan da kurulabilir: Ana sayfa)
AnahtarToken'ı gör / yenile (canlı ve test ayrı)
WebhookWebhook adresi ve teslim günlüğü
TestTest kullanıcıları, test cüzdanı, olay simülatörü (Test ortamı)
AkışKodsuz sohbet botu editörü (Akış editörü)
Mini AppMini App adresini kaydet ve doğrula (Mini App)
OyunlarHTML5 oyunlarını kaydet (Oyunlar)
EkipEkip arkadaşı davet et, rol ver
Keşfet ve doğrulamaKeşfet'e girme koşullarındaki ilerlemen, doğrulanmış rozet başvurusu
KazançlarInk satışların ve cüzdana aktarım (Ödemeler)
Yurt dışıSunucun Türkiye dışındaysa aktarım sözleşmesi
Veri talepleriKullanıcıların veri silme istekleri
Destek · Durum · Değişiklik günlüğüBize yaz, platform durumunu ve API değişikliklerini gör
Telegram'dan taşıKütüphanene göre hazır yapılandırma satırı
Devret · SilUygulamanı başka birine devret ya da sil

Keşfet kapağı: Keşfet'in en üstünde haftanın uygulaması tam ekran bir görselle tanıtılır. Uygulaman seçilirse bu görsel kullanılır; kapak yüklemediysen marka rengin ve fotoğrafınla sade bir tanıtım çizilir. Yatay (yaklaşık 4:3), metin içermeyen bir görsel yükle: başlık, açıklama ve Aç düğmesi görselin üstüne ayrıca yazılır, alt kısmı da sayfa rengine doğru solar.

Uygulama oluşturma kuralları#

  • Hesap: telefon numarası doğrulanmış, misafir olmayan, askıda olmayan, yaş doğrulamasını geçmiş bir hesap.
  • Kota: normal hesap 1, Ink+ üyesi 5 uygulama. Sayılan, sahibi olduğun uygulamalardır. Ink+ biterse mevcut uygulamaların kalır, yenisini açamazsın.
  • Kullanıcı adı: 5–32 karakter, [A-Za-z0-9_]. bot ile bitmesi gerekmez (ama …bot sonekini yalnız uygulamalar alabilir). Sonradan değiştirilemez. Silinen uygulamanın adı 90 gün kimseye verilmez.
  • Marka koruması: ad; oluşturma, setMyName, Atölye ve devir dahil her yerde denetlenir. Tanınmış bir markaya benzeyen ad reddedilir ve sana öneriler sunulur.

Token#

  • Biçim: <bot_id>:<35 karakter>. : öncesi uygulamanın gerçek kimliğidir.
  • Yalnız Sahip ve Geliştirici rolü görebilir ya da yenileyebilir; her gösterim ekip günlüğüne yazılır.
  • Yenileme eski token'ı anında geçersiz kılar; açık yoklama/webhook bağlantıları düşer.
  • Token'ı görmüş bir ekip üyesini çıkarırsan ya da rolünü düşürürsen token otomatik yenilenir (onaylı uyarıyla).
  • Kapsamı daraltılmış token yoktur: token = tam API yetkisi.
  • Her uygulamanın ayrıca bir test token'ı vardır (Test ortamı).

Profil ve komutlar#

Profil alanlarını hem Atölye'den hem API'den yönetebilirsin:

YöntemNe yapar
setMyName / getMyNameGörünen ad (dil başına)
setMyDescription / getMyDescriptionProfil sayfasındaki uzun açıklama
setMyShortDescription / getMyShortDescriptionKısa tanıtım (arama ve Keşfet'te)
setMyProfilePhoto / removeMyProfilePhotoProfil fotoğrafı
setMyCommands / getMyCommands / deleteMyCommands/ menüsündeki komutlar (en çok 100, ad ^[a-z0-9_]{1,32}$)
setChatMenuButton / getChatMenuButtonYazma alanının yanındaki menü düğmesi (komut listesi ya da Mini App)
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/setMyCommands" -H 'Content-Type: application/json' -d '{
  "commands":[
    {"command":"randevu","description":"Randevu al"},
    {"command":"fiyatlar","description":"Fiyat listesi"},
    {"command":"iptal","description":"Randevumu iptal et"}
  ]}'

language_code ile her dil için ayrı ad/açıklama/komut kümesi verebilirsin (tr, en…); kullanıcı uygulama dilindeki kümeyi görür.

Ekip ve roller#

Uygulamanı bir ekiple yönetebilirsin. Davet tek kullanımlıktır ve 7 gün geçerlidir.

YetkiSahipGeliştiriciDestekAnaliz
Token görme / yenileme (= tam API)✓✓––
Webhook, akış, test ortamı✓✓––
Profil, ana sayfa, komutlar✓✓––
İnsana devredilen sohbetleri yanıtlama✓✓✓–
İade onayı✓✓✓–
Metrikler✓✓✓✓
Ekip, kazanç, devir, silme✓–––

Webhook günlüğü#

Atölye → Webhook, uygulamana yapılan her teslimi 7 gün saklar: zaman, update türü, update_id, senin sunucunun yanıt kodu, süre, deneme sayısı. Filtreler: Tümü / Hatalı / Yavaş (> 2 sn) / türe göre. Bir kaydı açınca isteği (token maskeli) ve yanıtının ilk 2 KB'ını görürsün.

  • Yeniden gönder: son 24 saatteki bir teslimi **aynı update_id** ile tekrar gönderir. İşleyicin aynı update'i iki kez almaya hazır olmalı.
  • İsteği kopyala: teslimi curl komutu olarak kopyalar (token yerine $BOT_TOKEN yazar), kendi bilgisayarında tekrar oynatırsın.

Yönetilen botlar#

Bir bot, Atölye'den açılan alt botları yönetebilir (ör. her şube için ayrı bot açan bir zincir). Alt bot sahibinin kotasından düşer; yöneten bota managed_bot update'i gelir.

YöntemNe yapar
getManagedBotTokenAlt botun token'ını alır (user_id = alt botun kimliği)
replaceManagedBotTokenAlt botun token'ını yeniler
getManagedBotAccessSettings / setManagedBotAccessSettingsAlt botu yalnız belirli kullanıcılara açar (added_user_ids = yöneten botun gördüğü kullanıcı kimlikleri; ayar yalnız gerçek ortamda)

Başka bir botu yönetmiyorsan 400 Bad Request: managed bot not found alırsın.

Devir ve silme#

  • Devret: yalnız ekibindeki birine, iki tarafın onayıyla. Devirde token yenilenir, ödeme sağlayıcısı bağlantısı kopar ve kullanıcılar yeni sahip için yeniden "Başlat" der (o ana dek kullanıcıdan uygulamaya mesaj akmaz).
  • Sil: webhook kapanır, aktif aboneliklere kalan gün oranında iade yapılır, sohbetler 30 gün salt okunur kalıp silinir, kullanıcı adı 90 gün beklemeye girer.
  • Hesabını silersen ve ekipte Geliştirici varsa uygulama 30 gün sahipsiz çalışmaya devam eder (ödemeler kapalı) ve Geliştiriciye devir daveti gider.