By using a SMS API service you can send a single message which you can get the status of messages instantly.

An API built to Deliver messages in a quick action, we also offer custom API’s to fit our customers needs and requirements.

Single Message URL:

https://valuetext.io/valuetext/rest/message/single/rest

Method:

GET

Parameters:

Headers:

“APIKEY” and “SECRETKEY” are the authentication protocols we use. For Authentication – header values have to be set as below:

• apiKey : myApiKey
• secretKey : mySecretKey

To Find the “APIKEY” and “SECRETKEY” of your account, login to www.valuetext.io -> click on your name -> click on Settings

Sample Request:

https://valuetext.io/valuetext/rest/message/single/rest?mobileNumber=918019350891&sms=Dear%20Nancy%2C%20your%20payment%20is%20successful&senderId=VLUTXT&clientId=879635

Important Note: The body (sms) of the message must be URL Encoded and UTF-8 CharSet for Single SMS API.

Sample Response:

{

“balance”: 0.9151,

“result”: [{

“sms”: “Dear Nancy, your payment is successful”,

“senderId”: “VLUTXT”,

“smsId”: “VT-456-1481563405645”,

“statusCode”: 7003,

“statusMsg”: “Delivered”,

“statusDescription”: “Message delivered successfully”,

“mobileNumber”: “91-xxx-xxx-xx”,

“clientId”: “123”,

“messageCount”: 1,

“messageCost”: 0.0012

}]}

Know about Response parameters & Status Codes

Bulk SMS API

By using the Bulk SMS API service you can send list of messages in a single call.

An API built to Deliver messages in quick fashion, we also offer custom API’s to fit our customers needs and requirements.

Bulk Messages URL:

https://valuetext.io/valuetext/rest/message/bulk/rest

Method:

POST

Parameters:

The following table shows the parameters you use in the request

Headers:

Supported Content Type based on request type you are sending

• content-type: application/jsonAuthentication Parameters:

“APIKEY” and “SECRETKEY” are the authentication parameters for calls to ValueText API. For Authentication – header values have to be set as below:

• apiKey : myApiKey
• secretKey : mySecretKey

To Find the “APIKEY” and “SECRETKEY” of your account, login to www.valuetext.io -> click on your name -> click on Settings

Sample request with content-type: application/json

[

   {

     “sms”: “Dear Avinash, Thank you for your payment.”,

     “senderId”: “VluTxt”,

     “mobileNumber”: “91xxxxxxxxx”,

     “clientId”: “123454b”,

     “deliveryModes” : “SMS”

   },

   {

     “sms”: “Dear Nancy, Thank you for your payment.”,

     “senderId”: “VluTxt”,

     “mobileNumber”: “91xxxxxxxx”,

     “clientId”: “”,

   “deliveryModes”:”WHATSAPP”

   }

]

Possible values for deliveryModes

you can pass “SMS”, “WHATSAPP” OR “WHATSAPP,SMS” 

“WHATSAPP,SMS” – It will try to send WhatApp if customer not using or WA filed then SMS will be sent.

Sample Response:

The response comes in JSON format only.

{
“balance”: “0.9018”,
“result”:
[
  {
   “sms”: “Dear Avinash, Thank you for your payment.”,
   “senderId”: “VluTxt”,
   “smsId”: “VT-499-1481622882333”,
   “statusCode”: “7001”,
   “statusMsg”: “Queued “,
   “statusDescription”: “Placed your request”,
   “mobileNumber”: “91-xxxxxxxxxx”,
   “clientId”: “123454b”,
   “messageCount”: “1”,
   “messageCost”: “0.0019”
  },
  {
   “sms”: “Dear Nancy, Thank you for your payment.”,
   “senderId”: “VluTxt”,
   “smsId”: “VT-853-1481622882332”,
   “statusCode”: “7001”,
   “statusMsg”: “Queued “,
   “statusDescription”: “Placed your request”,
   “mobileNumber”: “91-xxxxxxxxx”,
   “clientId”: “”,
   “messageCount”: “1”,
   “messageCost”: “0.0019”
  }
]
}

The response contains the following Parameter:

statusCode, status & statusMsg:

Possible values for statusCode, Status & statusMsg at response:

Setup Webhook

ValueText will sent HTTP (POST) request to Webhook to receive updated status about the messages.

You can configure your Webhook at setting page after you login.

Sample Webhook Request

[
  {
   “sms”: “Dear Avinash, Thank you for your payment.”,
   “senderId”: “VluTxt”,
   “smsId”: “VT-499-1481622882333”,
   “statusCode”: “7003”,
   “statusMsg”: “Delivered “,
   “statusDescription”: “Message delivered successfully”,
   “mobileNumber”: “91-xxxxxxxxxx”,
   “clientId”: “123454b”,
   “messageCount”: “1”,
   “messageCost”: “0.0019”
  },
  {
   “sms”: “Dear Nancy, Thank you for your payment.”,
   “senderId”: “VluTxt”,
   “smsId”: “VT-853-1481622882332”,
   “statusCode”: “7003”,
   “statusMsg”: “Delivered “,
   “statusDescription”: “Message delivered successfully”,
   “mobileNumber”: “91-xxxxxxxxx”,
   “clientId”: “”,
   “messageCount”: “1”,
   “messageCost”: “0.0019”
  }
]