在 Apple Messages 中发送图片和文件
使用图片或文档模板,在开放的客户对话中发送产品图片、说明或收据。Bird 在处理消息时获取源文件,并将其准备为 Apple 所需的格式。
准备可获取的文件
将目标文件托管在公开的 HTTPS URL 上,确保无需浏览器 Cookie 或登录即可获取。使用可在该 URL 安全公开的专用文件。私人网盘预览页不是文件的直接 URL。
发送消息参考规定了以下媒体限制:
| 用途 | 要求 |
|---|---|
| 发送的附件 | 每个文件小于 100 MB。提供正确的文件名和媒体类型。 |
| 原生交互或富链接图片 | 使用 PNG,每张图片最大 200 kB;交互图片总大小不超过 5 MB。 |
| 已发布 iMessage 应用的图标 | 小于 15 kB 的 PNG。参阅应用体验。 |
在处理完成之前,保持 URL 可用。签名 URL 过早过期,可能导致消息已受理后仍处理失败。在未登录的浏览器中测试 URL,确认返回的是实际文件,而不是 HTML 页面。
配置模板
- 打开模板,选择新建模板 > 图片或文档。
- 在内容中为草稿填写模板名称,并输入能说明附件内容的消息。
- 在 Apple 投递中设置附件 URL、文件名和媒体类型。例如,PDF 使用 .pdf 文件名和 application/pdf。
- 在个性化中选择商家,然后保存草稿。
- 准备并检查消息,在发送前核对实际客户和文件。
随附的预览图片不是实际发送时的附件来源。请明确提供目标 URL。
检查结果
查看已提交的消息和事件,然后在获授权的 Apple 测试设备上打开附件。检查可读性、文件名,以及脱离网站上下文后内容是否仍清楚。
如果消息在受理后失败,请先查看错误,再修改模板。常见原因包括 URL 无法访问、媒体类型不符、文件超过大小限制或 PNG 数据无效。更改文件扩展名不会转换文件格式。
收到的附件可以按名称显示在对话记录中。对话记录目前不提供经过身份验证的附件下载操作。附件和媒体获取操作不属于公共 API。如果服务需要下载收到的文件,请先与 Bird 确认可用的获取流程,再将其用于服务。