Send Interactive Buttons

curl --request POST \
  --url https://api.flowiq.live/send-whatsapp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "+27123456789",
  "message_type": "interactive",
  "interactive": {
    "type": "button",
    "body": "<string>",
    "buttons": [
      {
        "id": "<string>",
        "title": "<string>"
      }
    ],
    "header": "<string>",
    "footer": "<string>",
    "header_media": {
      "url": "<string>",
      "filename": "<string>"
    }
  },
  "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
'

import requests

url = "https://api.flowiq.live/send-whatsapp"

payload = {
    "phone_number": "+27123456789",
    "message_type": "interactive",
    "interactive": {
        "type": "button",
        "body": "<string>",
        "buttons": [
            {
                "id": "<string>",
                "title": "<string>"
            }
        ],
        "header": "<string>",
        "footer": "<string>",
        "header_media": {
            "url": "<string>",
            "filename": "<string>"
        }
    },
    "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phone_number: '+27123456789',
    message_type: 'interactive',
    interactive: {
      type: 'button',
      body: JSON.stringify('<string>'),
      buttons: [{id: '<string>', title: '<string>'}],
      header: '<string>',
      footer: '<string>',
      header_media: {url: '<string>', filename: '<string>'}
    },
    context_message_id: 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  })
};

fetch('https://api.flowiq.live/send-whatsapp', 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.flowiq.live/send-whatsapp",
  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_number' => '+27123456789',
    'message_type' => 'interactive',
    'interactive' => [
        'type' => 'button',
        'body' => '<string>',
        'buttons' => [
                [
                                'id' => '<string>',
                                'title' => '<string>'
                ]
        ],
        'header' => '<string>',
        'footer' => '<string>',
        'header_media' => [
                'url' => '<string>',
                'filename' => '<string>'
        ]
    ],
    'context_message_id' => 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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 := "https://api.flowiq.live/send-whatsapp"

	payload := strings.NewReader("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"button\",\n    \"body\": \"<string>\",\n    \"buttons\": [\n      {\n        \"id\": \"<string>\",\n        \"title\": \"<string>\"\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\",\n    \"header_media\": {\n      \"url\": \"<string>\",\n      \"filename\": \"<string>\"\n    }\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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("https://api.flowiq.live/send-whatsapp")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"button\",\n    \"body\": \"<string>\",\n    \"buttons\": [\n      {\n        \"id\": \"<string>\",\n        \"title\": \"<string>\"\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\",\n    \"header_media\": {\n      \"url\": \"<string>\",\n      \"filename\": \"<string>\"\n    }\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flowiq.live/send-whatsapp")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"button\",\n    \"body\": \"<string>\",\n    \"buttons\": [\n      {\n        \"id\": \"<string>\",\n        \"title\": \"<string>\"\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\",\n    \"header_media\": {\n      \"url\": \"<string>\",\n      \"filename\": \"<string>\"\n    }\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...",
    "recipient": "27123456789",
    "message_type": "<string>"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

send-whatsapp

Send Interactive Buttons

curl --request POST \
  --url https://api.flowiq.live/send-whatsapp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "+27123456789",
  "message_type": "interactive",
  "interactive": {
    "type": "button",
    "body": "<string>",
    "buttons": [
      {
        "id": "<string>",
        "title": "<string>"
      }
    ],
    "header": "<string>",
    "footer": "<string>",
    "header_media": {
      "url": "<string>",
      "filename": "<string>"
    }
  },
  "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
'

import requests

url = "https://api.flowiq.live/send-whatsapp"

payload = {
    "phone_number": "+27123456789",
    "message_type": "interactive",
    "interactive": {
        "type": "button",
        "body": "<string>",
        "buttons": [
            {
                "id": "<string>",
                "title": "<string>"
            }
        ],
        "header": "<string>",
        "footer": "<string>",
        "header_media": {
            "url": "<string>",
            "filename": "<string>"
        }
    },
    "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phone_number: '+27123456789',
    message_type: 'interactive',
    interactive: {
      type: 'button',
      body: JSON.stringify('<string>'),
      buttons: [{id: '<string>', title: '<string>'}],
      header: '<string>',
      footer: '<string>',
      header_media: {url: '<string>', filename: '<string>'}
    },
    context_message_id: 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  })
};

