Nuvaka › Geliştirici belgeleri › Geri bildirim kutusu

Geri bildirim kutusu

Geri bildirim kutusu, uzantını kuran kullanıcıların sana doğrudan hata, fikir ya da soru yazmasını sağlar. Kutuyu uzantı başına sen açarsın. Kullanıcılar talep açar, sen yanıtlarsın. Gerçek kullanıcılarla yapılan bu yazışma, en ucuz ve en dürüst test yöntemidir.

Kutuyu açma#

Kutu varsayılan olarak kapalıdır. Açmanın iki yolu var; ikisi de doğrulanmış e-posta ister (yoksa 403 email_not_verified).

• Uygulamadan: Profil › Geliştirici › Geri bildirim kutusu › Ayarlar'da uzantını seç, kutuyu aç, kabul ettiğin türleri ve karşılama metnini kaydet.
• API ile: oturum ya da nvd_ geliştirici token'ıyla PUT /api/ext/v1/dev/extensions/{id}/feedback.

// PUT /api/ext/v1/dev/extensions/{id}/feedback
{
  "enabled": true,
  "categories": ["bug", "idea", "question"],   // en az biri
  "welcome": { "tr": "Hata bildirirken sürümü ve adımları yaz.", "en": "Please include steps to reproduce." }
}
// → { "success": true, "feedbackEnabled": true }

• welcome gönderirsen nesnenin tamamı değişir: göndermediğin dil silinir. Bir dili silmek için o dili gönderme.
• welcome alanını hiç göndermezsen eski karşılama metni olduğu gibi kalır.
• Mevcut ayarları okumak için GET /api/ext/v1/dev/extensions/{id}/feedback → { enabled, welcome, categories }. Henüz yayında olmayan ya da gizli uzantın için de çalışır; uzantı senin değilse 404.

Kutu kapalıyken başarılı yükleme (dev/upload) ve mağaza sunumu (listing) yanıtlarına bir öneri eklenir; uygulama bunu tek tıkla "Aç" ipucu olarak gösterir:

"recommendations": [{ "code": "feedback_off", "message": "Geri bildirim kutun kapalı: …" }]

Kullanıcı nasıl yazar#

• Kutu açıksa ve kullanıcı uzantını kurmuşsa, uzantının Mağaza sayfasında Geliştiriciye yaz düğmesi görünür. Kurmamış kullanıcı yazamaz.
• Kullanıcı bir tür (senin açtıkların arasından), konu (3–120 karakter) ve mesaj (1–5000 karakter) girer; isterse anonim gönderir.
• Talebe en çok 2 görsel eklenebilir: png, jpeg ya da webp, her biri ≤ 2 MB. Tür dosya içeriğinden belirlenir.
• Uygulama sürümü, uzantı sürümü ve platform talebe otomatik eklenir; kullanıcıdan istemene gerek kalmaz.
• Kullanıcı taleplerini ve yanıtlarını Uygulamalar › Geri bildirimlerim'de görür; yanıt gelince bildirim alır.
• Kendi uzantına geri bildirim gönderemezsin (own_extension).

Sınırlar#

Sınır aşılınca yanıt 429 olur (error: "rate_limited"). Aynı talep ve aynı alıcı için 10 dakikada en çok bir bildirim gider.

Durumlar#

Kullanıcı yanıtlanmış ya da kapalı bir talebe yazarsa talep yeniden open olur. Durumu elle de değiştirebilirsin.

Gelen kutusu#

Talepleri Profil › Geliştirici › Geri bildirim kutusu › Gelen kutusu'nda görürsün: uzantıya ve duruma göre süzebilir, okunmamış sayısını görebilir, yanıt yazabilir ve durumu değiştirebilirsin. Her talepte tür, konu, uygulama/uzantı sürümü ve platform görünür. Yeni talep ve mesajda bildirim alırsın.

Aynı işlemler oturum ya da nvd_ token'ıyla API'den de yapılır:

• GET /api/ext/v1/dev/feedback?extId=&status=&page= → { items, total, unread, page, pageSize: 20 }
• GET /api/ext/v1/dev/feedback/{ticketId} → talep, mesajlar ve ekler
• POST /api/ext/v1/dev/feedback/{ticketId}/messages { body } (1–5000 karakter; talep answered olur)
• PATCH /api/ext/v1/dev/feedback/{ticketId} { status } (open | answered | closed)

Uzantı başka bir geliştiriciye geçerse (sahiplenme) talepler uzantının yeni sahibinde görünür. Kaldırılan uzantının talepleri ve ekleri 30 gün sonra silinir.

Engelleme#

• Yalnız sana talep açmış bir kullanıcıyı engelleyebilirsin: talebin içinden Engelle ya da Engellenenler sekmesinde kullanıcı adıyla.
• Anonim talepte adı görmediğin için engeli talebin içinden (API'de ticketId ile) koyarsın; kimliği yine sana gösterilmez.
• Engel tüm uzantıların için ya da yalnız bir uzantı için geçerli olabilir.
• Engellenen kullanıcı sana yeni talep açamaz ve mevcut taleplere yazamaz: 403 blocked_by_developer.
• Engelleri Engellenenler sekmesinde görür ve kaldırırsın.

// POST /api/ext/v1/dev/feedback/block
{ "username": "ornek" }                              // ya da anonim talep için:
{ "ticketId": 123, "extId": "ben.uzanti" }           // extId: yalnız bu uzantı için
{ "username": "ornek", "block": false }              // engeli kaldır
// GET /api/ext/v1/dev/feedback/blocks, DELETE /api/ext/v1/dev/feedback/blocks/{id}

Gizlilik#

• Kullanıcının e-postasını ve hesap kimliğini hiçbir zaman görmezsin; yalnız kullanıcı adını görürsün.
• Kullanıcı anonim yazarsa kullanıcı adı da gizlenir; talepte "Bir kullanıcı" yazar.
• Ekler yalnız talebi açan kullanıcıya ve sana açıktır.

Kötüye kullanım#

Kutu, uzantın hakkında yazışmak içindir. Kısa bir yol gösterici olarak şunlardan kaçın:

• spam, reklam ya da aynı mesajı tekrar tekrar göndermek;
• taciz, hakaret ya da tehdit;
• kullanıcıdan e-posta, telefon, parola, kimlik gibi kişisel bilgi istemek;
• kullanıcıyı platform dışında (başka uygulama, e-posta, telefon) iletişime zorlamak.

Hata ayıklamak için gereken bilgiyi (adımlar, ekran görüntüsü, ayarlar) kutunun içinde iste; uygulama ve uzantı sürümü ile platform zaten talepte gelir.

Sonuçları:

• Kullanıcı senin bir mesajını şikâyet edebilir (sebep 3–1000 karakter). Şikâyet Nuvaka ekibine bir destek talebi olarak (extension_feedback_abuse) yazışma bağlamıyla birlikte gider.
• Ekip şikâyeti inceler ve gerekirse işlem yapar; bu, ağır ya da tekrar eden durumlarda yayıncı hesabının askıya alınmasına kadar gidebilir.
• Yalnız geliştirici mesajları şikâyet edilebilir; aynı mesaj ikinci kez şikâyet edilemez.

Sana karşı kötüye kullanım yapan bir kullanıcıyı engelleyebilirsin.

Hata kodları#

Nuvaka Apps API v1 · son güncelleme 2026-09-27