接收 WhatsApp 贴纸

联系人从贴纸面板点选的贴纸会作为入站消息到达，携带 sticker：一个 WebP 文件引用，加上一个 animated 标志。

入站贴纸包含的内容

代码示例

{
  "id": "wam_01kye7t1rgyw9u5l8p2zaf7sid",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "sticker": {
    "id": "waf_01kye6r7as0zkv3g1q6suy9whc",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kye7t1rgyw9u5l8p2zaf7sid/media/waf_01kye6r7as0zkv3g1q6suy9whc",
    "mime_type": "image/webp",
    "animated": false
  },
  "created_at": "2026-08-25T09:19:37Z"
}

字段	包含的内容
id	已存储的文件，获取字节时作为 media_id 传入
url	一个 Bird URL，使用你的 API 密钥获取
mime_type	WhatsApp 报告的媒体类型，贴纸为 image/webp
animated	贴纸是否为动态；仅在入站贴纸上存在

该分支在任一方向都不携带标题文字，也没有贴纸或所属贴纸包的名称。贴纸就是整条消息。

animated 用于区分动态 WebP 和静态 WebP，当你自行渲染文件时这一点很重要：动态贴纸是多帧 WebP，静态图像渲染器会将其压平为第一帧。

获取字节数据

将消息 ID 和媒体 id 传入渠道的媒体方法。Hub 的获取入站媒体涵盖了该调用的所有语言示例，以及它遵循的重定向和请求头规则，并管理文件所在的保留时间窗口。

大多数集成从不获取贴纸。贴纸通常传达的是情感而非信息，因此客服收件箱可以显示占位符，自动化流程可以将该消息视为重置窗口的确认，而无需下载任何内容。

Webhook 载荷

whatsapp.received 在事件信封上携带 sticker 分支：