Интеграция с App Store Connect — оповещения о проверке iOS

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

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

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

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

• Канал 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. Отправьте тестовую доставку и проверьте форматирование

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

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

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

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

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

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. Типичная структура:

{
  "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 по вебхукам
• Интеграция вебхуков Echobell
• Руководство по шаблонам уведомлений
• Центр поддержки