媒体

/v1/media

使用 media 节点上传、检索或删除媒体。

连线

以下连线会连接至此节点：

准备工作

在您发送媒体消息后，该媒体会在 WhatsApp 服务器上存储 14 天。如果用户在 14 天后请求下载该媒体，WhatsApp 服务器会向 WhatsApp Business 本地客户端请求相同的媒体文件。如果该媒体已被移除，则系统会通知用户无法获取该媒体。

仅凭已发送和已读回执假定用户已下载媒体并非安全做法。通常，在 30 天后移除传出媒体比较保险，但您应该采用最适合您企业的策略。

限制

• 如果您使用媒体上传流程而不是链接到媒体网址，则必须将文件上传至媒体卷。上传完成后，您可以使用媒体编号发送消息。
• 应用程序会先处理已上传的媒体，之后再将其发送到服务器。上传至 media 节点的媒体文件大小上限为 100 MB，但下方处理后的媒体大小表格中还列出了各种媒体类型的处理后大小限制。
• 媒体存储需由企业处理。如果媒体卷已满，则您将无法发送消息。
• 不支持：

  • 通过字节流发送媒体。
  • 发送附带动画贴纸的消息。

上传

向 /v1/media 发送 POST 请求，以上传媒体。本地请求的正文必须包含二进制媒体数据，并且必须将 Content-Type 标头设置为待上传媒体的类型。请参阅支持的内容类型部分，了解支持的选项。

上传二进制数据的标准方法是在 POST HTTP 请求中发送二进制数据。例如，如果您想上传图像，则可以在负载中加入实际图像的字节，然后发出 POST 请求。或者，如果您希望 cURL 按照给定的二进制形式读取和使用给定文件，则可以使用 --data-binary。

示例

上传媒体：

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

使用 cURL 上传媒体：

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

在这两种情况下，如果请求成功，响应都会返回 id 字段，您在检索媒体或向客户发送媒体消息时将需要用到该字段。

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

如果收到错误消息，请参阅错误和状态消息以了解更多信息。

支持的内容类型

处理后的媒体大小

这是经过压缩加密后所允许的媒体文件大小上限。

常见问题

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

详细了解

• 最佳实践
• 消息
• 参考文档