学习如何将 App Store Connect Webhook 与 Echobell 集成，获取即时应用状态通知和 TestFlight 反馈提醒

App Store Connect Webhook 集成

App Store Connect 提供 Webhook 功能，可以直接向您的服务器发送关于应用状态变化和 TestFlight 反馈的实时通知。通过将 App Store Connect Webhook 与 Echobell 集成，您可以在 iOS 应用发生重要事件时立即在移动设备上接收通知。

App Store Connect Webhook 适用于具有 Account Holder、Admin 或 App Manager 角色的开发者。每个 Webhook 只能应用于一个应用，每个应用最多可以创建十个 Webhook。

先决条件

至少创建了一个频道的 Echobell 账户
具有 Account Holder、Admin 或 App Manager 角色的 App Store Connect 访问权限
App Store Connect 中的活跃 iOS 应用
您的 Echobell Webhook URL（在频道设置中可用）

可监控的内容

App Store Connect Webhook 可以通知您以下事件：

应用版本状态变化
- 应用提交状态更新
- 应用审核批准或拒绝
- 应用在 App Store 发布
- 版本更新上线
TestFlight 事件
- Beta 测试员提交的新 TestFlight 反馈
- 构建处理完成
- 测试员邀请状态变化

设置概述

创建和配置 Echobell 频道
为 App Store Connect 事件设置通知模板
获取您的 Echobell Webhook URL
在 App Store Connect 中创建和配置 Webhook
测试集成

分步指南

1. 创建 Echobell 频道

打开 Echobell 应用
创建新频道（例如"App Store Connect"）
选择明显的颜色和图标以便于识别
添加应该接收应用状态通知的团队成员

2. 配置通知模板

设置能有效格式化 App Store Connect 事件的模板：

标题模板：

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

正文模板：

📱 应用：{{app.name}}
🔄 事件：{{eventType}}
📊 状态：{{status}}
⏰ 时间：{{eventDate}}
💬 消息：{{message}}
🔗 在 App Store Connect 中查看

3. 获取您的 Echobell Webhook URL

在 Echobell 频道设置中，导航到 触发器 部分
复制提供的 Webhook URL
安全保存此 URL，因为它将在 App Store Connect 中配置

4. 配置 App Store Connect Webhook

根据 Apple 官方文档，按照以下步骤操作：

创建 Webhook

登录 App Store Connect
导航到 用户和访问权限
在侧边栏中点击集成
在其他下，点击 Webhook
点击 Webhook 旁边的添加按钮 (+)
配置您的 Webhook：
- 名称：输入描述性名称（例如"Echobell 通知"）
- 载荷 URL：粘贴您的 Echobell Webhook URL
- 密钥：创建用于认证的安全密钥字符串
- 应用：选择您要监控的应用
- 事件触发器：选择您希望接收通知的事件

可用的事件触发器

根据您的监控需求选择这些事件类型：

应用版本事件：

App Store Version State Changed：当您的应用审核状态发生变化时
App Store Version Released：当您的应用版本在 App Store 发布时

TestFlight 事件：

TestFlight Beta Feedback：当 Beta 测试员提交反馈时
TestFlight Beta Review State Changed：当 TestFlight 审核状态发生变化时

点击添加创建 Webhook

5. 测试您的集成

创建 Webhook 后，使用 App Store Connect 的内置测试功能：
- 在 Webhook 列表中，点击您新创建的 Webhook
- 点击右上角的测试
- 测试 ping 将发送到您的 Echobell 频道
您应该在 Echobell 中收到事件类型为"Ping"的测试通知

高级配置

Webhook 安全性

为了增强安全性并验证 Webhook 真实性：

使用 HTTPS：Echobell Webhook URL 默认使用 HTTPS
密钥验证：使用您配置的密钥来验证传入请求
IP 白名单：考虑将 Apple 的 Webhook 传送 IP 范围加入白名单

自定义通知模板

根据不同事件类型自定义您的模板：

对于应用状态变化：

标题模板：

[{{app.name}}] 应用 {{eventType}}

正文模板：

🍎 您的应用"{{app.name}}"状态已更改！

📊 状态：{{status}}
📅 日期：{{eventDate}}

链接模板：

{{app.url}}

对于 TestFlight 反馈：

标题模板：

[{{app.name}}] 新的 TestFlight 反馈

正文模板：

📱 应用：{{app.name}}
👤 测试员：{{tester.name}}
⭐ 评分：{{rating}}/5
💬 反馈：{{feedback}}
📱 设备：{{device}}

链接模板：

{{feedbackUrl}}

管理多个应用

对于管理多个应用的团队：

为每个应用或应用类别创建单独的频道
使用描述性命名约定（例如"MyApp - 生产"、"MyApp - Beta"）
为不同应用配置不同的通知计划
设置基于角色的频道订阅

Webhook 载荷结构

App Store Connect 以 JSON 格式发送 Webhook 载荷。典型结构如下：

{
  "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": "我的出色应用",
      "bundleId": "com.example.myapp"
    },
    "appStoreVersion": {
      "id": "987654321",
      "versionString": "1.2.0",
      "appStoreState": "READY_FOR_SALE"
    }
  }
}