Integração com App Store Connect - alertas de revisão iOS

Os webhooks do App Store Connect transmitem cada mudança relevante do seu pipeline de lançamento no iOS. Quando esses sinais chegam ao Echobell, seu time vê decisões de revisão, lançamentos e feedbacks do TestFlight no momento em que acontecem — sem atualizar páginas manualmente nem garimpar a caixa de entrada.

Por que os times conectam esta integração:

• Reação mais rápida quando a revisão muda para "Rejected" ou "Ready for Sale"
• Um único fluxo de notificações para feedback do TestFlight e processamento de builds
• Alertas claros e fáceis de ler no celular, que mantêm PMs, QA e marketing alinhados

Pré-requisitos

• Um canal do Echobell com os gatilhos de webhook ativados
• Acesso ao App Store Connect (Account Holder, Admin ou App Manager)
• Pelo menos um app iOS ativo para monitorar
• A URL do seu webhook do Echobell (Canal → Triggers)

O que você pode monitorar

O App Store Connect pode acionar o Echobell para:

1. Ciclo de vida das versões da App Store — progresso do envio, aprovações, rejeições, lançamentos
2. Marcos do TestFlight — resultados do processamento de builds, feedback de testadores, mudanças no status dos convites

Visão geral da configuração

1. Prepare um canal do Echobell e os modelos de notificação
2. Copie a URL do webhook do canal
3. Configure um webhook no App Store Connect
4. Envie uma entrega de teste para conferir a formatação

Guia passo a passo

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

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

Configuração avançada

Segurança do webhook

1. HTTPS: as URLs do Echobell já usam TLS; nenhuma configuração extra é necessária.
2. Uso do secret: o App Store Connect exige um secret, mas o Echobell o trata como metadado. Guarde-o para validar assinaturas mais adiante, se preferir.
3. Lista de IPs permitidos: reforce o firewall liberando apenas as faixas de saída da Apple.

Modelos de notificação personalizados

Use layouts diferentes para mudanças de status da revisão e para feedbacks, assim o sinal fica evidente.

Para mudanças de status do app

• Título:

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

• Corpo:

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

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

• Link:

{{app.url}}

Para feedback do TestFlight

• Título:

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

• Corpo:

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

• Link:

{{feedbackUrl}}

Gerenciar vários apps

• Crie canais distintos por app ou ambiente ("MyApp - Beta", "MyApp - Prod")
• Padronize os nomes para que o time saiba na hora onde olhar
• Adicione regras de automação ou horários silenciosos por canal quando o tráfego aumentar
• Inscreva cada pessoa apenas nos canais que combinam com o papel dela

Estrutura do payload do webhook

O App Store Connect envia os payloads dos webhooks em formato JSON. Esta é a estrutura típica:

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

Boas práticas

1. Organização dos canais: crie canais separados para apps ou ambientes diferentes
2. Gestão do time: adicione a cada canal apenas as pessoas realmente envolvidas
3. Personalização dos modelos: ajuste os modelos para mostrar as informações mais relevantes para o seu fluxo de trabalho
4. Tipos de notificação: use Urgente para rejeições críticas do app e Normal para atualizações de rotina

Solução de problemas

Se você não estiver recebendo notificações:

1. Confirme que a URL do webhook foi copiada corretamente
2. Verifique se o canal está ativo e tem inscritos
3. Revise a configuração do webhook no App Store Connect
4. Use o botão Test no App Store Connect para checar a conectividade
5. Consulte o histórico de entregas do webhook no App Store Connect

Privacidade e tratamento de dados

A abordagem do Echobell, que coloca a privacidade em primeiro lugar:

• O conteúdo das notificações fica armazenado localmente no seu dispositivo
• Apenas os dados essenciais de configuração ficam nos servidores
• As URLs de webhook devem ser tratadas como segredos
• Nenhum dado de alerta é mantido nos servidores do Echobell

Recursos adicionais

• Documentação da Apple sobre webhooks
• Integração de webhook do Echobell
• Guia de modelos de notificação
• Central de suporte