---
title: "Integracja z App Store Connect – alerty o recenzji iOS"
sidebarTitle: App Store Connect
description: Podłącz webhooki App Store Connect do Echobell i odbieraj powiadomienia push lub połączenia o statusie recenzji aplikacji, buildach TestFlight i wydaniach.
---

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

# Integracja z App Store Connect

Webhooki App Store Connect rozgłaszają każdą istotną zmianę w Twoim procesie wydawniczym na iOS. Gdy te sygnały trafiają do Echobell, zespół widzi decyzje recenzentów, wydania i opinie z TestFlight w chwili, gdy się pojawiają — bez ręcznego odświeżania i przekopywania skrzynki.

**Dlaczego zespoły konfigurują tę integrację:**

- Szybsza reakcja, gdy status recenzji zmienia się na „Rejected” albo „Ready for Sale”
- Jeden strumień powiadomień o opiniach z TestFlight i przetwarzaniu buildów
- Czytelne, mobilne alerty, które utrzymują PM-ów, QA i marketing na tej samej stronie

<Callout type="info">
  Webhooki App Store Connect są dostępne dla osób z rolą Account Holder, Admin
  lub App Manager. Każdy webhook może dotyczyć tylko jednej aplikacji, a dla
  jednej aplikacji możesz utworzyć maksymalnie dziesięć webhooków.
</Callout>

## Wymagania wstępne

- Kanał Echobell z włączonymi wyzwalaczami webhook
- Dostęp do App Store Connect (Account Holder, Admin lub App Manager)
- Co najmniej jedna aktywna aplikacja iOS do monitorowania
- Adres URL webhooka Echobell (kanał → **Wyzwalacze**)

## Co możesz monitorować

App Store Connect może wysyłać do Echobell informacje o:

1. **Cyklu życia wersji w App Store** — postępach zgłoszenia, zatwierdzeniach, odrzuceniach, wydaniach
2. **Kamieniach milowych TestFlight** — wynikach przetwarzania buildów, opiniach testerów, zmianach statusu zaproszeń

## Przegląd konfiguracji

1. Przygotuj kanał Echobell wraz z szablonami powiadomień
2. Skopiuj adres URL webhooka kanału
3. Skonfiguruj webhook w App Store Connect
4. Wyślij testową wiadomość, aby zweryfikować formatowanie

## Przewodnik krok po kroku

<Steps>
<Step>
### Utwórz kanał Echobell

1. Otwórz aplikację Echobell
2. Utwórz nowy kanał (np. „App Store Connect”)
3. Wybierz wyrazisty kolor, aby szybko go rozpoznawać
4. Dodaj osoby z zespołu, które mają otrzymywać te informacje
</Step>
<Step>

### Skonfiguruj szablony powiadomień

Nadaj każdemu payloadowi zdarzenia czytelny tytuł i podsumowanie, aby zespoły mogły szybko reagować.

**Szablon tytułu:**

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

**Szablon treści:**

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

Jeśli wolisz bardziej rzeczowy ton, spokojnie usuń emoji — zmienne szablonu pozostają te same.

</Step>
<Step>
### Pobierz adres URL webhooka Echobell

1. Otwórz ustawienia kanału → **Wyzwalacze**
2. Skopiuj podany adres URL webhooka
3. Zachowaj go w tajemnicy; wkleisz go do App Store Connect
</Step>
<Step>

### Skonfiguruj webhook w App Store Connect

Postępuj zgodnie z [oficjalnym przewodnikiem Apple](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/), używając skopiowanego wcześniej adresu URL Echobell:

#### Utwórz webhook

