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üm | Ne yaparsın |
|---|---|
| Durum ve metrikler | Uygulaman yayında mı, askıda mı; aktif kullanıcı, ortalama yanıt süresi, 7 günlük mesaj, engelleme ve şikâyet oranı |
| Profil | Ad, açıklama, fotoğraf, Keşfet kapağı, kategori, konum, barındırma ülkesi, aydınlatma bağlantısı |
| Ana sayfa | Uygulama açılınca görünen karşılama sayfası (koddan da kurulabilir: Ana sayfa) |
| Anahtar | Token'ı gör / yenile (canlı ve test ayrı) |
| Webhook | Webhook adresi ve teslim günlüğü |
| Test | Test kullanıcıları, test cüzdanı, olay simülatörü (Test ortamı) |
| Akış | Kodsuz sohbet botu editörü (Akış editörü) |
| Mini App | Mini App adresini kaydet ve doğrula (Mini App) |
| Oyunlar | HTML5 oyunlarını kaydet (Oyunlar) |
| Ekip | Ekip arkadaşı davet et, rol ver |
| Keşfet ve doğrulama | Keşfet'e girme koşullarındaki ilerlemen, doğrulanmış rozet başvurusu |
| Kazançlar | Ink satışların ve cüzdana aktarım (Ödemeler) |
| Yurt dışı | Sunucun Türkiye dışındaysa aktarım sözleşmesi |
| Veri talepleri | Kullanı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 · Sil | Uygulamanı 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_].botile bitmesi gerekmez (ama…botsonekini 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öntem | Ne yapar |
|---|---|
setMyName / getMyName | Görünen ad (dil başına) |
setMyDescription / getMyDescription | Profil sayfasındaki uzun açıklama |
setMyShortDescription / getMyShortDescription | Kısa tanıtım (arama ve Keşfet'te) |
setMyProfilePhoto / removeMyProfilePhoto | Profil fotoğrafı |
setMyCommands / getMyCommands / deleteMyCommands | / menüsündeki komutlar (en çok 100, ad ^[a-z0-9_]{1,32}$) |
setChatMenuButton / getChatMenuButton | Yazma 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.
| Yetki | Sahip | Geliştirici | Destek | Analiz |
|---|---|---|---|---|
| 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
curlkomutu olarak kopyalar (token yerine$BOT_TOKENyazar), 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öntem | Ne yapar |
|---|---|
getManagedBotToken | Alt botun token'ını alır (user_id = alt botun kimliği) |
replaceManagedBotToken | Alt botun token'ını yeniler |
getManagedBotAccessSettings / setManagedBotAccessSettings | Alt 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.