Send a link button
curl --request POST \
--url https://api.getreply.in/v1/messages/link-button \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"to": "+9198250*****",
"body": "Track your order here.",
"button_text": "Track order",
"url": "https://example.com/track/4521"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '+9198250*****',
body: JSON.stringify('Track your order here.'),
button_text: 'Track order',
url: 'https://example.com/track/4521'
})
};
fetch('https://api.getreply.in/v1/messages/link-button', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getreply.in/v1/messages/link-button",
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([
'to' => '+9198250*****',
'body' => 'Track your order here.',
'button_text' => 'Track order',
'url' => 'https://example.com/track/4521'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://api.getreply.in/v1/messages/link-button"
payload = {
"to": "+9198250*****",
"body": "Track your order here.",
"button_text": "Track order",
"url": "https://example.com/track/4521"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "<string>",
"status": "<string>",
"to": "<string>",
"customer": {
"phone": "<string>",
"user_id": "<string>",
"username": "<string>"
},
"country": "<string>",
"category": "<string>",
"price": "<string>",
"reference": "<string>"
}Messages
Send a link button
Sends text with one button that opens a link, inside the 24-hour window. Body at most 1024 characters, button text 20, header and footer 60.
Permission: A Full or Send only key.
POST
/
v1
/
messages
/
link-button
Send a link button
curl --request POST \
--url https://api.getreply.in/v1/messages/link-button \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"to": "+9198250*****",
"body": "Track your order here.",
"button_text": "Track order",
"url": "https://example.com/track/4521"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '+9198250*****',
body: JSON.stringify('Track your order here.'),
button_text: 'Track order',
url: 'https://example.com/track/4521'
})
};
fetch('https://api.getreply.in/v1/messages/link-button', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getreply.in/v1/messages/link-button",
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([
'to' => '+9198250*****',
'body' => 'Track your order here.',
'button_text' => 'Track order',
'url' => 'https://example.com/track/4521'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://api.getreply.in/v1/messages/link-button"
payload = {
"to": "+9198250*****",
"body": "Track your order here.",
"button_text": "Track order",
"url": "https://example.com/track/4521"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "<string>",
"status": "<string>",
"to": "<string>",
"customer": {
"phone": "<string>",
"user_id": "<string>",
"username": "<string>"
},
"country": "<string>",
"category": "<string>",
"price": "<string>",
"reference": "<string>"
}Authorizations
Your API key, e.g. gr_live_…
Headers
Your own unique id for this request (at most 255 characters). The same id and body within 24 hours answers the first answer again — never a second send or charge.
Maximum string length:
255Body
application/json
The person's WhatsApp number with its country code, e.g. +9198250***** — or their WhatsApp username id (e.g. "IN.1626…"; see Customer).
The message text.
Maximum string length:
1024What the button says.
Maximum string length:
20The link the button opens (https).
Your own reference for this message (at most 512 characters). It comes back on the message and its webhooks.
Maximum string length:
512A text header.
Maximum string length:
60A footer.
Maximum string length:
60The id of a message to quote.
Response
Accepted for sending.
Who the customer is. phone can be null: a customer who uses a WhatsApp username may not share their number. user_id is WhatsApp's business-scoped user ID (for example "IN.13491208655302741918").
Show child attributes
Show child attributes