1. Zaloguj się do [App Store Connect](https://appstoreconnect.apple.com/)
2. Przejdź do **Users and Access** → **Integrations**
3. W sekcji **Additional** kliknij **Webhooks**
4. Kliknij przycisk dodawania (+) obok Webhooks
5. Skonfiguruj webhook:
   - **Name**: opisowa nazwa (np. „Echobell Notifications”)
   - **Payload URL**: wklej swój adres URL webhooka Echobell
   - **Secret**: utwórz bezpieczny ciąg znaków do weryfikacji
   - **App**: wybierz aplikację, którą chcesz monitorować
   - **Event Triggers**: wskaż zdarzenia, które chcesz śledzić

#### Dostępne wyzwalacze zdarzeń

Wybierz to, co jest dla Ciebie istotne:

**Zdarzenia wersji w App Store**

- **App Store Version State Changed** — każda zmiana statusu w procesie recenzji
- **App Store Version Released** — ostateczna publikacja w sklepie

**Zdarzenia TestFlight**

- **TestFlight Beta Feedback** — nowe komentarze, oceny i informacje o urządzeniach
- **TestFlight Beta Review State Changed** — zatwierdzenia i odrzucenia buildów

7. Kliknij **Add**, aby utworzyć webhook
</Step>
<Step>

### Przetestuj integrację

Skorzystaj z wbudowanego przycisku **Test** w App Store Connect:

1. Na liście webhooków otwórz właśnie dodany webhook
2. Kliknij **Test** → App Store Connect wyśle sygnał ping
3. Sprawdź, czy Echobell pokazuje zdarzenie „Ping” sformatowane według Twojego szablonu
</Step>
</Steps>

## Konfiguracja zaawansowana

### Bezpieczeństwo webhooków

1. **HTTPS**: adresy Echobell działają po TLS; nic dodatkowego nie trzeba konfigurować.
2. **Obsługa sekretu**: App Store Connect wymaga sekretu, ale Echobell traktuje go jako metadane. Zachowaj go, jeśli w przyszłości zechcesz weryfikować podpisy.
3. **Lista dozwolonych adresów IP**: zaostrz reguły zapory, dopuszczając wyłącznie zakresy wychodzące Apple.

### Własne szablony powiadomień

Użyj różnych układów dla zmian statusu recenzji i dla opinii, aby sygnał był od razu czytelny.

**Dla zmian statusu aplikacji**

- Tytuł:

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

- Treść:

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

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

- Odnośnik:

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

**Dla opinii z TestFlight**

- Tytuł:

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

- Treść:

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

- Odnośnik:

```
{{feedbackUrl}}
```

### Zarządzanie wieloma aplikacjami

- Twórz osobne kanały dla każdej aplikacji lub środowiska („MyApp - Beta”, „MyApp - Prod”)
- Ujednolić nazewnictwo, aby zespół od razu wiedział, gdzie szukać
- Przy nagłych wzrostach ruchu dodaj reguły automatyzacji lub godziny ciszy dla poszczególnych kanałów
- Dodawaj ludzi tylko do tych kanałów, które odpowiadają ich roli

## Struktura payloadu webhooka

App Store Connect wysyła payloady webhooków w formacie JSON. Oto typowa struktura:

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

## Dobre praktyki

1. **Organizacja kanałów**: twórz osobne kanały dla różnych aplikacji lub środowisk
2. **Zarządzanie zespołem**: dodawaj do każdego kanału tylko właściwe osoby
3. **Dostosowanie szablonów**: dobierz szablony tak, aby pokazywały informacje najważniejsze w Twoim procesie
4. **Typy powiadomień**: użyj Czasowo krytycznych przy krytycznych odrzuceniach aplikacji, a Standardowych przy rutynowych informacjach

## Rozwiązywanie problemów

Jeśli nie otrzymujesz powiadomień:

1. Sprawdź, czy adres URL webhooka został poprawnie skopiowany
2. Sprawdź, czy kanał jest aktywny i ma subskrybentów
3. Zweryfikuj konfigurację webhooka w App Store Connect
4. Użyj przycisku Test w App Store Connect, aby sprawdzić łączność
5. Przejrzyj historię dostarczania webhooków w App Store Connect

## Prywatność i obchodzenie się z danymi

Podejście Echobell stawiające prywatność na pierwszym miejscu:

- Treść powiadomień jest przechowywana lokalnie na Twoim urządzeniu
- Na serwerach przechowujemy wyłącznie niezbędne dane konfiguracyjne
- Adresy URL webhooków należy traktować jak sekrety
- Na serwerach Echobell nie są przechowywane żadne dane alertów

## Dodatkowe materiały

- [Dokumentacja webhooków Apple](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/)
- [Integracja z webhookami Echobell](/docs/webhook)
- [Przewodnik po szablonach powiadomień](/docs/template)
- [Centrum wsparcia](/docs/support)