Field Name Type Example Value Definition
c_uid Text test@slybroadcast.com Login email address. Required for each request.
c_password Password 12345678 Password. Required for each request.
c_record_audio Text My First Message Audio file name as seen within your account. *Case Sensitive. Not required if c_url provided.
c_url Text http://www.yourwebsite.com/MeetingReminder.wav To send a campaign using your own audio file, use c_url. You must designate the file type you are using (WAV or Mp3 files only) with c_audio.
c_audio Text wav Audio file type (WAV or Mp3). Required only if c_url is used.
c_phone Text 442077810000, 442073004300 Destination phone numbers. Max: 10,000 per submission.
c_callerID Text 441932864471 Caller ID of campaign. This will appear within the recipient's voicemail-box.
c_date Text now Date/Time of delivery in Greenwich Mean Time. YYYY-MM-DD HH:MM:SS *Must use 24-hour time format.
Example: 5:00pm = 17:00:00

SENDING A SLYBROADCAST CAMPAIGN

Below is a sample of a successful campaign submission, using the POST method. We will return an acknowledgement 'OK' if successful. Otherwise, we will send back an error message indicating the missing variables. If you would like your results returned to your own URL, then c_dispo_url should be used.

IMPORTANT: All campaigns are sent out in Greenwich Mean Time (GMT) and use the 24-hour clock. (YYYY-MM-DD HH:MM:SS)
Example: December 31, 2019 at 5:00pm = "2019-12-31 17:00:00"

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="hidden" name="c_callerID" value="441932864471"> <input type="text" name="c_phone" value="442077810000,442073004300"> <input type="hidden" name="c_date" value="2019-12-31 17:00:00"> <!-- To use an audio file visible within your account, include: --> <!-- Audio file names are case sensitive --> <input type="text" name="c_record_audio" value="My First Voice Message"> <input type="submit" value="submit"> </form>

To send a campaign using your own audio file, use c_url. You must designate the file type you are using (.WAV or .MP3 files only) with c_audio.

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="hidden" name="c_callerID" value="441932864471"> <input type="text" name="c_phone" value="442077810000,442073004300"> <input type="hidden" name="c_date" value="2019-12-31 17:00:00"> <!--If using an audio file accessed from a URL, use c_url and include file type extension--> <input type="text" name="c_url" value="http://www.yourwebsite.com/MeetingReminder.wav"> <input type="hidden" name="c_audio" value="wav"> <input type="submit" value="submit"> </form>

To set an End Time to your campaign, use c_endtime. By inserting an End Time, your campaign will not run past the time chosen, regardless of its percentage of completion.

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="hidden" name="c_callerID" value="441932864471"> <input type="text" name="c_phone" value="442077810000,442073004300"> <input type="hidden" name="c_date" value="2019-12-31 17:00:00"> <!--If setting an end time, include c_endtime--> <input type="text" name="c_endtime" value="2019-02-01 20:00:00"> <input type="submit" value="submit"> </form>

The following data will be returned if a campaign is successfully received.

OK session_id=9377466671 number of phone=2



CALL STATUS RETURNED TO URL

Users can provide a URL to which each call status will be posted, automatically using c_dispo_url . However, this is optional. You must provide your own URL.
*Users must acknowledge receipt of each call status by returning 'OK'.

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="hidden" name="c_callerID" value="441932864471"> <input type="text" name="c_phone" value="442077810000,442073004300"> <input type="hidden" name="c_date" value="now"> <!-- To receive call statuses automatically to your own URL, include: --> <input type="text" name="c_dispo_url" value="http://www.yoursite.com/mystatus.php"> <input type="submit" value="submit"> </form>

Your campaign information will be returned in the following format:

"Session ID" | "Call To" | "Status" | "Reason for Failure" | "Delivery Time" | "Carrier" 9377466671 | 442077810000 | OK | | 2017-12-31 17:00:00 | o2 Mobile 9377466671 | 442073004300 | OK | | 2017-12-31 17:00:04 | TMobile 9377466671 | 448719429100 | Failure | Do Not Dial List Removed | | | 9377466671 | 442074854343 | OK | Unable to Detect VM | 2017-12-31 17:00:32 | o2 Mobile

Below is example PHP code to handle the post back. *Users must acknowledge receipt of each call status by returning 'OK'.

