Send Interactive Quick Reply Message + Media Header

POST

https://api.sudonum.com.com/v2/whatsapp/messages/

This allows you to send a WhatsApp Message from your WhatsApp number.

Note: The title of each options should not exceed 24 characters.

Request

Header Params

Body Params application/json

Example

{
    "whatsapp_number": "{{whatsapp_number}}",
    "type": "INTERACTIVE",
    "to_whatsapp_number": "{{destination_number}}",
    "content": {
        "header": {
            "type": "image",
            "image": {
                "url": "http://url.to.image.jpg"
            }
        },
        "body": {
            "text": "Choose one of the options below"
        },
        "type": "button",
        "action": {
            "buttons": [
                {
                    "type": "reply",
                    "reply": { // <-- required a reply object
                        "id": "unique-postback-id",
                        "title": "First Button’s Title" 
                    }
                },
                {
                    "type": "reply",
                    "reply": { // <-- required a reply object
                        "id": "unique-postback-id",
                        "title": "2nd Button’s Title" 
                    }
                }
            ]
        },
        "footer": {
            "text": "Footer text"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.sudonum.com.com/v2/whatsapp/messages/' \
--header 'Content-Type: application/json' \
--data '{
    "whatsapp_number": "{{whatsapp_number}}",
    "type": "INTERACTIVE",
    "to_whatsapp_number": "{{destination_number}}",
    "content": {
        "header": {
            "type": "image",
            "image": {
                "url": "http://url.to.image.jpg"
            }
        },
        "body": {
            "text": "Choose one of the options below"
        },
        "type": "button",
        "action": {
            "buttons": [
                {
                    "type": "reply",
                    "reply": { // <-- required a reply object
                        "id": "unique-postback-id",
                        "title": "First Button’s Title" 
                    }
                },
                {
                    "type": "reply",
                    "reply": { // <-- required a reply object
                        "id": "unique-postback-id",
                        "title": "2nd Button’s Title" 
                    }
                }
            ]
        },
        "footer": {
            "text": "Footer text"
        }
    }
}'

Responses

🟢201

application/json

Bodyapplication/json

Example

{
    "uuid": "994dd8a7-465b-4736-a8d4-383ca43d4e37",
    "type": "INTERACTIVE",
    "status": "QUEUED",
    "status_description": "",
    "whatsapp_number": "<whatsapp_number>",
    "direction": "OUTBOUND",
    "from_whatsapp_number": "<whatsapp_number>",
    "to_whatsapp_number": "<destination_number>",
        "message_data": {
        "account_number": "<whatsapp_number>",
        "content": {
            "type": "button",
            "header": {
                "type": "image",
                "image": {
                    "url": "http://url.to.image.jpg"
                }
            },
            "body": {
                "text": "your-text-message-content"
            },
            "footer": {
                "text": "your-footer- dntent"
            },
            "action": {
                "button": "cta-button-content",
                "buttons": [
                    {
                        "type": "reply",
                        "reply": {
                            "id": "unique-postback-id",
                            "title": "First Button’s Title"
                        }
                    },
                    {
                        "type": "reply",
                        "reply": {
                            "id": "unique-postback-id-2",
                            "title": "Second B"
                        }
                    }
                ]
            }
        },
        "interactive_type": "button"
    },
    "meta_data": {},
    "context_data": {},
    "created": "2024-06-28T14:19:33.614447Z",
    "modified": "2024-06-28T14:19:33.627059Z"
}

Modified at 2026-08-31 07:42:46

Send Interactive Quick Reply Message

Send Interactive Call-To-Action Message