Send Interactive Message

POST

https://getrasl.io/api/v2/messages/interactive

Send an interactive message (buttons or list) via WhatsApp

📌

Important | 24-Hour Customer (Service Window)
Interactive messages are subject to Meta's customer service window policy. You can only send free-form text messages within 24 hours of the customer's last message to your business. This window starts or refreshes whenever the customer messages or calls you. After this 24-hour window expires, the message will not be delivered. Use approved template messages for communication beyond the 24-hour window.

Required Scope

messages:send

Auto-Contact Creation

If no contact_id is provided and the phone number doesn't match an existing contact:

A new contact is auto-created with the phone number

Requires default lead status, source, and assignee configured in Application settings

Subject to the tenant's contact limit (returns FEATURE_LIMIT_EXCEEDED if exceeded)

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Send Button MessageSend List Message

{
    "phone": "201XXXXXXXXX",
    "type": "button",
    "body_text": "",
    "header_text": "",
    "footer_text": "",
    "contact_id": 123,
    "buttons": [
        {
            "id": "",
            "title": ""
        },
        {
            "id": "",
            "title": ""
        },
        {
            "id": "",
            "title": ""
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Send Button MessageSend List Message

curl --location --request POST 'https://getrasl.io/api/v2/messages/interactive' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone": "201XXXXXXXXX",
    "type": "button",
    "body_text": "",
    "header_text": "",
    "footer_text": "",
    "contact_id": 123,
    "buttons": [
        {
            "id": "",
            "title": ""
        },
        {
            "id": "",
            "title": ""
        },
        {
            "id": "",
            "title": ""
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "success": true,
    "data": {
        "message_id": "string",
        "contact_id": 0,
        "phone": "string",
        "type": "button",
        "status": "string",
        "sent_at": "string",
        "chat_id": 0,
        "chat_message_id": 0
    },
    "meta": {
        "request_id": "string",
        "timestamp": "string"
    }
}

🟠401UNAUTHORIZED

🟠403INSUFFICIENT_SCOPE

🟠403FEATURE_LIMIT_EXCEEDED

🟠404NOT_FOUND

🟠422VALIDATION_ERROR

🟠422WHATSAPP_NOT_CONFIGURED

🟠429RATE_LIMIT_EXCEEDED

🔴500INTERNAL_ERROR

🔴500MESSAGE_SEND_FAILED

Send Template Message

List Messages