//$postback = '"campaign_id"|"destination"|"dispoCode"|"dispoText"|"delivery_time"|"carrier"'; $postback = '"9145797854"|"442074854343 "|"OK"|""|"2018-01-10 10:00:00"|"o2 Mobile"'; // Parse the data into variables as seen below: list($campaign_id, $destination, $dispo_Code, $dispo_Text, $delivery_time, $carrier) = explode("|", $postback, 6); // Variables will appear with ' " ' around them: echo $campaign_id.",".$destination; // Will print: "9145797854","442074854343" //To remove ' " ' use: $campaign_id = str_replace('"', '', $campaign_id); $destination = str_replace('"', '', $destination); echo $campaign_id.",".$destination."\n"; //Will print: 9145797854,442074854343 // Save your data, then return an 'OK': echo "OK"; ?>

DETAILED RESULTS OF COMPLETED CAMPAIGN

To request the call results for each phone number in a single campaign, the following parameters must be included. Be sure the session_id is the one received in response to your initial campaign submission.

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="text" name="c_option" value="campaign_result"> <input type="text" name="session_id" value="9377466671"> <input type="submit" value="submit"> </form>

Results will be returned in the following format:

"Session ID" | "Call To" | "Status" | "Reason for Failure" | "Delivery Time" | "Carrier" 9377466671 | 442077810000 | OK | | 2017-12-31 17:00:00 | o2 Mobile 9377466671 | 442073004300 | OK | | 2017-12-31 17:00:04 | TMobile 9377466671 | 448719429100 | Failure | Do Not Dial List Removed | | | 9377466671 | 442074854343 | OK | Unable to Detect VM | 2017-12-31 17:00:32 | o2 Mobile

PAUSE OR RESUME YOUR CAMPAIGN

To temporarily pause a running campaign or resume a campaign that was previously paused, you must include the session_id of the campaign received in the response to your initial campaign. We will return an 'OK' or an error if the session_id was not found.

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="text" name="session_id" value="9377466671"> <!-- To pause a running campaign include:--> <input type="text" name="c_option" value="pause"> <!-- To resume a campaign that was previously paused include:--> <input type="text" name="c_option" value="run"> <input type="submit" value="submit"> </form>

Possible return responses may include:

OK 9377466671 <session_id> was paused OK 9377466671 <session_id> resumed ERROR 9377466671 <session_id> invalid or not found

CANCEL A CAMPAIGN

To cancel a running campaign or a scheduled campaign, you must include the session_id of the campaign received in the response to your initial campaign. We will return an 'OK' or an error if the session_id was not found.
*Once a campaign is cancelled, it cannot be restarted.

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="text" name="session_id" value="9377466671"> <!-- To cancel a running or scheduled campaign include:--> <input type="text" name="c_option" value="stop"> <input type="submit" value="submit"> </form>

REQUEST REMAINING DELIVERY CREDITS

To request the number of remaining message credits in your account, the following parameters below must be used. Pending message credits are messages scheduled to be delivered and are in your que.

<form action="https://www.mobile-sphere.com/gateway/slyi.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="text" name="remain_message" value="1"> <input type="submit" value="submit"> </form>

The following data will be returned:

remaining messages=200 pending messages=0

RETRIEVE A LIST OF AUDIO FILES

To retrieve a full list of the audio files in your account, please post to the URL: https://www.mobile-sphere.com/gateway/slyi.aflist.php
Use get_audio_list_with_duration to include each audio file's duration, in seconds.

<form action="https://www.mobile-sphere.com/gateway/slyi.aflist.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="text" name="c_method" value="get_audio_list"> <input type="submit" value="submit"> </form>

We will return our system file name along with your self-created file name and the date/time created.

"System File Name" | "Self Created Audio File Name" | "Time Created" r18032b404759888.wav | My First Slybroadcast Recording | 2018-01-01 15:03:00

DOWNLOADING AN AUDIO FILE

To download an audio file referencing the 5-digit name assigned when recording via the Slybroadcast Recording Center or our system name, please post to the URL: https://www.mobile-sphere.com/gateway/slyi.dla.php

<form action="https://www.mobile-sphere.com/gateway/slyi.aflist.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="text" name="c_audio_code" value="55555"> </form>

If referencing our system file name, use c_sys_audio_name.

<form action="https://www.mobile-sphere.com/gateway/slyi.aflist.php" method="post"> <input type="text" name="c_uid" value="admin@slybroadcast.com"> <input type="password" name="c_password" value="12345678"> <input type="text" name="c_sys_audio_name" value="r18094b4047197888.wav"> </form>

Corrections? Email us at support@slybroadcast.com.

Log In



Thank you! Your login information will arrive shortly.

Email Address
Password

Forgot Your Password?

No problem! Enter your email address and we'll send you a reset link.


Thank you! Your login information will be arriving shortly.
Email Address