PHPackages                             igormakarov/smsby.api.php.client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. igormakarov/smsby.api.php.client

ActiveLibrary

igormakarov/smsby.api.php.client
================================

Client for SMS.BY API - service for send sms and viber messages

v1.2.0(1y ago)27.9k↓34.2%MITPHPPHP >=7.4.3 || ^8.0.2

Since Feb 27Pushed 1y ago1 watchersCompare

[ Source](https://github.com/MakarovIgor/smsby.api.php.client)[ Packagist](https://packagist.org/packages/igormakarov/smsby.api.php.client)[ RSS](/packages/igormakarov-smsbyapiphpclient/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (16)Used By (0)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

smsby.api.php.client - клиент для работы с SMS.BY API
=====================================================

[](#smsbyapiphpclient---клиент-для-работы-с-smsby-api)

#### Внимание

[](#внимание)

> Реализовано только отправка быстрых смс, создание сообщений и отправка их в рассылке, получение альфа-имен, ID альфа-имени по названию. а также проверка статуса смс и получение баланса

#### Официальная документация:

[](#официальная-документация)

#### Подключение к проекту:

[](#подключение-к-проекту)

```
composer require igormakarov/smsby.api.php.client

```

```
require_once 'vendor/autoload.php';
```

#### Иничиализация и описание методов:

[](#иничиализация-и-описание-методов)

Инициализация

```
$client = new SmsByApiClient('yourApiKey');
```

Получить список альфа-имен(массив объектов AlphaName)

```
$client->getAlphaNames(): array
```

Получить ID альфа-имени по его названию

```
$id = $client->getAlphanameId('yourAlphaName'): int
```

Отправка быстрого сообщения, в результате возвращает ID SMS сообщения, по которому можно проверить статус отправки и доставки

```
$smsId = $client->sendQuickSMS(string $message, string $phone, int $alphaNameId = 0): int
```

Отправка быстрого сообщения с переадресацией на Viber, если на SMS сообщение не будет доставлено, тот же sendQuickSMS только расширенней. В результате возвращает ID сообщения

```
$smsId = $client->sendQuickSMSWithForwarding(string $message, string $phone, int $viberNameId, int $alphaNameId = 0, $forwardingTimeInMinutes = 60): int
```

Создание сообщения для массовой отправки

```
$createdSmsMessage = $client->createSmsMessage(string $message, string $name = '', int $alphaNameId = 0, string $sendDateTime = ''): CreatedSmsMessage
```

Отправка SMS сообщения, созданного методом createSmsMessage, возвращает ID SMS сообщения

```
$smsId = $client->sendSms(CreatedSmsMessage $createdSmsMessage, string $phone): int
```

Получить статус сообщения SmsStatus, принимает ID SMS отпраленного методом sendQuickSMS, sendQuickSMSWithForwarding или sendSms

```
$smsStatus = $client->checkSMS(int $smsId): SmsStatus

Модель SmsStatus может вам показать отправленно ли, доставлено ли сообщение и когда
$smsStatus->isDelivered(), $smsStatus->isSent()
```

Получить остаток на балансе, возвращает модель Balance в котором хранится информация о валюте и сколько денег на балансе

```
$balanace = $client->getBalance(): Balance
```

#### Пример отправки быстрого сообщения(Обратите внимание так же на то, что в API от SMS.BY не сразу приходят статус отправки и доставки сообщения)

[](#пример-отправки-быстрого-сообщенияобратите-внимание-так-же-на-то-что-в-api-от-smsby-не-сразу-приходят-статус-отправки-и-доставки-сообщения)

```
  try {
    $client = new SmsByApiClient("yourApiKey");
    $firstAlphaName = $client->getAlphaNames()[0];
    $smsId = $client->sendQuickSMS("test", '375222222227', $firstAlphaName->getId());
    while (!$client->checkSMS($smsId)->isSent()) {
        sleep(2);
    }
    echo "Сообщение #" . $smsId . " отправлено \n";
    while (!$client->checkSMS($smsId)->isDelivered()) {
        sleep(2);
    }
    echo "Сообщение " . $smsId . " доставлено \n";
} catch (Exception $ex) {
    echo $ex->getMessage();
}
```

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Recently: every ~90 days

Total

14

Last Release

657d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/aa5e4cd6c505253ae5b42757c4431cd32c573deb527760fa7e41498933e712d3?d=identicon)[MakarovIgor](/maintainers/MakarovIgor)

---

Top Contributors

[![MakarovIgor](https://avatars.githubusercontent.com/u/28019844?v=4)](https://github.com/MakarovIgor "MakarovIgor (27 commits)")

### Embed Badge

![Health badge](/badges/igormakarov-smsbyapiphpclient/health.svg)

```
[![Health](https://phpackages.com/badges/igormakarov-smsbyapiphpclient/health.svg)](https://phpackages.com/packages/igormakarov-smsbyapiphpclient)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k21](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)