Download the PHP package weezqydy/sematimeapi without Composer

Sematime Api gateway for php

This is a php package that you can easily intergarate into your project to send SMS Messages using the awesome Sematime API, to start using this package require it in your project using composer a php Dependency management tool. if you dont have composer installed head over to Composer and install

To include this package in your project add this to your composer.json and then run composer update

Introduction

The Sematime API makes it possible for you to send branded and personalized SMS messages from your php application. In addition, the API also exposes contacts management functions that let you can store, edit or delete contacts on behalf of your users.

Before you get started with the API, we will need you to do the following:

Creating a free Sematime account

A Sematime account is needed before you can start using our API. If you do not have a Sematime account already, go to Sematime and get yourself an account.

Getting your API credentials

• To interact with sematime API, you will need to have an API key and the user ID of your Sematime account. We use these credentials to authenticate your requests.
• Login to your Sematime account and then click on the ‘My Account’ drop-down menu on your top right corner, choose ‘API Integration’ and then click on the ‘Generate Key’. You will be assigned a 32 character long API Key plus the accompanying user ID.

Getting Started

• Now at the root of yor project create a new file and name it .env
• In the file you just created add your API key and User Id as follows

Messages

Sending Messages

With everything configured properly, we are now ready to send our first message using sematime

You can optionally add other parameterss while building your message

• salutation() – an optional parameter whose value is the salutation type to use. When provided, each recipient will receive a personalized message beginning with the salutation followed by their name. For example: Dear Admin, Dear Lucy, Dear Jean etc in which case the salutation is the word ‘Dear

• signature() - an optional parameter whose value is a unique message that is attached at the end of all the messages that you send. For example, Sent by The Sematime team. Call 0706129100 .

• scheduledTime() – an optional parameter whose value is the date and time in milliseconds when you want the message to be sent out on a future date.

• senderId() – an optional parameter whose value is the sender ID / brand that will be used to send your message. If not specified, your Sematime account’s sender Id will be used instead.

• callbackUrl() – an optional parameter whose value is the URL that we will call in order to pass the delivery report after sending a scheduled message. All callbacks are invoked via HTTP POST.

• extra() – an optional parameter containing additional parameters that you may need to pass on to our API for later processing by your system. For example, account numbers, user Ids, etc. We don’t process these parameters and will pass them to you when invoking your callback.

Geting Scheduled Messages

To retreive Scheduled messages

Contacts

Sematime organizes contacts into groups. A group will usually contain the contacts of people who share some relationship. For example, group ‘Sales Team’ would be a group for the members of the company’s sales team.

Adding Contacts

We can also add contacts to your sematime account, just prepare your contact and then save it

Retreiving Contacts

• Getting contacts from a group - Provide the group name for the contacts you want to retreive

• Getting an Individual contact from a group - Pass in the contactId as the first parameter followed by the groupName

Editing Contacts

To edit your contact all you need to do is provide your new name or new phone number for that contact

`

Deleting Contacts

Deleting a contact only requires you to provide the group and ID of the contact you wish to delete

Account details

To retrieve your account details

use Semamatime/Api/Sematime;

    $sema= new Sematime();

    $response = $sema->accountDetails();

    echo $response //{"account":{"accountId":"xxxxxxxxxxxxx", "name":"Your Name", "phoneNumber":"123456789", "smsBalance":0, "accountType":"school", "senderId":"Sematime", "paymentPlan":"prepaid", "createdOn":"Wed, 09\/09\/2015 04:59 PM"}, "statusCode":200, "description":"Account profile retrieved successfully."}