SMS API

SMS APIs, send message via api

Json

{
  "contacts": ["2347046946264"],
  "sender_id": "LIBERTY",
  "message": "Hello Whisper is almost there",
  "send_date": "03-09-2021 00:42",
  "priority_route": false,
  "campaign_name": "Promotion 1"
}

JavaScript

var request = require('request');
var options = {
  'method': 'POST',
  'url': '${base_url}/api/send_message/',
  'headers': {
    'Authorization': 'Api_key ${api_key}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "contacts": [
      "2348093984569",
      "2349028906357",
      "2348142392255",
      "2349050151725"
    ],
    "sender_id": "WHISPER",
    "message": "Welcome to WHisperSMS.",
    "priority_route": false,
    "campaign_name": "API Docs"
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Python

import requests
import json

url = "{base_url}/api/send_message/"

payload = json.dumps({
  "contacts": [
    "2348093984569",
    "2349028906357",
    "2348142392255",
    "2349050151725"
  ],
  "sender_id": "WHISPER",
  "message": "Welcome to WHisperSMS.",
  "priority_route": False,
  "campaign_name": "API Docs"
})
headers = {
  'Authorization': 'Api_key {api_key}',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("{base_url}/api/send_message/")
  .header("Authorization", "Api_key {api_key}")
  .header("Content-Type", "application/json")
  .body("{\r\n\t\"contacts\": [\r\n\t\t\"2348093984569\",\r\n\t\t\"2349028906357\",\r\n\t\t\"2348142392255\",\r\n\t\t\"2349050151725\"\r\n\t],\r\n\t\"sender_id\": \"WHISPER\",\r\n\t\"message\": \"Welcome to WHisperSMS.\",\r\n\t\"priority_route\": false,\r\n\t\"campaign_name\": \"API Docs\"\r\n}")
  .asString();

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{{base_url}}/api/send_message/');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Authorization' => 'Api_key {{api_key}}',
  'Content-Type' => 'application/json'
));
$request->setBody('{
\n  "contacts": [
\n      "2348093984569",
\n      "2349028906357",
\n      "2348142392255",
\n      "2349050151725"
\n  ],
\n  "sender_id": "WHISPER",
\n  "message": "Welcome to WHisperSMS.",
\n  "priority_route": false,
\n  "campaign_name": "API Docs"
\n}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Dart

var headers = {
  'Authorization': 'Api_key {api_key}',
  'Content-Type': 'application/json'
};
var request = http.Request('POST', Uri.parse('{base_url}/api/send_message/'));
request.body = json.encode({
  "contacts": [
    "2348093984569",
    "2349028906357",
    "2348142392255",
    "2349050151725"
  ],
  "sender_id": "WHISPER",
  "message": "Welcome to WHisperSMS.",
  "priority_route": false,
  "campaign_name": "API Docs"
});
request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
}
else {
  print(response.reasonPhrase);
}

C#

var client = new RestClient("localhost:8000/api/send_message/");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Api_key {api_key}");
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"  ""contacts"": [
" + "\n" +
@"      ""2348093984569"",
" + "\n" +
@"      ""2349028906357"",
" + "\n" +
@"      ""2348142392255"",
" + "\n" +
@"      ""2349050151725""
" + "\n" +
@"  ],
" + "\n" +
@"  ""sender_id"": ""WHISPER"",
" + "\n" +
@"  ""message"": ""Welcome to WHisperSMS."",
" + "\n" +
@"  ""priority_route"": false,
" + "\n" +
@"  ""campaign_name"": ""API Docs""
" + "\n" +
@"}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Responses look like this

response

{
    "status": true,
    "message": "Successful",
    "data": {
        "data": "success",
        "message": "message queued",
        "details": {
            "was_successful": true,
            "message": "Okay",
            "cost": 10.0,
            "balance": 24805.0,
            "required": 0,
            "total_receivers": 4
        }
    },
    "errs": {}
}

caution

BaseUrl: https//whispersms.xyz

You can send messages from here: