nekkoy/gateway-smsturbo

SMS Gateway for SmsTrubo service

1.0.0 2025-03-25 19:58 UTC

Requires

• php: >=7.2
• illuminate/support: ^8.0|^9.0|^10.0|^11.0|^12.0
• nekkoy/gateway-abstract: >=1.0

MIT

• Alexander Dudiak

• sms
• gateway
• laravel
• nekkoy
• smsturbo

README

SMS Gateway для сервиса turbosms.ua

Установка:

composer require nekkoy/gateway-smsturbo

Конфигурация .env

# Включить/выключить модуль
SMSTURBO_ENABLED=true

# Ключь API
SMSTURBO_API_KEY=

# Имя отправителя в СМС
SMSTURBO_SMS_NAME=

# Имя отправителя в Viber
SMSTURBO_VIBER_NAME=

# Флажок транзационного сообщения: 1 - да, какие-либо другие значения или отсутствие этого параметра - нет
# Отправка транзакционных сообщений от общего отправителя запрещена.
# Все транзакционные сообщения, отправляемые на номера Украины, должны соответствовать заранее зарегистрированным шаблонам.
# Если при отправке транзакционного сообщения не будет найден соответствующий шаблон, то оно будет отклонено с кодом NOT_ALLOWED_MESSAGE_TRANSACTION_PATTERN.
# Не исключены ситуации, когда шаблон будет найден у нас, но Viber по каким-то причинам не найдет его у себя, в таком случае уведомление будет протарифицировано как рекламное.
# Мы стараемся обнаруживать подобные случаи, чтобы наши клиенты могли оперативно внести изменения в шаблон и получить цену транзакционного сообщения.
SMSTURBO_TRANSACTIONAL=0

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

Создайте DTO сообщения, передав первым параметром текст, а вторым — номер получателя:

$message = new \Nekkoy\GatewayAbstract\DTO\MessageDTO("test", "[phone]");

Затем вызовите метод отправки сообщения через фасад:

/** @var \Nekkoy\GatewayAbstract\DTO\ResponseDTO $response */
$response = \Nekkoy\GatewaySmsturbo\Facades\GatewaySmsturbo::send($message);

Метод возвращает DTO-ответ с параметрами:

• message - сообщение об успешной отправке или ошибке
• code - код ответа:
  • code < 0 - ошибка модуля
  • code > 0 - ошибка HTTP
  • code = 0 - успех
• id - ID сообщения