fetch('https://api.flowiq.live/send-whatsapp', 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.flowiq.live/send-whatsapp",
  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_number' => '+27123456789',
    'message_type' => 'interactive',
    'interactive' => [
        'type' => 'button',
        'body' => '<string>',
        'buttons' => [
                [
                                'id' => '<string>',
                                'title' => '<string>'
                ]
        ],
        'header' => '<string>',
        'footer' => '<string>',
        'header_media' => [
                'url' => '<string>',
                'filename' => '<string>'
        ]
    ],
    'context_message_id' => 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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 := "https://api.flowiq.live/send-whatsapp"

	payload := strings.NewReader("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"button\",\n    \"body\": \"<string>\",\n    \"buttons\": [\n      {\n        \"id\": \"<string>\",\n        \"title\": \"<string>\"\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\",\n    \"header_media\": {\n      \"url\": \"<string>\",\n      \"filename\": \"<string>\"\n    }\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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("https://api.flowiq.live/send-whatsapp")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"button\",\n    \"body\": \"<string>\",\n    \"buttons\": [\n      {\n        \"id\": \"<string>\",\n        \"title\": \"<string>\"\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\",\n    \"header_media\": {\n      \"url\": \"<string>\",\n      \"filename\": \"<string>\"\n    }\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flowiq.live/send-whatsapp")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"button\",\n    \"body\": \"<string>\",\n    \"buttons\": [\n      {\n        \"id\": \"<string>\",\n        \"title\": \"<string>\"\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\",\n    \"header_media\": {\n      \"url\": \"<string>\",\n      \"filename\": \"<string>\"\n    }\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...",
    "recipient": "27123456789",
    "message_type": "<string>"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Basic Usage

curl -X POST "https://api.flowiq.live/send-whatsapp" \
  -H "Authorization: Bearer fiq_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+27123456789",
    "message_type": "interactive",
    "interactive": {
      "type": "button",
      "header": "Order Confirmation",
      "body": "Would you like to confirm your order #12345?",
      "footer": "Reply within 24 hours",
      "buttons": [
        { "id": "confirm", "title": "Confirm" },
        { "id": "cancel", "title": "Cancel" },
        { "id": "modify", "title": "Modify Order" }
      ]
    }
  }'

With Image Header

curl -X POST "https://api.flowiq.live/send-whatsapp" \
  -H "Authorization: Bearer fiq_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+27123456789",
    "message_type": "interactive",
    "interactive": {
      "type": "button",
      "body": "Check out our new product!",
      "header_media": { "type": "image", "url": "https://example.com/product.jpg" },
      "buttons": [
        { "id": "buy", "title": "Buy Now" },
        { "id": "info", "title": "More Info" }
      ]
    }
  }'

Request Body

Field	Type	Required	Description
`phone_number`	string	Yes	Recipient phone number with country code
`message_type`	string	Yes	Must be `"interactive"`
`interactive.type`	string	Yes	Must be `"button"`
`interactive.body`	string	Yes	Main message text (max 1024 chars)
`interactive.header`	string	No	Header text (max 60 chars)
`interactive.footer`	string	No	Footer text (max 60 chars)
`interactive.buttons`	array	Yes	Array of button objects — max 3
`interactive.buttons[].id`	string	No	Unique button ID returned on tap (auto-generated if omitted)
`interactive.buttons[].title`	string	Yes	Button label (max 20 chars)
`interactive.header_media`	object	No	Media header — `type`, `url`, and optional `filename` for documents
`context_message_id`	string	No	WhatsApp message ID to reply to

Button titles are limited to 20 characters. Maximum 3 buttons per message.

{
  "phone_number": "+27123456789",
  "message_type": "interactive",
  "interactive": {
    "type": "button",
    "body": "Would you like to confirm your order?",
    "buttons": [
      { "id": "confirm", "title": "Confirm" },
      { "id": "cancel", "title": "Cancel" }
    ]
  }
}

Response

Success (200)

{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...",
    "recipient": "27123456789",
    "message_type": "interactive"
  }
}

Error: Missing Required Field (400)

{
  "error": "Missing required field",
  "message": "interactive.body and interactive.buttons are required for button messages"
}

Integration Example

async function sendInteractiveButtons(apiKey, phoneNumber, interactive) {
  const response = await fetch(
    `https://api.flowiq.live/send-whatsapp`,
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${apiKey}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ phone_number: phoneNumber, message_type: "interactive", interactive }),
    }
  );
  const data = await response.json();
  if (!response.ok) throw new Error(data.message);
  return data;
}

Authorizations

Authorization

string

header

required

Bearer token for authentication. Format: Bearer YOUR_BEARER_TOKEN

Body

application/json

phone_number

string

required

Recipient phone number with country code

Example:

"+27123456789"

message_type

enum<string>

required

Must be "interactive"

Available options:

interactive

Example:

"interactive"

interactive

object

required

Interactive button message configuration

Show child attributes

context_message_id

string

WhatsApp message ID to reply to

Example:

"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."

Response

Message sent successfully

success

boolean

Example:

true

message

string

Example:

"Message sent successfully"

data

object

Show child attributes

Send Contact Card Send Interactive List

Getting Started

Webhooks

Endpoints

Send Interactive Buttons

Basic Usage

With Image Header

Request Body

Response

Success (200)

Error: Missing Required Field (400)

Integration Example

Authorizations

Body

Response

​Basic Usage

​With Image Header

​Request Body

​Response

​Success (200)

​Error: Missing Required Field (400)

​Integration Example

Authorizations

Body

Response

Basic Usage

With Image Header

Request Body

Response

Success (200)

Error: Missing Required Field (400)

Integration Example