发送媒体：图片、视频、音频和文档

按类型划分的限制

每种类型都不同。超过限制会返回错误 131053，而不是明确的说明。

• 图片：5 MB。JPEG 和 PNG。
• 视频：16 MB。MP4 和 3GPP，视频使用 H.264，音频使用 AAC。
• 音频：16 MB。AAC、AMR、MP3、MP4 音频，以及使用 Opus 的 OGG。
• 文档：100 MB。常见文档类型，包括 PDF 和 Office 格式。
• 贴纸：动态 100 KB，静态 500 KB，仅支持 WebP。

上传与提供链接

发送同一文件有两种方式，但失败原因不同。

上传会先将文件发送至 Meta，并返回媒体 ID。发送消息时，您可以引用此 ID。提供链接则是让 Meta 在发送时通过 URL 获取文件。提供链接看似更简单，却多出一种您看不见的失败原因：URL 即使能在您的浏览器中打开，也可能因地理位置、防火墙规则，或浏览器已有的会话 Cookie，无法从 Meta 的基础设施访问。

请上传文件。只多一次请求，就能移除整类故障。

接收媒体

入站媒体会以媒体 ID 传入，而不是以字节传入。您的处理程序需要使用该 ID，另外获取文件。

• 尽快获取。ID 的有效期不是永久的。
• 获取失败会返回错误 131052，通常表示发送方的上传未完成。
• 如果之后还需要使用文件，请自行保存。Meta 不是归档系统。
• 即使媒体获取失败，也要记录消息，让文字和上下文得以保留。

Coexistence 带来的变化

在 Coexistence 连接上，媒体处理方式与其他 Cloud API 连接完全相同，限制也相同。

唯一值得了解的差异是历史记录。首次连接时，Meta 会从 WhatsApp Business 应用同步近期消息，但同步内容是消息文字，并非完整的媒体归档。连接前的媒体仍在手机上，位置没有改变。

常见错误

• 因为提供链接看似更简单就这样做。Meta 的网络不是您的浏览器。
• 数小时后才获取入站媒体。媒体 ID 会过期。
• 未检查编解码器就导出视频。编辑软件的默认设置常常不受支持。

常见问题

继续阅读