Meta Tech Provider
发送媒体:图片、视频、音频和文档
媒体文件有两种发送方式:先上传文件,再使用返回的 ID;或提供公开链接,让 Meta 获取文件。上传更可靠,而且不同类型的大小限制差异很大,容易被忽略。
EasyCoexistence 会将入站消息事件直接从 Meta 传送到您的端点,因此媒体 ID 能立即到达您的系统,并可在有效期内获取。
按类型划分的限制
每种类型都不同。超过限制会返回错误 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 会过期。
- 未检查编解码器就导出视频。编辑软件的默认设置常常不受支持。
使用 EasyCoexistence 完成这些操作
常见问题
我能发送的最大文件是多少?
100 MB,但仅适用于文档。视频和音频上限为 16 MB,图片上限为 5 MB。
我应该上传文件,还是发送 URL?
请上传文件。这样可排除可访问性问题这一失败原因。
媒体 ID 的有效期有多长?
不是永久有效,因此入站媒体应在事件到达后尽快获取。
连接时会同步旧媒体吗?
不会。历史同步只涵盖近期消息内容;连接前的媒体仍留在手机上。
继续阅读
发送互动消息:按钮和列表了解 WhatsApp 按钮和列表消息的限制,以及回复如何通过 Webhook 返回。WhatsApp 错误 131053:媒体上传失败了解错误 131053:媒体上传失败的原因,以及大小、格式和 URL 的排查方法。WhatsApp 错误 131052:媒体下载失败了解错误 131052 的原因,以及为何让客户重新发送通常就能解决。哪些内容会同步到 API,哪些不会联系人和一对一历史记录会同步;群组、目录、标签、快速回复和离开消息不会同步。完整清单尽在这里。messages Webhook客户发送的所有内容都会到达此字段。了解负载内容、确认方式,以及路由号码为何不会把消息送达服务商。
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间