iSMS Legacy API

Introduction

This Document gives details on how to send SMS, EMAILS, and Voice Messages via the FROG API Solutions from your application.

NB: To be able to connect via the API, you must first register on the FROG Platform and use your user credentials.

API FOR SMS LEGACY SEND

Instructions

Every user trying to use this API must ensure that, they have access to their valid Username and Password and also be certain that their Senderid has been approved.

NB: One can verify on their senderid approval status, by logging into their account portal, by using their valid username and password.

Parameters For Sending Message

HTTP bulk SMS API endpoint:

							
https://frog.wigal.com.gh/ismsweb/sendmsg

Parameters	Type	Required	Description
from	STRING	YES	The sender ID. Max is 11 characters. Eg: WIGAL
to	NUMBER	YES	The recipient(s) Number. Use (,) to separate multiple recipients. The numbers can be in the international Format or local Format. Eg: 233553019529 or 0553019529
message	STRING	YES	The content of message to send (Can be used for 'long' messages, that is, messages longer than 160 characters for plain text).
username	STRING	YES	This is the username; you use in logging into your FROG portal.
password	STRING	YES	This is the password; you use in logging into your FROG portal.

POSSIBLE VALUES TO BE RETURNED BY API

Parameters	Actual Message returned by API
SUCCESS	SUCCESS :: Message Sent Successfully
ERROR	ERROR :: Invalid Login credentials
ERROR	ERROR :: Destination number Invalid
ERROR	ERROR :: Invalid From. Value should not be more than 11 chars including space
ERROR	ERROR :: 1 or more Destination numbers Invalid
ERROR	ERROR :: Message Could not be sent
ERROR	ERROR :: Not Enough Balance to send {message length} message(s)

Sample POST Request:

Example 1: Sending a message to a single recipient.

							
    https://frog.wigal.com.gh/ismsweb/sendmsg?username=yourusername&password=yourpassword
    &from=WIGAL&to=233276128036&message=Hello my test message

Example 2: Sending a message to multiple recipients.

							
    https://frog.wigal.com.gh/ismsweb/sendmsg?username=yourusername&password=yourpassword
    &from=WIGAL&to=233276128036,233266000751&message=Hello my test message

Example:

							
                                
    PHP

    $time=date("Y/m/d h:i:s"); 

    $reciepients=$msisdn; 

    $message=$message; 

    $from='WIGAL'; 

    $smsusername='yourusername'; 

    $smspassword=' yourpassword'; 
 

    $messageApi='https://frog.wigal.com.gh/ismsweb/sendmsg'; 


    $params='username='.$smsusername.'&password='.$smspassword.'&from='.$from.'&to='.$reciepients.'&message='.$message; 


    $ch = curl_init(); 
    
    curl_setopt($ch,CURLOPT_URL,$messageApi); 

    curl_setopt($ch,CURLOPT_RETURNTRANSFER,1); 

    curl_setopt($ch,CURLOPT_POST,1); 

    curl_setopt($ch,CURLOPT_POSTFIELDS,$params); 

    $return=curl_exec($ch); 

    @file_put_contents('logs.txt',"\n" . "SMS request log on ". $time . "=> " . $return . "\n",FILE_APPEND); 

    curl_close($ch); 


    $send = explode(" :: ",$return); 
    
    if($send[0] == 'SUCCESS'){ 
        echo "message sent";
    }else{ 
        echo "message could not be sent"; 
    }