README

Laravel-пакет для отправки SMS через Beeline A2P SMS API.

Требования

• PHP >= 8.1
• Laravel >= 10.0

Установка

composer require diffhead/laravel-beeline-sms

Пакет поддерживает автообнаружение провайдера Laravel — дополнительная регистрация не требуется.

Публикация конфигурации

php artisan vendor:publish --tag=config

Будет опубликован файл config/beeline-sms.php.

Публикация миграции

Если вы планируете хранить историю отправленных сообщений в БД (реестр), опубликуйте миграцию:

php artisan vendor:publish --tag=migrations
php artisan migrate

Настройка

Добавьте переменные в .env:

LARAVEL_BEELINE_API_URL=https://a2p-sms-https.beeline.ru/proto/http/rest
LARAVEL_BEELINE_API_LOGIN=
LARAVEL_BEELINE_API_PASSWORD=
LARAVEL_BEELINE_API_SENDER=
LARAVEL_BEELINE_API_GZIP=false
LARAVEL_BEELINE_API_COMMENT=
LARAVEL_BEELINE_LOG_CHANNEL=daily
LARAVEL_BEELINE_REGISTRY_ENABLED=false
LARAVEL_BEELINE_REGISTRY_TABLE=beeline_messages
LARAVEL_BEELINE_REGISTRY_MODEL=\\SaintSample\\LaravelBeelineSms\\Models\\BeelineMessage

Использование

Отправка SMS

use SaintSample\LaravelBeelineSms\Facades\BeelineSms;

$statuses = BeelineSms::send(
    targets: ['79991234567', '79997654321'],
    message: 'Текст сообщения'
);

foreach ($statuses as $status) {
    $status->id();      // ID сообщения в API
    $status->phone();   // Номер телефона
    $status->status();  // Статус (accepted)
    $status->message(); // Текст сообщения
    $status->sentAt();  // Дата отправки
}

Получение статусов

По ID сообщения

use SaintSample\LaravelBeelineSms\Facades\BeelineSms;
use SaintSample\LaravelBeelineSms\View\FetchStatuses;

$statuses = BeelineSms::statuses(
    new FetchStatuses(smsId: '851181624766455712')
);

По временному интервалу

use SaintSample\LaravelBeelineSms\Facades\BeelineSms;
use SaintSample\LaravelBeelineSms\View\FetchStatuses;
use SaintSample\LaravelBeelineSms\View\DateInterval;
use Carbon\Carbon;

$statuses = BeelineSms::statuses(
    new FetchStatuses(
        dateInterval: new DateInterval(
            from: Carbon::yesterday(),
            until: Carbon::now(),
        )
    )
);

Статусы сообщений

Реестр сообщений

При включённом реестре (LARAVEL_BEELINE_REGISTRY_ENABLED=true) пакет автоматически сохраняет отправленные сообщения в базу данных через слушатель события MessagesSent.

Таблица содержит поля: external_message_id, status, target, message, sent_at.

Обновление статусов

Для массового обновления статусов сообщений в реестре используйте artisan-команду:

php artisan beeline-messages:update-statuses

Команда находит все сообщения с незавершёнными статусами и создаёт отдельную очередную задачу (UpdateMessageStatus) для обновления каждого из них.

События

Вы можете подписаться на событие для реализации собственной логики:

use SaintSample\LaravelBeelineSms\Events\MessagesSent;

Event::listen(MessagesSent::class, function (MessagesSent $event) {
    // $event->getStatuses() — коллекция статусов отправленных сообщений
});

Лицензия

MIT

Справочник API

{
  "action": "post_sms",
  "user": "YourUserId",
  "pass": "YourApiPassword",
  "comment": null,
  "message": "YourText",
  "target": "79XXXXXXXXX,79XXXXXXXXX",
  "sender": "YourSender"
}

{
  "actions": [
    {
      "id": "851181624766455712",
      "phone": "+79XXXXXXXXX",
      "message": "YourText",
      "action": "post_sms_action",
      "sms_type": "SENDSMS",
      "sms_res_count": "1",
      "sms_group_id": "851182724278083582"
    }
  ],
  "agt_id": "1514230",
  "date_report": "14.03.2026 20:00:01"
}

{
  "action": "status",
  "user": "YourUserId",
  "pass": "YourApiPassword",
  "sms_id"?: "851181624766455723",
  "date_from"?: "d.m.Y H:i:s",
  "date_to"?: "d.m.Y H:i:s"
}

{
  "actions": [
    {
      "sms_group_id": "851182724278083582",
      "sms_id": "851181624766455712",
      "sms_type": "SENDSMS",
      "created": "14.03.2026 20:00:01",
      "aul_username": "YourUserId",
      "aul_client_addr": "YourClientIP",
      "aul_proxy_addr": "YourProxyIP",
      "target": "79XXXXXXXXX",
      "sender": "YourSender",
      "sms_count": "1",
      "text": "YourText",
      "stc_code": "error",
      "sent": "0",
      "closed": "1",
      "status": "Ошибка отправки",
      "action": "status_action",
      "close_time": "14.03.26 20:00:01"
    }
  ],
  "agt_id": "1514201",
  "date_report": "14.03.2026 20:00:01"
}