Voice Broadcast API TTS
http://<domain_name>/api/voice/voice_broadcast_tts.php?username=<username>&token=<token>&announcement_id=<announcement_id>&plan_id=<plan_id>&contact_numbers=<contact_number1[,contact_number2,...]>[&caller_id=<caller_id>]
Voice Broadcast API TTS through Sarv
<?php
try {
$post_url = "http://your_domain/api/voice/voice_broadcast.php";
$ARR_POST_DATA = array();
$ARR_POST_DATA['username'] = 'your_username';
$ARR_POST_DATA['token'] = "your_token";
$ARR_POST_DATA['content'] = "Your Content";
$ARR_POST_DATA['plan_id'] = 12;
$ARR_POST_DATA['caller_id'] = "1234"; // optional
$ARR_POST_DATA['contact_numbers'] = "1234XXXXXX,6789XXXXXX"; // comma(,) seperated
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $post_url);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($ARR_POST_DATA));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
$response = curl_exec($curl);
echo $response;
$arr_response = json_docode($response, true);
var_dump($arr_response);
curl_close($curl);
} catch (Sarv_Error $e) {
// Sarv errors are thrown as exceptions
echo "A sarv error occurred: " . get_class($e) . " - " . $e->getMessage();
}
?>
{
"status":"success",
"code":"000",
"desc":"Call Submitted Successfully",
"data":[
{
"contact_number":"1234XXXXXX",
"unique_id":"12X_24X_XX",
"system_api_uniqueid":"12X_24X_XX",
},
{
"contact_number":"1234XXXXXX",
"unique_id":"12X_24X_XX",
"system_api_uniqueid":"12X_24X_XX",
},
{
"contact_number":"1234XXXXXX",
"unique_id":"12X_24X_XX",
"system_api_uniqueid":"12X_24X_XX",
},
]
}
{
"status":"error",
"code":"002",
"desc":"Parameter is blank."
}
| Parameters |
| username* string |
a valid Sarv SMS Panel username |
| token* string |
a valid token |
| content* text |
Enter announcement text |
| plan_id* string |
Voice plan_id for sending voice call |
| caller_id* integer |
Approved caller id |
| contact_numbers* integer |
a valid contact number (, seperated for multiple contacts) Max : 50 Contact Numbers |
* compulsory field
| Return Value: Success |
| struct |
the results of Voice Broadcast TTS
| status string |
success |
| code string |
000 |
| desc string |
Description of success |
| data array |
array of contact numbers and respective unique ids. |
|
|
| Return Value: Error |
| struct |
the error results when Voice Broadcast TTS
| status string |
error |
| code string |
007 |
| desc string |
description of error |
|
|
| Api Response Codes |
| 000 |
Call Submitted Successfully. |
| 001 |
Parameter Missing . |
| 002 |
Parameter is blank. |
| 003 |
Request IP not added in whitelist . |
| 004 |
Invalid user type. |
| 005 |
Invalid Credentials. |
| 006 |
User is InActive. |
| 008 |
Exceeded contact no limit for single api call . |
| 010 |
Invalid caller id . |
| 011 |
Some issue in credit fetch . |
| 014 |
There is no plan assign to parent . |
| 015 |
Voice Amount Validity Expired . |
| 016 |
Low voice amount to your parent . |
| 017 |
No gateway available for voice broadcast . |
| 019 |
Invalid User Voice Plan . |
| 020 |
Caller id is not host on any gateway . |