排查 Apple Messages for Business 故障
从以下症状入手。更改配置前检查商家和工作区，并保留所调查交流的消息或对话 ID。
测试对话未出现
- 在 Apple Business Register 中，确认测试人员的 Apple 账户与设备上“信息”所用账户一致，且测试人员的更改已经提交。
- 将入口 URL 与 Bird 商家记录上的 Apple Business ID 对照。
- 确认测试人员已发送消息。仅打开商家链接不会产生传入消息。
- 在关联的工作区中打开对话，清除筛选条件并刷新。
- 检查 Apple Business Register 中的提供商连接。如果设备显示错误或关联失败，请收集该错误和发生时间以供支持团队调查。
回复控件被禁用
在商家中检查商家状态，同时检查对话状态和您的渠道写入权限。回复需要开放的对话。对于草稿商家，请使用获授权的测试对话；公开上线需要获得批准。
对于客户已关闭状态，客户必须重新开始发送消息。更改分配、移除标签或结束屏蔽都不会重新打开对话。
如果缺少管理或分配操作，请管理员检查您在同一工作区中的权限。
无法准备原生消息
- 阅读验证错误，并返回模板的 Apple 投递标签页。
- 检查必填原生字段、唯一标识符、表单路径和带日期的时间段。简单的预览标签不会提供真实可预约时间。
- 为每个变量提供实际值。个性化中的示例值仅用于预览。
- 检查对话中的设备能力。如果缺少已知所需能力，请提供文本或网页替代方式。未声明的能力表示支持情况未知。
- 确认模板商家与所选对话一致。对于草稿商家，请使用获授权的测试对话。
如需逐字段编写帮助，参阅相应的原生消息指南。
消息已受理，但未出现在设备上
打开消息，选择记录并检查状态和事件。对于发送失败或已拒绝，根据记录的原因修正请求。如果媒体 URL 无法访问或下载的文件无效，媒体可能在受理后失败。
对于已发送状态，Bird 已获得 Apple 网关确认。Bird 无法观察设备投递和阅读情况。决定再次发送前，检查获授权的测试设备、其连接状态以及客户可见的对话。重试时保留原尝试；新提交可能造成消息重复。
目标被屏蔽
在屏蔽记录中检查准确地址，以及商家专用和工作区范围。保留有效退订。如果误加了屏蔽，先查明原因再结束屏蔽，然后再次检查商家和对话状态。
找不到已保存的模板
模板草稿按所选工作区保存在创建时使用的浏览器中。检查工作区、浏览器配置文件和设备。清除网站数据或换用其他浏览器可能导致无法访问草稿。Bird 目前不提供服务器上的共享模板库，也不提供这些草稿的恢复历史。
如果保存模板报告存储错误，请在关闭标签页前保留已编写的文本和原生设置。检查浏览器存储是否可用。如果另一个标签页保存了较新版本，请重新加载最新草稿，再仔细重新应用更改。
指标与消息列表不一致
对齐工作区、商家筛选条件、日期范围和时区。出站报告按受理时间分组消息；入站和对话报告使用事件时间。最近的处理结果可能更新更早的出站报告时间段。
合并报告前，先查看指标定义。缺少首次响应测量值不代表回复时间为零，客户关闭对话也不能证明其问题已解决。
联系支持
在受影响的工作区中使用帮助。提供：
- 工作区和商家记录 ID；连接问题还需提供 Apple Business ID。
- 相关对话以及发送或接收消息的 ID。
- 带时区的时间戳、状态，以及错误代码或说明。
- 入口位置或原生消息类型，以及准确的复现步骤。
- 如果问题涉及视觉呈现，提供已脱敏的截图或设备录制。
删除访问密钥、身份验证令牌、付款信息和不必要的客户信息。通过支持渠道分享标识符，不要发布到公开问题中。说明问题是在 Bird 中、Apple 设备上，还是在外部预约、订单或身份系统中可见。