---
title: "Integrasi App Store Connect - Peringatan Review iOS"
sidebarTitle: App Store Connect
description: Hubungkan webhook App Store Connect ke Echobell dan dapatkan peringatan push atau panggilan telepon untuk status review aplikasi, build TestFlight, dan kabar rilis.
---

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

# Integrasi App Store Connect

Webhook App Store Connect menyiarkan setiap perubahan penting dalam alur rilis iOS Anda. Ketika sinyal itu mengalir ke Echobell, tim Anda melihat keputusan review, rilis, dan masukan TestFlight tepat saat kejadiannya—tanpa perlu me-refresh manual atau mengaduk-aduk kotak masuk.

**Alasan tim memasang integrasi ini:**

- Waktu reaksi lebih cepat saat status review berubah menjadi "Rejected" atau "Ready for Sale"
- Satu aliran notifikasi untuk masukan TestFlight dan pemrosesan build
- Peringatan yang jelas dan ramah ponsel sehingga PM, QA, dan tim marketing tetap sejalan

<Callout type="info">
  Webhook App Store Connect tersedia bagi pengembang dengan peran Account
  Holder, Admin, atau App Manager. Setiap webhook hanya berlaku untuk satu
  aplikasi, dan Anda bisa membuat sampai sepuluh webhook per aplikasi.
</Callout>

## Prasyarat

- Saluran Echobell dengan pemicu webhook yang aktif
- Akses App Store Connect (Account Holder, Admin, atau App Manager)
- Setidaknya satu aplikasi iOS aktif untuk dipantau
- URL webhook Echobell Anda (Saluran → **Pemicu**/Triggers)

## Apa yang Bisa Anda Pantau

App Store Connect bisa mengirim sinyal ke Echobell untuk:

1. **Siklus hidup versi App Store** — progres pengiriman, persetujuan, penolakan, rilis
2. **Tonggak TestFlight** — hasil pemrosesan build, masukan penguji, perubahan status undangan

## Sekilas Penyiapan

1. Siapkan saluran Echobell beserta templat notifikasinya
2. Salin URL webhook saluran tersebut
3. Konfigurasikan webhook di App Store Connect
4. Kirim pengiriman percobaan untuk memverifikasi formatnya

## Panduan Langkah demi Langkah

<Steps>
<Step>
### Buat Saluran Echobell

1. Buka aplikasi Echobell
2. Buat saluran baru (misalnya, "App Store Connect")
3. Pilih warna yang mencolok agar mudah dikenali sekilas
4. Tambahkan rekan tim yang perlu menerima kabar ini
</Step>
<Step>

### Konfigurasikan Templat Notifikasi

Beri setiap payload peristiwa judul dan ringkasan yang jelas agar tim bisa segera bertindak.

**Templat Judul:**

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

**Templat Isi:**

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

Silakan hapus emoji-nya jika Anda lebih suka nada yang lugas—variabel templatnya tetap sama.

</Step>
<Step>
### Ambil URL Webhook Echobell Anda

1. Buka pengaturan saluran Anda → **Pemicu** (Triggers)
2. Salin URL webhook yang tersedia
3. Rahasiakan URL itu; Anda akan menempelkannya ke App Store Connect
</Step>
<Step>

### Konfigurasikan Webhook App Store Connect

Ikuti [panduan resmi Apple](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/) dengan URL Echobell yang tadi Anda salin:

#### Membuat Webhook

