# 在 Apple Messages 中发送图片和文件

使用**图片**或**文档**模板，在开放的客户对话中发送产品图片、说明或收据。Bird 在处理消息时获取源文件，并将其准备为 Apple 所需的格式。

## 准备可获取的文件

将目标文件托管在公开的 HTTPS URL 上，确保无需浏览器 Cookie 或登录即可获取。使用可在该 URL 安全公开的专用文件。私人网盘预览页不是文件的直接 URL。

[发送消息参考](/docs/api/reference/create-amb-message)规定了以下媒体限制：

| 用途                       | 要求                                                                         |
| -------------------------- | ---------------------------------------------------------------------------- |
| 发送的附件                 | 每个文件小于 100 MB。提供正确的文件名和媒体类型。                            |
| 原生交互或富链接图片       | 使用 PNG，每张图片最大 200 kB；交互图片总大小不超过 5 MB。                   |
| 已发布 iMessage 应用的图标 | 小于 15 kB 的 PNG。参阅[应用体验](/docs/guides/apple-messages/custom-apps)。 |

在处理完成之前，保持 URL 可用。签名 URL 过早过期，可能导致消息已受理后仍处理失败。在未登录的浏览器中测试 URL，确认返回的是实际文件，而不是 HTML 页面。

## 配置模板

1. 打开[**模板**](https://bird.com/dashboard/w/apple-messages/templates)，选择**新建模板 > 图片**或**文档**。
2. 在**内容**中为草稿填写**模板名称**，并输入能说明附件内容的**消息**。
3. 在 **Apple 投递**中设置**附件 URL**、**文件名**和**媒体类型**。例如，PDF 使用 `.pdf` 文件名和 `application/pdf`。
4. 在**个性化**中选择商家，然后保存草稿。
5. [准备并检查消息](/docs/guides/apple-messages/templates#send-the-reviewed-template)，在发送前核对实际客户和文件。

随附的预览图片不是实际发送时的附件来源。请明确提供目标 URL。

## 检查结果

查看已提交的消息和事件，然后在获授权的 Apple 测试设备上打开附件。检查可读性、文件名，以及脱离网站上下文后内容是否仍清楚。

如果消息在受理后失败，请先查看错误，再修改模板。常见原因包括 URL 无法访问、媒体类型不符、文件超过大小限制或 PNG 数据无效。更改文件扩展名不会转换文件格式。

收到的附件可以按名称显示在对话记录中。对话记录目前不提供经过身份验证的附件下载操作。附件和媒体获取操作不属于公共 API。如果服务需要下载收到的文件，请先与 Bird 确认可用的获取流程，再将其用于服务。