---
title: "Integração com o App Store Connect - alertas de revisão do iOS"
sidebarTitle: App Store Connect
description: Conecte os webhooks do App Store Connect ao Echobell e receba notificações push ou alertas em chamada sobre o status da revisão do app, builds do TestFlight e atualizações de lançamento.
---

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

# Integração com o App Store Connect

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

<Callout type="info">
  Os webhooks do App Store Connect estão disponíveis para desenvolvedores com os
  papéis Account Holder, Admin ou App Manager. Cada webhook só pode se aplicar a
  um app, e você pode criar até dez webhooks por app.
</Callout>

## 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

<Steps>
<Step>
### Criar um canal do Echobell

1. Abra o app Echobell
2. Crie um novo canal (por exemplo, "App Store Connect")
3. Escolha uma cor marcante para identificá-lo rapidamente
4. Adicione os colegas de time que devem receber essas atualizações
</Step>
<Step>

### Configurar os modelos de notificação

Dê a cada payload de evento um título e um resumo claros, para que o time possa agir rápido.

**Modelo do título:**

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

**Modelo do corpo:**

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

Se preferir um tom mais seco, fique à vontade para tirar os emojis — as variáveis do modelo continuam as mesmas.

</Step>
<Step>
### Obter a URL do seu webhook do Echobell

1. Abra as configurações do canal → **Triggers**
2. Copie a URL do webhook exibida
3. Mantenha-a em sigilo; você vai colá-la no App Store Connect
</Step>
<Step>

### Configurar o webhook no App Store Connect

Siga o [guia oficial da Apple](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/) usando a URL do Echobell que você copiou antes:

#### Criar um webhook

1. Faça login no [App Store Connect](https://appstoreconnect.apple.com/)
2. Vá em **Usuários e Acesso** → **Integrações**
3. Em **Adicional**, clique em **Webhooks**
4. Clique no botão de adicionar (+) ao lado de Webhooks
5. Configure o webhook:
   - **Nome**: um rótulo descritivo (por exemplo, "Notificações do Echobell")
   - **URL do payload**: cole a URL do seu webhook do Echobell
   - **Secret**: crie uma string segura para verificação
   - **App**: selecione o app que você quer monitorar
   - **Gatilhos de evento**: escolha os eventos que quer acompanhar

#### Gatilhos de evento disponíveis

Combine o que for importante para você:

**Eventos de versão da App Store**

- **App Store Version State Changed** — cada mudança entre os estados da revisão
- **App Store Version Released** — a publicação final na loja

**Eventos do TestFlight**

- **TestFlight Beta Feedback** — novos comentários, avaliações e detalhes do dispositivo
- **TestFlight Beta Review State Changed** — aprovações e rejeições de builds

7. Clique em **Adicionar** para criar o webhook
</Step>
<Step>

### Testar a integração

Use o botão **Test** embutido no App Store Connect:

1. Na lista de webhooks, abra o webhook que você acabou de adicionar
2. Clique em **Test** → o App Store Connect envia um ping
3. Confirme que o Echobell mostra o evento "Ping" com a formatação do seu modelo
</Step>
</Steps>

## 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:

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

## 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](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/)
- [Integração de webhook do Echobell](/docs/webhook)
- [Guia de modelos de notificação](/docs/template)
- [Central de suporte](/docs/support)