Use this API to send a sticker messages.
Sticker messages display animated or static sticker images in a WhatsApp message.
Request Parameters
Key | Description | Values | Data Types | Required/Optional | Constraints |
---|---|---|---|---|---|
Authorization | Access Token for the application | {{PARTNER_APP_TOKEN}} | String | Required | Should be a valid Partner App Access Token. |
appId | App ID to fetch the access token | {{APP_ID}} | String | Required | The Id should be a valid app Id of Gupshup |
messaging_product | Messaging product | String | Required | ||
recipient_type | Recipient type | individual | String | Required | |
to | Destination phone no where the message need to be send | 91785876xxxx | String | Required | Must be a valid phone number. |
type | Messaging type | sticker | String | Required | Type should be sticker to send sticker message. |
sticker | Add sticker body | "sticker": { "id" : "798882015472548" } | Object | Required | Key should be sticker to send sticker message. |
Sample Request
curl --location --request POST 'https://partner.gupshup.io/partner/app/`{{APP_ID}}`/v3/message' \
--header 'Authorization: `{{PARTNER_APP_TOKEN}}`' \
--header 'Content-Type: application/json' \
--data-raw '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "`{{WHATSAPP_USER_PHONE_NUMBER}}`",
"type": "sticker",
"sticker": {
"id" : "`{{MEDIA_ID}}`"
}
}'
Sample Response
{
"messages": [
{
"id": "GUPSHUP_MESSAGE_ID"
}
],
"messaging_product": "whatsapp",
"contacts": [
{
"input": "DESTINATION_PHONE_NO",
"wa_id": "DESTINATION_PHONE_NO"
}
]
}
Status Codes
Status Code | Response | Comments |
---|---|---|
Success | ||
200 | { "messages": [ { "id": "GUPSHUP_MESSAGE_ID" } ], "messaging_product": "whatsapp", "contacts": [ { "input": "DESTINATION_PHONE_NO", "wa_id": "DESTINATION_PHONE_NO" } ] }` | |
Error | ||
401 | { "status": "error", "message": "Authentication Failed" }` | When API key authentication fails |
400 | { "message": "Callback Billing must be enabled for this API", "status": "error" }` | If Callback billing is not enabled for the app |
400 | { "message": "Invalid App Details", "status": "error" }` | If app details are not found |