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 |
|
String |
Required |
Should be a valid Partner App Access Token. |
APP ID |
App ID to fetch the access token |
|
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 |
|
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 |
|
Object |
Required |
Key should be |
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 |