Send an experimental interactive message
curl --request POST \
--url http://localhost:3000/send/interactive \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "628123456789",
"body": "Confirm your order?",
"buttons": [
{
"name": "quick_reply",
"params": {
"display_text": "Confirm",
"id": "confirm"
}
}
]
}
'import requests
url = "http://localhost:3000/send/interactive"
payload = {
"phone": "628123456789",
"body": "Confirm your order?",
"buttons": [
{
"name": "quick_reply",
"params": {
"display_text": "Confirm",
"id": "confirm"
}
}
]
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phone: '628123456789',
body: JSON.stringify('Confirm your order?'),
buttons: [{name: 'quick_reply', params: {display_text: 'Confirm', id: 'confirm'}}]
})
};
fetch('http://localhost:3000/send/interactive', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/send/interactive",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone' => '628123456789',
'body' => 'Confirm your order?',
'buttons' => [
[
'name' => 'quick_reply',
'params' => [
'display_text' => 'Confirm',
'id' => 'confirm'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:3000/send/interactive"
payload := strings.NewReader("{\n \"phone\": \"628123456789\",\n \"body\": \"Confirm your order?\",\n \"buttons\": [\n {\n \"name\": \"quick_reply\",\n \"params\": {\n \"display_text\": \"Confirm\",\n \"id\": \"confirm\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://localhost:3000/send/interactive")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"phone\": \"628123456789\",\n \"body\": \"Confirm your order?\",\n \"buttons\": [\n {\n \"name\": \"quick_reply\",\n \"params\": {\n \"display_text\": \"Confirm\",\n \"id\": \"confirm\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/send/interactive")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone\": \"628123456789\",\n \"body\": \"Confirm your order?\",\n \"buttons\": [\n {\n \"name\": \"quick_reply\",\n \"params\": {\n \"display_text\": \"Confirm\",\n \"id\": \"confirm\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": "SUCCESS",
"message": "Success",
"results": {
"message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
"status": "<feature> success ....",
"schedule_id": "0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10",
"scheduled_at": "2026-10-01T02:00:00Z",
"next_run_at": "2026-10-01T02:00:00Z"
}
}{
"code": 400,
"message": "field cannot be blank",
"results": null
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "you are not loggin",
"results": null
}send
Send an experimental interactive message
Immediate-only REST send for native-flow buttons, selection lists, location requests, and carousels. Not supported by scheduled sends or MCP. Uses an unofficial protocol; API success does not guarantee recipient rendering or delivery. Accepts individual user or group recipients only. Provide either buttons or cards. Overall HTTP body limits also apply.
POST
/
send
/
interactive
Send an experimental interactive message
curl --request POST \
--url http://localhost:3000/send/interactive \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "628123456789",
"body": "Confirm your order?",
"buttons": [
{
"name": "quick_reply",
"params": {
"display_text": "Confirm",
"id": "confirm"
}
}
]
}
'import requests
url = "http://localhost:3000/send/interactive"
payload = {
"phone": "628123456789",
"body": "Confirm your order?",
"buttons": [
{
"name": "quick_reply",
"params": {
"display_text": "Confirm",
"id": "confirm"
}
}
]
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phone: '628123456789',
body: JSON.stringify('Confirm your order?'),
buttons: [{name: 'quick_reply', params: {display_text: 'Confirm', id: 'confirm'}}]
})
};
fetch('http://localhost:3000/send/interactive', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/send/interactive",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone' => '628123456789',
'body' => 'Confirm your order?',
'buttons' => [
[
'name' => 'quick_reply',
'params' => [
'display_text' => 'Confirm',
'id' => 'confirm'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:3000/send/interactive"
payload := strings.NewReader("{\n \"phone\": \"628123456789\",\n \"body\": \"Confirm your order?\",\n \"buttons\": [\n {\n \"name\": \"quick_reply\",\n \"params\": {\n \"display_text\": \"Confirm\",\n \"id\": \"confirm\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://localhost:3000/send/interactive")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"phone\": \"628123456789\",\n \"body\": \"Confirm your order?\",\n \"buttons\": [\n {\n \"name\": \"quick_reply\",\n \"params\": {\n \"display_text\": \"Confirm\",\n \"id\": \"confirm\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/send/interactive")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone\": \"628123456789\",\n \"body\": \"Confirm your order?\",\n \"buttons\": [\n {\n \"name\": \"quick_reply\",\n \"params\": {\n \"display_text\": \"Confirm\",\n \"id\": \"confirm\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": "SUCCESS",
"message": "Success",
"results": {
"message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
"status": "<feature> success ....",
"schedule_id": "0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10",
"scheduled_at": "2026-10-01T02:00:00Z",
"next_run_at": "2026-10-01T02:00:00Z"
}
}{
"code": 400,
"message": "field cannot be blank",
"results": null
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "you are not loggin",
"results": null
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Headers
Device identifier for multi-device support. Required when multiple devices are registered.
If only one device is registered, it will be used as the default.
Can also be provided as device_id query parameter.
Example:
"my-device-id"
Body
application/json
- Option 1
- Option 2
Phone number or full individual user or group JID.
Required nonblank text, maximum 4096 bytes.
Required array length:
1 - 10 elementsShow child attributes
Show child attributes
Maximum 256 bytes.
Required array length:
2 - 10 elementsShow child attributes
Show child attributes