Integracja z App Store Connect – alerty o recenzji iOS

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

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

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

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

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:

{
  "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
• Integracja z webhookami Echobell
• Przewodnik po szablonach powiadomień
• Centrum wsparcia