Integrazione App Store Connect - avvisi di revisione iOS

I webhook di App Store Connect trasmettono ogni cambiamento rilevante della tua pipeline di rilascio iOS. Quando quei segnali arrivano in Echobell, il tuo team vede esiti delle revisioni, rilasci e feedback TestFlight nell'istante in cui si verificano: niente aggiornamenti manuali della pagina né caselle di posta da spulciare.

Perché i team collegano questa integrazione:

• Reazioni più rapide quando una revisione passa a "Rejected" o "Ready for Sale"
• Un unico flusso di notifiche per il feedback TestFlight e l'elaborazione delle build
• Avvisi chiari e leggibili da smartphone, che tengono allineati PM, QA e marketing

Prerequisiti

• Un canale Echobell con i trigger webhook attivi
• Accesso ad App Store Connect (Account Holder, Admin o App Manager)
• Almeno un'app iOS attiva da monitorare
• Il tuo URL webhook di Echobell (Canale → Triggers)

Cosa puoi monitorare

App Store Connect può avvisare Echobell per:

1. Ciclo di vita delle versioni App Store — avanzamento dell'invio, approvazioni, rifiuti, rilasci
2. Traguardi TestFlight — esiti dell'elaborazione delle build, feedback dei tester, cambi di stato degli inviti

Panoramica della configurazione

1. Prepara un canale Echobell e i modelli di notifica
2. Copia l'URL webhook del canale
3. Configura un webhook in App Store Connect
4. Invia una consegna di prova per verificare la formattazione

Guida passo passo

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

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

Configurazione avanzata

Sicurezza dei webhook

1. HTTPS: gli URL di Echobell viaggiano già su TLS, non serve altro.
2. Gestione del secret: App Store Connect impone un secret, ma Echobell lo tratta come metadato. Conservalo, così in futuro potrai validare le firme se vorrai.
3. Allowlist di IP: restringi il firewall consentendo solo gli intervalli di uscita di Apple.

Modelli di notifica personalizzati

Usa layout diversi per i cambi di stato della revisione e per il feedback, così il segnale si riconosce a colpo d'occhio.

Per i cambi di stato dell'app

• Titolo:

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

• Corpo:

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

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

• Link:

{{app.url}}

Per il feedback TestFlight

• Titolo:

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

• Corpo:

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

• Link:

{{feedbackUrl}}

Gestire più app

• Crea canali distinti per ogni app o ambiente ("MyApp - Beta", "MyApp - Prod")
• Uniforma i nomi, così i colleghi capiscono subito dove guardare
• Aggiungi regole di automazione o orari di silenzio sui singoli canali quando il traffico cresce
• Iscrivi ogni persona solo ai canali che riguardano il suo ruolo

Struttura del payload webhook

App Store Connect invia i payload dei webhook in formato JSON. Ecco la struttura tipica:

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

Best practice

1. Organizzazione dei canali: crea canali separati per app o ambienti diversi
2. Gestione del team: aggiungi a ogni canale solo le persone davvero coinvolte
3. Personalizzazione dei modelli: adatta i modelli per mostrare le informazioni più utili al tuo flusso di lavoro
4. Tipi di notifica: usa Urgente per i rifiuti critici e Normale per gli aggiornamenti di routine

Risoluzione dei problemi

Se non ricevi notifiche:

1. Controlla di aver copiato correttamente l'URL webhook
2. Verifica che il canale sia attivo e abbia iscritti
3. Ricontrolla la configurazione del webhook in App Store Connect
4. Usa il pulsante Test di App Store Connect per verificare la connettività
5. Consulta la cronologia delle consegne del webhook in App Store Connect

Privacy e gestione dei dati

L'approccio privacy-first di Echobell:

• Il contenuto delle notifiche resta memorizzato in locale sul tuo dispositivo
• Sui server vengono conservati solo i dati di configurazione essenziali
• Gli URL webhook vanno trattati come dati segreti
• Nessun dato degli avvisi viene conservato sui server di Echobell

Risorse aggiuntive

• Documentazione Apple sui webhook
• Integrazione webhook di Echobell
• Guida ai modelli di notifica
• Centro assistenza