1. Masuk ke [App Store Connect](https://appstoreconnect.apple.com/)
2. Buka **Users and Access** → **Integrations**
3. Di bawah **Additional**, klik **Webhooks**
4. Klik tombol tambah (+) di samping Webhooks
5. Atur webhook Anda:
   - **Name**: Label deskriptif (misalnya, "Echobell Notifications")
   - **Payload URL**: Tempelkan URL webhook Echobell Anda
   - **Secret**: Buat string aman untuk verifikasi
   - **App**: Pilih aplikasi yang ingin Anda pantau
   - **Event Triggers**: Pilih peristiwa yang ingin Anda ikuti

#### Pemicu Peristiwa yang Tersedia

Pilih dan padukan sesuai kebutuhan:

**Peristiwa Versi App Store**

- **App Store Version State Changed** — setiap perpindahan antar status review
- **App Store Version Released** — peluncuran final ke App Store

**Peristiwa TestFlight**

- **TestFlight Beta Feedback** — komentar, rating, dan detail perangkat yang baru masuk
- **TestFlight Beta Review State Changed** — persetujuan dan penolakan build

7. Klik **Add** untuk membuat webhook-nya
</Step>
<Step>

### Uji Integrasi Anda

Gunakan tombol **Test** bawaan App Store Connect:

1. Di daftar webhook, buka webhook yang baru Anda tambahkan
2. Klik **Test** → App Store Connect akan mengirim ping
3. Pastikan Echobell menampilkan peristiwa "Ping" dengan format templat Anda
</Step>
</Steps>

## Konfigurasi Tingkat Lanjut

### Keamanan Webhook

1. **HTTPS**: URL Echobell sudah memakai TLS; tidak perlu penyiapan tambahan.
2. **Penanganan secret**: App Store Connect mewajibkan secret, tetapi Echobell memperlakukannya sebagai metadata. Simpanlah agar Anda bisa memvalidasi tanda tangan di kemudian hari jika mau.
3. **Daftar izin IP**: Perketat firewall dengan hanya mengizinkan rentang alamat keluar milik Apple.

### Templat Notifikasi Khusus

Gunakan tata letak berbeda untuk perubahan status review dan untuk masukan penguji agar sinyalnya langsung terlihat.

**Untuk Perubahan Status Aplikasi**

- Judul:

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

- Isi:

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

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

- Tautan:

```
{{app.url}}
```

**Untuk Masukan TestFlight**

- Judul:

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

- Isi:

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

- Tautan:

```
{{feedbackUrl}}
```

### Mengelola Banyak Aplikasi

- Buat saluran terpisah per aplikasi atau per lingkungan ("MyApp - Beta", "MyApp - Prod")
- Seragamkan penamaannya agar rekan tim langsung tahu harus melihat ke mana
- Terapkan aturan otomatisasi atau jam senyap per saluran saat lalu lintasnya melonjak
- Tambahkan orang hanya ke saluran yang sesuai dengan perannya

## Struktur Payload Webhook

App Store Connect mengirim payload webhook dalam format JSON. Berikut struktur umumnya:

```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"
    }
  }
}
```

## Praktik Terbaik

1. **Penataan saluran**: Buat saluran terpisah untuk aplikasi atau lingkungan yang berbeda
2. **Pengelolaan tim**: Tambahkan hanya anggota tim yang relevan ke tiap saluran
3. **Penyesuaian templat**: Sesuaikan templat agar menampilkan informasi yang paling relevan dengan alur kerja Anda
4. **Jenis notifikasi**: Pakai Peka Waktu untuk penolakan aplikasi yang kritis, dan Normal untuk kabar rutin

## Pemecahan Masalah

Jika Anda tidak menerima notifikasi:

1. Pastikan URL webhook tersalin dengan benar
2. Periksa apakah salurannya aktif dan punya pelanggan
3. Periksa kembali konfigurasi webhook App Store Connect
4. Gunakan tombol Test di App Store Connect untuk memverifikasi konektivitasnya
5. Periksa riwayat pengiriman webhook di App Store Connect

## Privasi dan Penanganan Data

Pendekatan Echobell yang mengutamakan privasi:

- Isi notifikasi disimpan secara lokal di perangkat Anda
- Hanya data konfigurasi yang penting yang disimpan di server
- URL webhook harus diperlakukan sebagai rahasia
- Tidak ada data peringatan yang disimpan di server Echobell

## Sumber Daya Tambahan

- [Dokumentasi Webhook Apple](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/)
- [Integrasi Webhook Echobell](/docs/webhook)
- [Panduan Templat Notifikasi](/docs/template)
- [Pusat Dukungan](/docs/support)