This is an open source PHP SDK that allows you to access the Hubtel REST SMS API from your PHP application. You need to create a Hubtel account in order to use this API.
The SDK can smoothly run on PHP 5.3 and above with CURL extension enabled. The Hubtel PHP SDK can be installed with Composer. Run this command:
composer require hubtel/hubtel-sms
After composer pulls in the package, change directory into the package folder
cd /path/to/folder
And run:
composer install
The composer install command would install the dependencies of the package and you should see a vendor directory upon successful installation.
To avoid collision with class names from other libraries you may be using, the classes in the Hubtel SDK have been namespaced under Hubtel\Sms. Do well to import the classes when you use them in your own projects as seen in the Demo.php file.
The SDK currently is organized around four main classes:
- MessagingApi.php : It handles sending and receiving messages, NumberPlans, Campaigns, Keywords, Sender IDs and Message Templates management.(For more information about these terms refer to Our developer site.)
- ContactApi.php : It handles all contacts related tasks.
- AccountApi.php : It handles the API Account Holder data.
- SupportApi.php : It helps any developer to interact with our support platform via his application.
- ContentApi.php : It handles all content related tasks.
- How to Send a Message
To send a message just copy this code snippet and do the necessary modifications:
use Hubtel\Sms\ApiHost;
use Hubtel\Sms\BasicAuth;
use Hubtel\Sms\AccountApi;
use Hubtel\Sms\HttpResponse;
use Hubtel\Sms\MessagingApi;
use Hubtel\Sms\MessageResponse;
require './vendor/autoload.php';
$auth = new BasicAuth("user123", "pass123");
// instance of ApiHost
$apiHost = new ApiHost($auth);
// instance of AccountApi
$accountApi = new AccountApi($apiHost);
// Get the account profile
// Let us try to send some message
$messagingApi = new MessagingApi($apiHost);
try {
// Send a quick message
$messageResponse = $messagingApi->sendQuickMessage("DevUniverse", "+233207110652", "Welcome to planet Hubtel!");
if ($messageResponse instanceof MessageResponse) {
echo $messageResponse->getStatus();
} elseif ($messageResponse instanceof HttpResponse) {
echo "\nServer Response Status : " . $messageResponse->getStatus();
}
} catch (Exception $ex) {
echo $ex->getTraceAsString();
}- How to Schedule a Message
To schedule a message just copy this code snippet and do the necessary modifications. However please do refer to PHP datetime functions to know how to set the message time it is very crucial.
use Hubtel\Sms\ApiHost;
use Hubtel\Sms\BasicAuth;
use Hubtel\Sms\AccountApi;
use Hubtel\Sms\HttpResponse;
use Hubtel\Sms\MessagingApi;
use Hubtel\Sms\MessageResponse;
require './vendor/autoload.php';
// Here we assume the user is using the combination of his clientId and clientSecret as credentials
$auth = new BasicAuth("user233", "password23");
// instance of ApiHost
$apiHost = new ApiHost($auth);
$enableConsoleLog = TRUE;
$messagingApi = new MessagingApi($apiHost, $enableConsoleLog);
try {
// Default Approach
$mesg = new Message();
$mesg->setContent("I will see you soon...");
$mesg->setTo("+233245098456");
$mesg->setFrom("+233245657867");
$mesg->setRegisteredDelivery(true);
$mesg->setTime(date('Y-m-d H:i:s', strtotime('+1 week'))); // Here we are scheduling the message to be sent next week
$messageResponse = $messagingApi->sendMessage($mesg);
if ($messageResponse instanceof MessageResponse) {
echo $messageResponse->getStatus();
} elseif ($messageResponse instanceof HttpResponse) {
echo "\nServer Response Status : " . $messageResponse->getStatus();
}
} catch (Exception $ex) {
echo $ex->getTraceAsString();
}Please do explore the MessagingApi class for more functionalities.
- How to view Account Details
To send a message just copy this code snippet and do the necessary modifications:
require './vendor/autoload.php';
// Here we assume the user is using the combination of his clientId and clientSecret as credentials
$auth = new BasicAuth("user233", "password23");
// instance of ApiHost
$apiHost = new ApiHost($auth);
// instance of AccountApi
$enableConsoleLog = TRUE;
$accountApi = new AccountApi($apiHost, $enableConsoleLog);
try {
// Get the Account Profile
$profile = $accountApi->getProfile();
if ($profile instanceof AccountProfile) {
echo "\n\n" . $profile->getAccountId();
} else if($profile instanceof HttpResponse){
echo "\n\n".$profile->getStatus();
}
} catch (Exception $ex) {
echo $ex->getTraceAsString();
}Please do explore the AccountApi class for more functionalities.
The ContactApi, SupportApi and ContentApi classes follow almost the same pattern of functionalities, please do explore them to grab their capabilities.
If you need help using the library, please contact Hubtel Support at support@hubtel.com. Our friendly support staff usually reply within 24 hours.