Sticker messages display animated or static sticker images in a WhatsApp message.
Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send a sticker message to a WhatsApp user.
POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "{{wa-user-phone-number}}", "type": "sticker", "sticker": { "id" : "<MEDIA_ID>" } }
Placeholder | Description | Example Value |
---|---|---|
String | Required if using an uploaded media asset (recommended). Uploaded media asset ID. |
|
String | Required if linking to your media asset (not recommended) URL of sticker asset on your public server. For better performance, we recommend that you upload your media asset instead. |
|
String | Required. WhatsApp user phone number. |
|
Sticker Type | Extension | MIME Type | Max Size |
---|---|---|---|
Animated sticker | .webp | image/webp | 500 KB |
Static sticker | .webp | image/webp | 100 KB |
Example request to send an animated sticker image to a WhatsApp user.
curl 'https://graph.facebook.com/v20.0
/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "+16505551234",
"type": "sticker",
"sticker": {
"id" : "798882015472548"
}
}'
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }