App Store Connect Entegrasyonu - iOS İnceleme Uyarıları

App Store Connect webhook'ları, iOS sürüm sürecinizdeki her anlamlı değişikliği yayınlar. Bu sinyaller Echobell'e aktığında ekibiniz inceleme kararlarını, sürümleri ve TestFlight geri bildirimlerini gerçekleştikleri anda görür — sayfa yenilemeye ya da gelen kutusu karıştırmaya gerek kalmaz.

Ekipler bu entegrasyonu neden kuruyor:

• İncelemeler "Rejected" veya "Ready for Sale" durumuna geçtiğinde daha hızlı tepki
• TestFlight geri bildirimi ve derleme işlemleri için tek bir bildirim akışı
• Ürün yöneticilerini, QA'yı ve pazarlamayı aynı hizada tutan net, mobil dostu uyarılar

Ön Koşullar

• Webhook tetikleyicileri etkinleştirilmiş bir Echobell kanalı
• App Store Connect erişimi (Account Holder, Admin veya App Manager)
• İzlenecek en az bir etkin iOS uygulaması
• Echobell webhook URL'niz (Kanal → Tetikleyiciler)

Neleri İzleyebilirsiniz

App Store Connect, Echobell'e şunlar için istek gönderebilir:

1. App Store sürüm yaşam döngüsü — gönderim ilerlemesi, onaylar, retler, yayınlar
2. TestFlight aşamaları — derleme işleme sonuçları, test kullanıcısı geri bildirimleri, davet durumu değişiklikleri

Kurulum Özeti

1. Bir Echobell kanalı ve bildirim şablonları hazırlayın
2. Kanalın webhook URL'sini kopyalayın
3. App Store Connect'te bir webhook yapılandırın
4. Biçimlendirmeyi doğrulamak için test isteği gönderin

Adım Adım Kılavuz

[{{app.name}}] {{eventType}} - {{status}}

📱 App: {{app.name}}
🔄 Event: {{eventType}}
📊 Status: {{status}}
⏰ Time: {{eventDate}}
💬 Message: {{message}}
🔗 View in App Store Connect

Gelişmiş Yapılandırma

Webhook Güvenliği

1. HTTPS: Echobell URL'leri TLS ile gelir; ek kurulum gerekmez.
2. Secret yönetimi: App Store Connect bir secret zorunlu kılar, ancak Echobell bunu meta veri olarak ele alır. İleride imzaları doğrulamak isterseniz diye saklayın.
3. IP izin listesi: Yalnızca Apple'ın giden IP aralıklarına izin vererek güvenlik duvarlarınızı sıkılaştırın.

Özel Bildirim Şablonları

İnceleme durumu değişiklikleri ile geri bildirimler için farklı düzenler kullanın; böylece sinyal net olur.

Uygulama Durumu Değişiklikleri İçin

• Başlık:

[{{app.name}}] App {{eventType}}

• Gövde:

🍎 Your app "{{app.name}}" status has changed!

📊 Status: {{status}}
📅 Date: {{eventDate}}

• Bağlantı:

{{app.url}}

TestFlight Geri Bildirimi İçin

• Başlık:

[{{app.name}}] New TestFlight Feedback

• Gövde:

📱 App: {{app.name}}
👤 Tester: {{tester.name}}
⭐ Rating: {{rating}}/5
💬 Feedback: {{feedback}}
📱 Device: {{device}}

• Bağlantı:

{{feedbackUrl}}

Birden Fazla Uygulamayı Yönetme

• Her uygulama veya ortam için ayrı kanallar oluşturun ("MyApp - Beta", "MyApp - Prod")
• Adlandırmayı standartlaştırın ki ekip arkadaşlarınız nereye bakacaklarını hemen bilsin
• Trafik arttığında kanal bazında otomasyon kuralları veya sessiz saatler ekleyin
• Kişileri yalnızca rollerine uyan kanallara ekleyin

Webhook Yük Yapısı

App Store Connect, webhook yüklerini JSON biçiminde gönderir. Tipik yapı şöyledir:

{
  "eventType": "APP_STORE_VERSION_STATE_CHANGED",
  "apiVersion": "v1",
  "eventId": "12345678-1234-1234-1234-123456789012",
  "eventDate": "2025-01-15T10:30:00Z",
  "data": {
    "app": {
      "id": "1234567890",
      "name": "My App"
    },
    "appStoreVersion": {
      "id": "12345678",
      "versionString": "1.2.3",
      "state": "READY_FOR_SALE"
    }
  }
}

En İyi Uygulamalar

1. Kanal düzeni: Farklı uygulamalar veya ortamlar için ayrı kanallar oluşturun
2. Ekip yönetimi: Her kanala yalnızca ilgili ekip üyelerini ekleyin
3. Şablon özelleştirme: Şablonları, iş akışınız için en anlamlı bilgileri gösterecek şekilde ayarlayın
4. Bildirim türleri: Kritik uygulama retleri için Zaman Duyarlı'yı, rutin güncellemeler için Normal'i kullanın

Sorun Giderme

Bildirim almıyorsanız:

1. Webhook URL'sinin doğru kopyalandığını doğrulayın
2. Kanalın etkin olduğunu ve abonelerinin bulunduğunu kontrol edin
3. App Store Connect webhook yapılandırmasını doğrulayın
4. Bağlantıyı doğrulamak için App Store Connect'teki Test düğmesini kullanın
5. App Store Connect'te webhook teslim geçmişini kontrol edin

Gizlilik ve Veri İşleme

Echobell'in gizlilik öncelikli yaklaşımı:

• Bildirim içeriği cihazınızda yerel olarak saklanır
• Sunucularda yalnızca temel yapılandırma verileri saklanır
• Webhook URL'leri gizli bilgi gibi ele alınmalıdır
• Echobell sunucularında hiçbir uyarı verisi tutulmaz

Ek Kaynaklar

• Apple Webhooks Dokümantasyonu
• Echobell Webhook Entegrasyonu
• Bildirim Şablonları Kılavuzu
• Destek Merkezi