功能简介
Media API 通过 WhatsApp Business API 上传图片、视频、音频文件、贴纸或文档。返回的媒体 ID 可供后续的 WhatsApp 消息请求引用。准备工作
- 连接并注册发送方 WhatsApp 电话号码。
- 妥善保管您的 YCloud API 密钥。
- 准备符合 Meta 支持的媒体类型和大小限制的文件。
- 了解目标消息类型是支持媒体 ID 还是需要 URL。
工作原理
- 针对发送电话号码上传文件。
- 保存返回的媒体 ID。
- 将媒体 ID 放入匹配的 WhatsApp 消息内容对象中。
- 在上传的媒体过期前发送消息。
请求
POST /whatsapp/media/{phoneNumber}/upload
以 multipart/form-data 格式发送文件。
响应
id 并将其用于受支持的 WhatsApp 消息请求的媒体对象中。
媒体使用
媒体 ID 与 WhatsApp 媒体存储绑定，并会在 30 天后过期。当 ID 不再有效时，请重新上传。 互动消息标头中的图片、文档、视频或音频无法使用媒体 ID。请对这些标头元素使用可公开访问的链接。限制与问题排查
- 上传文件时随附正确的 MIME 类型。
- 上传前请检查 Meta 支持的媒体类型和大小限制。
- 不要重复使用已过期的媒体 ID。
- 确保上传和消息发送方的电话号码保持一致。
- 对于可重复使用的公开素材，在消息结构支持的情况下， 使用链接可能比重复上传更简单。
上传媒体 API
查看 multipart 请求和响应架构。
发送媒体消息
将返回的媒体 ID 添加到 WhatsApp 消息请求中。