Send LTO Coupon (WITH expiry date)

POST

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

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

LTO Template are Limited Time Offer Templated messages.

Request

Header Params

Body Params application/json

Example

{
    "whatsapp_number": "{{whatsapp_number}}",
    "type": "TEMPLATE",
    "to_whatsapp_number": "{{destination_number}}",
    "template": {
        "template_name": "-template-name-",
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                    "type": "image",
                        "image": {
                            "url": "-link-to-image" // optional
                        }
                    }
                ]
            },
            {
                "type": "limited_time_offer",
                "parameters": [
                    {
                        "type": "limited_time_offer",
                        "limited_time_offer": {
                            "expiration_time_ms": 1742925600000 // date in the future in unix timestamp
                        }
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "copy_code",
                "index": 0,
                "parameters": [
                    {
                        "type": "text",
                        "text": "1230" // payload of the copy code
                    }
                ]
            }
        ]   
    }
}

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": "TEMPLATE",
    "to_whatsapp_number": "{{destination_number}}",
    "template": {
        "template_name": "-template-name-",
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                    "type": "image",
                        "image": {
                            "url": "-link-to-image" // optional
                        }
                    }
                ]
            },
            {
                "type": "limited_time_offer",
                "parameters": [
                    {
                        "type": "limited_time_offer",
                        "limited_time_offer": {
                            "expiration_time_ms": 1742925600000 // date in the future in unix timestamp
                        }
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "copy_code",
                "index": 0,
                "parameters": [
                    {
                        "type": "text",
                        "text": "1230" // payload of the copy code
                    }
                ]
            }
        ]   
    }
}'

Responses

🟢201

application/json

Bodyapplication/json

Example

{
    "uuid": "994dd8a7-465b-4736-a8d4-383ca43d4e37",
    "type": "TEMPLATE",
    "status": "QUEUED",
    "status_description": "",
    "whatsapp_number": "<whatsapp_number>",
    "direction": "OUTBOUND",
    "from_whatsapp_number": "<whatsapp_number>",
    "to_whatsapp_number": "<destination_number>",
    "message_data": {
        "language_code": "en_GB",
        "template_name": "template_with_header_body",
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "image",
                        "image": {
                            "url": "link.to.image"
                        }
                    }
                ]
            },
            {
                "type": "limited_time_offer",
                "parameters": [
                    {
                        "type": "limited_time_offer",
                        "limited_time_offer": {
                            "expiration_time_ms": 1742925600000
                        }
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "copy_code",
                "index": 0,
                "parameters": [
                    {
                        "type": "text",
                        "text": "1230"
                    }
                ]
            }
        ]
    },
    "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 LTO Coupon Template (no expiry date)

Send Carousel Message Template