---
title: "App Store Connect Entegrasyonu - iOS İnceleme Uyarıları"
sidebarTitle: App Store Connect
description: App Store Connect webhook'larını Echobell'e bağlayın; uygulama inceleme durumu, TestFlight derlemeleri ve sürüm güncellemeleri için push veya telefon aramalı uyarı alın.
---

import { Step, Steps } from "fumadocs-ui/components/steps";

# App Store Connect Entegrasyonu

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

<Callout type="info">
  App Store Connect webhook'ları; Account Holder, Admin veya App Manager rolüne
  sahip geliştiriciler için kullanılabilir. Her webhook yalnızca tek bir
  uygulamaya uygulanabilir ve uygulama başına en fazla on webhook
  oluşturabilirsiniz.
</Callout>

## Ö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

<Steps>
<Step>
### Bir Echobell Kanalı Oluşturun

1. Echobell uygulamasını açın
2. Yeni bir kanal oluşturun (örneğin "App Store Connect")
3. Hızlıca ayırt edebilmek için belirgin bir renk seçin
4. Bu güncellemeleri alması gereken ekip arkadaşlarınızı ekleyin
</Step>
<Step>

### Bildirim Şablonlarını Yapılandırın

Ekiplerin hızlı hareket edebilmesi için her olay yüküne net bir başlık ve özet verin.

**Başlık Şablonu:**

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

**Gövde Şablonu:**

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

Daha sade bir üslup istiyorsanız emojileri çıkarabilirsiniz — şablon değişkenleri aynı kalır.

</Step>
<Step>
### Echobell Webhook URL'nizi Alın

1. Kanal ayarlarınızı açın → **Tetikleyiciler**
2. Sunulan webhook URL'sini kopyalayın
3. Gizli tutun; bunu App Store Connect'e yapıştıracaksınız
</Step>
<Step>

### App Store Connect Webhook'unu Yapılandırın

Daha önce kopyaladığınız Echobell URL'siyle [Apple'ın resmi kılavuzunu](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/) izleyin:

#### Webhook Oluşturma

1. [App Store Connect](https://appstoreconnect.apple.com/) hesabınızda oturum açın
2. **Users and Access** → **Integrations** yolunu izleyin
3. **Additional** altında **Webhooks**'a tıklayın
4. Webhooks'un yanındaki ekleme düğmesine (+) tıklayın
5. Webhook'unuzu yapılandırın:
   - **Name**: Açıklayıcı bir etiket (örneğin "Echobell Notifications")
   - **Payload URL**: Echobell webhook URL'nizi yapıştırın
   - **Secret**: Doğrulama için güvenli bir dize oluşturun
   - **App**: İzlemek istediğiniz uygulamayı seçin
   - **Event Triggers**: Takip etmek istediğiniz olayları seçin

#### Kullanılabilir Olay Tetikleyicileri

Sizin için önemli olanları birleştirin:

**App Store Sürüm Olayları**

- **App Store Version State Changed** — inceleme durumları arasındaki her hareket
- **App Store Version Released** — mağazaya son yayınlama

**TestFlight Olayları**

- **TestFlight Beta Feedback** — yeni yorumlar, puanlar ve cihaz ayrıntıları
- **TestFlight Beta Review State Changed** — derleme onayları ve retleri

7. Webhook'u oluşturmak için **Add**'e tıklayın
</Step>
<Step>

### Entegrasyonunuzu Test Edin

App Store Connect'in yerleşik **Test** düğmesini kullanın:

1. Webhook listesinde yeni eklediğiniz webhook'u açın
2. **Test**'e tıklayın → App Store Connect bir ping gönderir
3. Echobell'in "Ping" olayını şablon biçimlendirmenizle gösterdiğini doğrulayın
</Step>
</Steps>

## 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:

```json
{
  "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](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/)
- [Echobell Webhook Entegrasyonu](/docs/webhook)
- [Bildirim Şablonları Kılavuzu](/docs/template)
- [Destek Merkezi](/docs/support)