# 排查 Apple Messages for Business 故障

从以下症状入手。更改配置前检查商家和工作区，并保留所调查交流的消息或对话 ID。

## 测试对话未出现

1. 在 Apple Business Register 中，确认测试人员的 Apple 账户与设备上“信息”所用账户一致，且测试人员的更改已经提交。
2. 将入口 URL 与 Bird 商家记录上的 **Apple Business ID** 对照。
3. 确认测试人员已发送消息。仅打开商家链接不会产生传入消息。
4. 在关联的工作区中打开[**对话**](https://bird.com/dashboard/w/apple-messages/conversations)，清除筛选条件并刷新。
5. 检查 Apple Business Register 中的提供商连接。如果设备显示错误或关联失败，请收集该错误和发生时间以供支持团队调查。

## 回复控件被禁用

在[**商家**](https://bird.com/dashboard/w/apple-messages/businesses)中检查商家状态，同时检查对话状态和您的渠道写入权限。回复需要开放的对话。对于**草稿**商家，请使用获授权的测试对话；公开上线需要获得批准。

对于**客户已关闭**状态，客户必须重新开始发送消息。更改分配、移除标签或结束屏蔽都不会重新打开对话。

如果缺少管理或分配操作，请管理员检查您在同一工作区中的权限。

## 无法准备原生消息

1. 阅读验证错误，并返回模板的 **Apple 投递**标签页。
2. 检查必填原生字段、唯一标识符、表单路径和带日期的时间段。简单的预览标签不会提供真实可预约时间。
3. 为每个变量提供实际值。**个性化**中的示例值仅用于预览。
4. 检查对话中的**设备能力**。如果缺少已知所需能力，请提供文本或网页替代方式。未声明的能力表示支持情况未知。
5. 确认模板商家与所选对话一致。对于**草稿**商家，请使用获授权的测试对话。

如需逐字段编写帮助，参阅相应的[原生消息指南](/docs/guides/apple-messages/rich-messages)。

## 消息已受理，但未出现在设备上

打开[**消息**](https://bird.com/dashboard/w/apple-messages/messages)，选择记录并检查状态和事件。对于**发送失败**或**已拒绝**，根据记录的原因修正请求。如果媒体 URL 无法访问或下载的文件无效，媒体可能在受理后失败。

对于**已发送**状态，Bird 已获得 Apple 网关确认。Bird 无法观察设备投递和阅读情况。决定再次发送前，检查获授权的测试设备、其连接状态以及客户可见的对话。重试时保留原尝试；新提交可能造成消息重复。

## 目标被屏蔽

在[屏蔽记录](/docs/guides/apple-messages/suppressions)中检查准确地址，以及商家专用和工作区范围。保留有效退订。如果误加了屏蔽，先查明原因再结束屏蔽，然后再次检查商家和对话状态。

## 找不到已保存的模板

模板草稿按所选工作区保存在创建时使用的浏览器中。检查工作区、浏览器配置文件和设备。清除网站数据或换用其他浏览器可能导致无法访问草稿。Bird 目前不提供服务器上的共享模板库，也不提供这些草稿的恢复历史。

如果**保存模板**报告存储错误，请在关闭标签页前保留已编写的文本和原生设置。检查浏览器存储是否可用。如果另一个标签页保存了较新版本，请重新加载最新草稿，再仔细重新应用更改。

## 指标与消息列表不一致

对齐工作区、商家筛选条件、日期范围和时区。出站报告按受理时间分组消息；入站和对话报告使用事件时间。最近的处理结果可能更新更早的出站报告时间段。

合并报告前，先查看[指标定义](/docs/guides/apple-messages/analytics)。缺少首次响应测量值不代表回复时间为零，客户关闭对话也不能证明其问题已解决。

## 联系支持

在受影响的工作区中使用[**帮助**](https://bird.com/dashboard/w/support)。提供：

- 工作区和商家记录 ID；连接问题还需提供 Apple Business ID。
- 相关对话以及发送或接收消息的 ID。
- 带时区的时间戳、状态，以及错误代码或说明。
- 入口位置或原生消息类型，以及准确的复现步骤。
- 如果问题涉及视觉呈现，提供已脱敏的截图或设备录制。

删除访问密钥、身份验证令牌、付款信息和不必要的客户信息。通过支持渠道分享标识符，不要发布到公开问题中。说明问题是在 Bird 中、Apple 设备上，还是在外部预约、订单或身份系统中可见。