---
title: "Интеграция с App Store Connect — оповещения о проверке iOS"
sidebarTitle: App Store Connect
description: Подключите вебхуки App Store Connect к Echobell и получайте push-уведомления или звонки при изменении статуса проверки приложения, сборках TestFlight и выходе релизов.
---

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

# Интеграция с App Store Connect

Вебхуки App Store Connect передают каждое значимое изменение в вашем конвейере выпуска iOS. Когда эти сигналы приходят в Echobell, команда видит решения по проверке, релизы и отзывы TestFlight в момент их появления — без ручного обновления страниц и раскопок в почте.

**Зачем команды подключают эту интеграцию:**

- Быстрее реакция, когда статус проверки меняется на «Rejected» или «Ready for Sale»
- Единый поток уведомлений об отзывах TestFlight и обработке сборок
- Понятные оповещения на телефоне, которые держат менеджеров, QA и маркетинг в курсе

<Callout type="info">
  Вебхуки App Store Connect доступны разработчикам с ролями Account Holder,
  Admin или App Manager. Каждый вебхук работает только с одним приложением, и на
  приложение можно создать до десяти вебхуков.
</Callout>

## Предварительные требования

- Канал Echobell с включёнными вебхук-триггерами
- Доступ к App Store Connect (Account Holder, Admin или App Manager)
- Хотя бы одно активное приложение iOS для мониторинга
- URL вебхука Echobell (канал → **Triggers**)

## Что можно отслеживать

App Store Connect может сообщать Echobell о следующем:

1. **Жизненный цикл версии в App Store** — ход отправки, одобрения, отклонения, релизы
2. **Ключевые события TestFlight** — результаты обработки сборок, отзывы тестировщиков, изменения статуса приглашений

## Обзор настройки

1. Подготовьте канал Echobell и шаблоны уведомлений
2. Скопируйте URL вебхука канала
3. Настройте вебхук в App Store Connect
4. Отправьте тестовую доставку и проверьте форматирование

## Пошаговое руководство

<Steps>
<Step>
### Создайте канал Echobell

1. Откройте приложение Echobell
2. Создайте новый канал (например, «App Store Connect»)
3. Выберите заметный цвет, чтобы канал легко было найти взглядом
4. Добавьте коллег, которые должны получать эти обновления
</Step>
<Step>

### Настройте шаблоны уведомлений

Дайте каждому событию понятный заголовок и краткое описание, чтобы команда могла быстро реагировать.

**Шаблон заголовка:**

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

**Шаблон тела:**

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

Если вам ближе более сухой тон, эмодзи можно убрать — переменные шаблона от этого не меняются.

</Step>
<Step>
### Получите URL вебхука Echobell

1. Откройте настройки канала → **Triggers**
2. Скопируйте предложенный URL вебхука
3. Держите его в секрете — вы вставите его в App Store Connect
</Step>
<Step>

### Настройте вебхук в App Store Connect

Следуйте [официальному руководству Apple](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/), подставив скопированный ранее URL Echobell:

#### Создайте вебхук

1. Войдите в [App Store Connect](https://appstoreconnect.apple.com/)
2. Перейдите в **Users and Access** → **Integrations**
3. В разделе **Additional** нажмите **Webhooks**
4. Нажмите кнопку добавления (+) рядом с Webhooks
5. Настройте вебхук:
   - **Name**: понятное название (например, «Echobell Notifications»)
   - **Payload URL**: вставьте URL вебхука Echobell
   - **Secret**: создайте надёжную строку для проверки
   - **App**: выберите приложение, за которым хотите следить
   - **Event Triggers**: выберите нужные события

#### Доступные триггеры событий

Комбинируйте то, что важно именно вам:

**События версии в App Store**

- **App Store Version State Changed** — любое движение по статусам проверки
- **App Store Version Released** — финальная публикация в магазине

**События TestFlight**

- **TestFlight Beta Feedback** — новые комментарии, оценки и данные об устройстве
- **TestFlight Beta Review State Changed** — одобрение и отклонение сборок

7. Нажмите **Add**, чтобы создать вебхук
</Step>
<Step>

### Проверьте интеграцию

Воспользуйтесь встроенной кнопкой **Test** в App Store Connect:

1. В списке вебхуков откройте только что добавленный вебхук
2. Нажмите **Test** — App Store Connect отправит пинг
3. Убедитесь, что Echobell показывает событие «Ping» с форматированием из вашего шаблона
</Step>
</Steps>

## Расширенная настройка

### Безопасность вебхука

1. **HTTPS**: URL Echobell работают по TLS, дополнительная настройка не нужна.
2. **Работа с secret**: App Store Connect обязательно требует secret, но Echobell рассматривает его как метаданные. Сохраните его, чтобы при желании позже проверять подписи.
3. **Списки разрешённых IP**: ужесточите правила брандмауэра, разрешив только исходящие диапазоны Apple.

### Собственные шаблоны уведомлений

Используйте разные форматы для изменений статуса проверки и для отзывов, чтобы сигнал сразу считывался.

**Для изменений статуса приложения**

- Заголовок:

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

- Тело:

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

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

- Ссылка:

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

**Для отзывов TestFlight**

- Заголовок:

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

- Тело:

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

- Ссылка:

```
{{feedbackUrl}}
```

### Управление несколькими приложениями

- Заводите отдельные каналы под каждое приложение или окружение («MyApp - Beta», «MyApp - Prod»)
- Придерживайтесь единой схемы именования, чтобы коллеги сразу понимали, куда смотреть
- При всплесках трафика добавляйте на канал правила автоматизации или тихие часы
- Добавляйте людей только в те каналы, которые соответствуют их роли

## Структура полезной нагрузки вебхука

App Store Connect отправляет полезную нагрузку вебхука в формате JSON. Типичная структура:

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

## Рекомендации

1. **Организация каналов**: создавайте отдельные каналы для разных приложений или окружений
2. **Управление командой**: добавляйте в каждый канал только тех, кому он нужен
3. **Настройка шаблонов**: подстройте шаблоны так, чтобы они показывали самое важное для вашего процесса
4. **Типы уведомлений**: используйте «Срочное» для критичных отклонений приложения и «Обычное» для рутинных обновлений

## Устранение неполадок

Если уведомления не приходят:

1. Проверьте, что URL вебхука скопирован правильно
2. Убедитесь, что канал активен и у него есть подписчики
3. Проверьте настройки вебхука в App Store Connect
4. Проверьте связь кнопкой Test в App Store Connect
5. Посмотрите историю доставки вебхуков в App Store Connect

## Конфиденциальность и обработка данных

Подход Echobell с приоритетом конфиденциальности:

- Содержимое уведомлений хранится локально на вашем устройстве
- На серверах хранятся только необходимые данные конфигурации
- URL вебхуков следует считать секретами
- Данные оповещений не сохраняются на серверах Echobell

## Дополнительные ресурсы

- [Документация Apple по вебхукам](https://developer.apple.com/help/app-store-connect/manage-your-team/manage-webhooks/)
- [Интеграция вебхуков Echobell](/ru/docs/webhook)
- [Руководство по шаблонам уведомлений](/ru/docs/template)
- [Центр поддержки](/ru/docs/support)