Bulk SMS

Legacy APIs - SMS
Starting a new integration? This is a legacy API. It stays available for existing integrations, but new integrations should use the SMS V3 APIs.

Send a different message to each phone number in one request.

POSThttps://telcomw.com/api-v2/send

Send the parameters as form-data. This is the same /send call, with advance set to true.

Parameters

Parameter Required Description
api_key YES Your API key.
password YES Your account password.
text YES A JSON object of phone number and message, for example {"099xxxxxxx":"Hello message 1","088xxxxxxx":"Hello message 2"}.
numbers YES true (or null).
from YES The sender ID, for example WGIT.
advance YES true. It tells the API that text holds a message for each number.

Example request

curl --location --request POST 'https://telcomw.com/api-v2/send' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'password=YOUR_PASSWORD' \
  --data-urlencode 'text={"099xxxxxxx":"Hello message 1","088xxxxxxx":"Hello message 2"}' \
  --data-urlencode 'numbers=true' \
  --data-urlencode 'from=WGIT' \
  --data-urlencode 'advance=true'
curl --location --request POST "https://telcomw.com/api-v2/send" ^
  --data-urlencode "api_key=YOUR_API_KEY" ^
  --data-urlencode "password=YOUR_PASSWORD" ^
  --data-urlencode "text={\"099xxxxxxx\":\"Hello message 1\",\"088xxxxxxx\":\"Hello message 2\"}" ^
  --data-urlencode "numbers=true" ^
  --data-urlencode "from=WGIT" ^
  --data-urlencode "advance=true"
<?php

$data = [
    'api_key' => 'YOUR_API_KEY',
    'password' => 'YOUR_PASSWORD',
    'text' => '{"099xxxxxxx":"Hello message 1","088xxxxxxx":"Hello message 2"}',
    'numbers' => 'true',
    'from' => 'WGIT',
    'advance' => 'true'
];

$ch = curl_init('https://telcomw.com/api-v2/send');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));
const axios = require('axios');

axios.request({
  method: 'post',
  url: 'https://telcomw.com/api-v2/send',
  data: new URLSearchParams({
    'api_key': 'YOUR_API_KEY',
    'password': 'YOUR_PASSWORD',
    'text': '{"099xxxxxxx":"Hello message 1","088xxxxxxx":"Hello message 2"}',
    'numbers': 'true',
    'from': 'WGIT',
    'advance': 'true'
  })
}).then((res) => console.log(res.data))
  .catch((err) => console.error(err.response ? err.response.data : err.message));
import requests

data = {
    'api_key': 'YOUR_API_KEY',
    'password': 'YOUR_PASSWORD',
    'text': '{"099xxxxxxx":"Hello message 1","088xxxxxxx":"Hello message 2"}',
    'numbers': 'true',
    'from': 'WGIT',
    'advance': 'true'
}

response = requests.request('POST', 'https://telcomw.com/api-v2/send', data=data)
print(response.json())

Response

The response is JSON.

{
  "type": "success",
  "msg": "send",
  "code": "200",
  "feedback": [
    {
      "status": 2,
      "cost": 18,
      "msdn": "265884113450",
      "chars": 12,
      "code": 200,
      "id": "ke4wz6fydbtj"
    }
  ]
}

Good to know

  • The response has the same fields as Send SMS.