为商家注册 Apple Messages
将 Apple Messages for Business 账户连接到 Bird 工作区,并提交服务审核。服务规划、人员培训和上线准备请从完整入门流程开始。
Apple 负责账户审批和面向客户的商家身份。您的团队负责服务设计和人员安排。Bird 审核提交材料并协调提供商连接。创建 Bird 商家记录不代表已获准发送。
准备账户和服务
注册前,请准备:
- 企业 Apple Account,以及 Apple Business Register 中组织的访问权限。
- Bird 工作区和管理 Apple 商家的权限。请工作区管理员邀请渠道运营人员。
- 品牌名称、技术联系人、服务时间、语言和预期响应时间。
- 支持的客户任务、计划使用的入口,以及无法完成任务时转交人工的路径。
- 配备 Apple 设备的测试人员及设备使用的 Apple Account。
先选择团队已有能力完成的任务,例如回答产品问题和安排到店。记录请求超出范围或在无人值守时间到达时的处理方式。
连接 Apple 账户
按 Apple 注册说明创建测试账户,并选择 Bird 作为消息服务提供商。仅在 Bird 提供所需连接信息后使用高级端点配置。
添加测试人员并提交更改。在 Apple 的提供商配置中,使用测试消息服务提供商连接,然后在可用时选择连接。在目标 Bird 工作区中完成关联流程。
在 Apple Messages > 商家中打开已连接的记录。如果 Bird 要求创建记录,请输入 Apple Business Register 中的 Apple Business ID 和品牌名称,然后选择创建商家。不要为已关联账户创建第二条记录。
确认记录中的 Apple UUID 和品牌名称符合预期。在渠道设置中设置品牌名称和默认区域设置,然后选择保存更改。保存这些设置不能替代 Apple 的商业账户审核。

提交服务审核
打开商家的审批要求。页面提供以下项目的文档和上传控件:
| 要求 | 应包含的内容 |
|---|---|
| 就绪审核 | 消息服务目标、运营时间、人员安排、升级处理,以及团队监控服务的方式。 |
| 使用场景 | 服务实际支持的客户任务、入口、消息类型和集成。 |
| 服务演示 | 展示客户请求直至取得结果的录像,包括客服处理,以及失败路径的恢复过程。 |
录制前,连接商家,并在 Apple Business Register 中注册授权测试人员。草稿状态的商家可以发送测试消息,便于在提交前构建体验并准备演示。公开上线仍需要审批。
使用准备体验审核演示规划 iPhone 录制、演练客户旅程并检查证明材料。从页面下载表单并填写,上传两份 PDF 和 MP4 演示。审核示例使用虚构客户信息。遵循控件显示的格式和上传限制。
提交已完成的要求。提交历史保留证明材料和审核结果。Bird 员工管理审批状态转换;客户无法直接将商家改为已批准。
| Bird 状态 | 操作 |
|---|---|
| 草稿 | 与授权测试人员测试,完成要求并提交。 |
| 已提交或审核中 | 查看最新提交,响应更改请求。 |
| 已拒绝 | 查看原因,替换相关证明材料并重新提交。 |
| 已批准 | 公开入口前完成首次对话检查。 |
| 已暂停 | 查看原因并联系支持;更改品牌设置不会恢复审批。 |
通过 API 提交证据
使用托管您工作区的 API 区域,以及具有 amb_management:write 权限的凭据来上传和提交,另需 amb_management:read 权限来检查结果。发送该工作区的 X-Workspace-Id。为每个 POST 请求提供一个 Idempotency-Key,如果重试同一请求则复用该键。
- 使用
POST /v1/amb/business-accounts创建草稿。提供name和您的apple_business_id。保存返回的账户id;提供 Apple 的 UUID 并不会将账户提交审核。 - 使用
POST /v1/amb/business-account-attachments分别上传准备评估 PDF、用例 PDF 和演示 MP4。每个请求是包含file字段的 multipart 表单数据。保存每个返回的附件id。证据文件必须各不相同,且上传到同一工作区。 - 使用
POST /v1/amb/business-accounts/{business_account_id}/submissions提交。将readiness_attachment_id、use_cases_attachment_id和video_attachment_id设置为对应的上传 ID。提交操作会锁定证据以及所选的企业名称和 Apple UUID 以供审核。成功的响应记录了该次审核尝试,但并不意味着获批。 - 读取
GET /v1/amb/business-accounts/{business_account_id}以获取account_review_status和运营status。检查GET /v1/amb/business-accounts/{business_account_id}/submissions以查看审核反馈和保留的证据。被拒绝后,上传修正后的证据并创建新的提交。之前的尝试保留在历史记录中。
使用控制台或 HTTP API 上传文件。CLI 还支持 bird amb business-accounts attachments upload --file readiness.pdf,本地 stdio MCP 提供 amb_business_accounts_attachments_upload。SDK 和托管的 MCP 使用返回的附件 ID 创建提交;它们不会上传本地文件。托管代理需要您提供这些 ID 后才能提交。
当账户已激活且客户已发起对话时,继续前往回复快速入门。
准备上线
体验审核后,按照 Apple Business Register 的当前说明完成 Apple 商业账户配置和素材审核。在其中准备品牌素材、响应时间和商家地点。
公开入口前:
- 使用计划上线的商家完成首次对话快速入门。
- 让客服演练分配、标签和回复,包括无法解决的请求。
- 在授权设备上测试每种原生消息。将外部预约或订单结果与消息结果分开确认。
- 核实服务时间和面向客户的预期。指定监控新对话和失败的负责人。
- 启用获批的入口,然后查看首批入站对话和渠道指标。
解决设置问题
如果 Apple 连接控件不可用,请确认已提交账户和测试人员。如果关联失败,请先检查 Bird 工作区和 Apple Business ID,再重试。如果 Bird 操作缺失或被禁用,请管理员检查商家管理权限。
审核延迟时,请查看提交历史和账户邮箱,检查 Bird 或 Apple 的请求。已获批商家无法回复时,请按渠道故障排查操作。