PHPackages                             igorbunov/edna-api-php-sdk - 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. [API Development](/categories/api)
4. /
5. igorbunov/edna-api-php-sdk

ActiveLibrary[API Development](/categories/api)

igorbunov/edna-api-php-sdk
==========================

PHP SDK for integration with edna.ru api

1.1.4(3y ago)124.5k↑33.3%MITPHPPHP ^7.1|^8.0

Since Dec 14Pushed 3y ago1 watchersCompare

[ Source](https://github.com/igorbunov/edna-api-php-sdk)[ Packagist](https://packagist.org/packages/igorbunov/edna-api-php-sdk)[ RSS](/packages/igorbunov-edna-api-php-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (1)Versions (9)Used By (0)

edna-php-sdk
============

[](#edna-php-sdk)

### PHP SDK для работы с Мессенджером edna api

[](#php-sdk-для-работы-с-мессенджером-edna-api)

##### Примечание:

[](#примечание)

> В данном sdk реализованы только функции отправки сообщений

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

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

#### Установка:

[](#установка)

```
composer require igorbunov/edna-api-php-sdk
```

#### Настройка:

[](#настройка)

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

##### Начало работы:

[](#начало-работы)

```
$api = new \igorbunov\Edna\EdnaJsonApi(
    new \igorbunov\Edna\Config\Config('апи ключ'), // берется из профиля edna
    new \igorbunov\Edna\Validator\ResponseValidator() // валидация ошибок, при желании можно заменить на свой класс
);
```

##### Отправка сообщения:

[](#отправка-сообщения)

```
$message = (new \igorbunov\Edna\Message\ImOutMessage())
    ->subject("ваш отправитель")
    ->address('телефон')
    ->text('текст сообщения');

$result = $api->imOutMessage($message): \igorbunov\Edna\MessageStatus\ImOutSuccess;
```

###### Список доступных методов ImOutMessage:

[](#список-доступных-методов-imoutmessage)

```
// обязательно*
subject(string $subject) // обязательно*, отправитель сообщения (создается в профиле)
address(string $address) // обязательно*, телефон получателя (без плюсов и лишних знаков, просто цифры)
text(string $text) // обязательно*, текст сообщения

// не обязательно
contentType(string $type) // Тип содержимого сообщения. Возможные значения:
                          // text - текстовое сообщение
                          // image - изображение
                          // document - документ, вложенный в сообщение
                          // video - сообщение, содержащее видео
                          // audio - сообщение, содержащее звук
                          // location - сообщение с координатами, адресом и описанием места. Координаты преобразуются в снимок Google maps
messageId(string $messageId) // id сообщения, если не передать, то сгенерируется автоматически
priority(string $priority) // приоритет сообщения
                           // realtime - сообщение должно быть доставлено немедленно
                           // high - сообщение с высоким приоритетом
                           // normal - сообщение со стандартным приоритетом
                           // low - сообщение с низким приоритетом
validityPeriodSeconds(int $validityPerSeconds) // Время (в секундах), в течении которого должно быть доставлено сообщение.
startTime(string $dateTime) // Время, раньше которого сообщение не будет отправлено. Формат (2020-06-12T15:30:10.000Z)
attachmentName(string $attachmentName) // Название прикрепленного изображения\документа\видео (для аудио нельзя).
attachmentUrl(string $attachmentUrl) // URL прикрепленного изображения\документа\видео. Важно (URL должен начинаться с https)
latitude(string $latitude) // Долгота геолокации. Обязательно если contentType='location'
longitude(string $longitude) // Широта геолокации. Обязательно если contentType='location'
locationAddress(string $locationAddress) // Адрес геолокации. Используется только при contentType='location'
caption(string $caption) // Название геолокации. Используется только при contentType='location'
comment(string $comment) // Текстовый комментарий в сообщении. Значение параметра отображается в детальном отчете.
```

##### Отправка HSM сообщения:

[](#отправка-hsm-сообщения)

```
$message = (new \igorbunov\Edna\Message\ImOutHSM())
    ->subject("ваш отправитель")
    ->address('телефон')
    ->text('текст сообщения')
    ->headerText('заголовок')
    ->footer('подпись')
    ->addUrlButton('текст ссылки', 'https://ссылка');

$result = $api->imOutHSM($message): \igorbunov\Edna\MessageStatus\ImOutSuccess;
```

###### Список доступных методов ImOutHSM:

[](#список-доступных-методов-imouthsm)

```
// обязательно*
subject(string $subject) // обязательно*, отправитель сообщения (создается в профиле)
address(string $address) // обязательно*, телефон получателя (без плюсов и лишних знаков, просто цифры)
text(string $text) // обязательно*, текст сообщения

// не обязательно (отличные от ImOutMessage)
headerText(string $text) // Заголовок сообщения. текст.
headerImage(string $imageUrl) // Заголовок сообщения. изображение.
headerDocument(string $documentUrl, string $documentName) // Заголовок сообщения. документ.
headerVideo(string $videoUrl, string $videoName) // Заголовок сообщения. видео.
footer(string $text) // Подпись. Отображается под сообщением приглушенным цветом текста
addTextButton(string $buttonText) // Текстовая кнопка
addPhoneButton(string $buttonText, string $phone) // Телефонная кнопка
addUrlButton(string $buttonText, string $url) // Кнопка - ссылка
addQuickReplyButton(string $buttonText, string $payload) // Кнопка - ответ

// не обязательно (такие же как и для ImOutMessage)
contentType(string $type) // Тип содержимого сообщения. Возможные значения:
                          // text - текстовое сообщение
                          // image - изображение
                          // document - документ, вложенный в сообщение
                          // video - сообщение, содержащее видео
                          // audio - сообщение, содержащее звук
                          // location - сообщение с координатами, адресом и описанием места. Координаты преобразуются в снимок Google maps
messageId(string $messageId) // id сообщения, если не передать, то сгенерируется автоматически
priority(string $priority) // приоритет сообщения
                           // realtime - сообщение должно быть доставлено немедленно
                           // high - сообщение с высоким приоритетом
                           // normal - сообщение со стандартным приоритетом
                           // low - сообщение с низким приоритетом
validityPeriodSeconds(int $validityPerSeconds) // Время (в секундах), в течении которого должно быть доставлено сообщение.
startTime(string $dateTime) // Время, раньше которого сообщение не будет отправлено. Формат (2020-06-12T15:30:10.000Z)
attachmentName(string $attachmentName) // Название прикрепленного изображения\документа\видео (для аудио нельзя).
attachmentUrl(string $attachmentUrl) // URL прикрепленного изображения\документа\видео. Важно (URL должен начинаться с https)
latitude(string $latitude) // Долгота геолокации. Обязательно если contentType='location'
longitude(string $longitude) // Широта геолокации. Обязательно если contentType='location'
locationAddress(string $locationAddress) // Адрес геолокации. Используется только при contentType='location'
caption(string $caption) // Название геолокации. Используется только при contentType='location'
comment(string $comment) // Текстовый комментарий в сообщении. Значение параметра отображается в детальном отчете.
```

##### Получить статус сообщения:

[](#получить-статус-сообщения)

```
    $result = $api->imOutMessageId('id сообщения'): \igorbunov\Edna\MessageStatus\ImOutMessageStatus;
```

##### Ошибки (Exceptions):

[](#ошибки-exceptions)

```
\igorbunov\Edna\Exceptions\ErrorSystemException - системная ошибка
\igorbunov\Edna\Exceptions\ErrorContentDoNotMatchHsmTemplateException - сообщение не соответствует зарегистрированному шаблону HSM.
\igorbunov\Edna\Exceptions\ErrorInsufficientBalanceException - недостаточно средств на балансе. Необходимо пополнить счет в личном кабинете либо обратиться к персональному менеджеру
\igorbunov\Edna\Exceptions\ErrorIdNotUniqueException - идентификатор сообщения не уникален в рамках всего взаимодействия
\igorbunov\Edna\Exceptions\ErrorSubjectFormatException - неправильный формат подписи
\igorbunov\Edna\Exceptions\ErrorSubjectUnknownException - указанная подпись не разрешена клиенту. Необходимо предварительно зарегистрировать все подписи.
\igorbunov\Edna\Exceptions\ErrorAddressFormatException - неправильный формат номера абонента
\igorbunov\Edna\Exceptions\ErrorAddressNotSpecifiedException - номер абонента не указан
\igorbunov\Edna\Exceptions\ErrorPriorityFormatException - неправильный формат значения приоритета
\igorbunov\Edna\Exceptions\ErrorStartTimeFormatException - неправильный формат отложенного времени отправки сообщения
\igorbunov\Edna\Exceptions\ErrorValidityPeriodSecondsFormatException - неправильный формат отложенного времени отправки.
\igorbunov\Edna\Exceptions\ErrorContentTypeFormatException - неправильный формат типа содержимого сообщения
\igorbunov\Edna\Exceptions\ErrorImTypeNotSpecifiedException - тип мессенджера не указан
\igorbunov\Edna\Exceptions\ErrorAttachmentUrlNotSpecifiedException - В параметре attachmentUrl передается пустое поле.
\igorbunov\Edna\Exceptions\ErrorLatitudeNotSpecifiedException - latitude (Широта) не указано.
\igorbunov\Edna\Exceptions\ErrorLongitudeNotSpecifiedException - longitude (Долгота) не указано.
\igorbunov\Edna\Exceptions\ErrorContentFormatException - неправильный формат содержимого сообщения
\igorbunov\Edna\Exceptions\ErrorContentTypeNotSpecifiedException - не указан тип вложения
\igorbunov\Edna\Exceptions\ErrorNotTemplateMatchException - неправильный формат шаблона
\igorbunov\Edna\Exceptions\ErrorSubjectIdFormatException - неправильный формат Id шаблона
\igorbunov\Edna\Exceptions\ErrorWhatsappUserException - адресат не является пользователем Whatsapp
\igorbunov\Edna\Exceptions\ErrorNotViberUserException - адресат не является пользователем Viber
\igorbunov\Edna\Exceptions\ErrorUserBlockedException - номер адресата заблокирован
\igorbunov\Edna\Exceptions\ErrorSystemBlockedException - система заблокирована
\igorbunov\Edna\Exceptions\ErrorSyntaxException - неправильный синтакс
\igorbunov\Edna\Exceptions\ErrorUnauthorizedException - ошибка авторизации
\igorbunov\Edna\Exceptions\ErrorNotFoundException - ошибка не определена
\igorbunov\Edna\Exceptions\UnknownCodeException - неизвестный код ошибки
\Exception  - стандартная ошибка
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 87.5% 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 ~38 days

Recently: every ~67 days

Total

8

Last Release

1348d ago

PHP version history (2 changes)1.0PHP ^7.2|^8.0

1.0.2PHP ^7.1|^8.0

### Community

Maintainers

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

---

Top Contributors

[![igorbunov](https://avatars.githubusercontent.com/u/472284?v=4)](https://github.com/igorbunov "igorbunov (7 commits)")[![danilyer228](https://avatars.githubusercontent.com/u/33658320?v=4)](https://github.com/danilyer228 "danilyer228 (1 commits)")

### Embed Badge

![Health badge](/badges/igorbunov-edna-api-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/igorbunov-edna-api-php-sdk/health.svg)](https://phpackages.com/packages/igorbunov-edna-api-php-sdk)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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