seregazhuk/smsintel-api

A PHP wrapper for the SmsIntel api. Provides one interface for both XML and JSON API requests.

SmsIntel PHP Api

, _(*1)

, _(*2)

Library provides common interface for making requests to both XML and JSON smsintel API., _(*3)

• Dependencies
• Installation
• Quick Start
• Sending messages
• Groups and contacts
• Account
• Reports

Dependencies

Library requires CURL extension and PHP 5.5.9 or above., _(*4)

Installation

Via Composer:, _(*5)

composer require seregazhuk/smsintel-api

Quick Start

// You may need to amend this path to locate composer's autoloader
require('vendor/autoload.php'); 

use seregazhuk\SmsIntel\SmsIntel;

$sender = SmsIntel::create('login', 'password');

// send sms
$result = $sender->send('phoneNumber', 'From', 'Your message text');

Sending messages

To send message to one phone number:, _(*6)

$result = $sender->send('phoneNumber', 'From', 'Your message text');

You can pass an array of phones:, _(*7)

$phones = [
 '79999999999'
 '79999999991'
 '79999999992'
];
$result = $sender->send($phones, 'From', 'Your message text');

Cancel sms by id:, _(*8)

$result = $sender->cancel($smsId);

Request a source name:, _(*9)

$result = $sender->requestSource('FromPHP');

Groups and contacts

Get contact info by phone number:, _(*10)

$contact = $sender->getPhoneInfo('79999999999');

Get all contacts:, _(*11)

$contacts = $sender->getContacts();

Contacts for specific group:, _(*12)

$groupId = 1;
$contacts = $sender->getContacts($groupId);

Contacts by phone number:, _(*13)

$phone = '79999999999';
$contacts = $sender->getContacts(null, $phone);

// or with group:
$groupId = 1;
$contacts = $sender->getContacts($groupId, $phone);

Create a new contact:, _(*14)

$contactInfo = [
    'idGroup' => 1 // required
    'phone'   => '79999999999' // required
    'f'       => 'Second Name',
    'i'       => 'First Name',
    'o'       => 'Middle Name',
    'bday'    => 'YYYY-mm-dd',
    'sex'     => 1 // 1 - male, 2 - female
];
$result = $sender->addContact($contactInfo);

Remove contact by phone number:, _(*15)

$sender->removeContact('79999999999');

You can pass optionally group id:, _(*16)

$groupId = 1;
$sender->removeContact('79999999999', $groupId);

Get all groups:, _(*17)

$groups = $send->getGroups();

Get group by id or name:, _(*18)

$groups = $sender->getGroups($groupId);
$groups = $sender->getGroups(null, $groupName);

Create a new group of contacts:, _(*19)

$result = $sender->createGroup('NewGroup');

Edit group name by id:, _(*20)

$result = $sender->editGroup($newName, $groupId);

Account

Get account info:, _(*21)

$result = $sender->getAccountInfo();

Get balance:, _(*22)

$result = $sender->getBalance();

Use discount coupon:, _(*23)

$result = $sender->checkCoupon('couponCode');

Only check discount coupon:, _(*24)

$result = $sender->checkCoupon('couponCode', false);

Reports

Get report for period by phone number:, _(*25)

$result = $sender->getReportByNumber($dateFrom, $dateTo, '79999999999');

Get report for period and for all numbers:, _(*26)

$result = $sender->getReportByNumber($dateFrom, $dateTo);

Get report by smsId:, _(*27)

$result = $sender->getReportBySms($smsId);

Get report for period by source:, _(*28)

$result = $sender->getReportBySource($dateFrom, $dateTo, 'FromPHP');

Get report for period for all sources:, _(*29)

$result = $sender->getReportBySource($dateFrom, $dateTo);

How can I thank you?

Why not star the github repo? I'd love the attention!, _(*30)

Thanks!, _(*31)