Download the PHP package enio1910/laravel-smsapi-notification-channel without Composer

SMSAPI Notification Channel for Laravel

This package makes it easy to send SMS and MMS notifications using SMSAPI with Laravel 11, 12, and 13.

Installation

If you are using Laravel without package auto-discovery, add the service provider to config/app.php:

Publish the config:

Configuration

Configure config/smsapi.php:

Or set only .env values:

The package uses the official smsapi/php-client v3 adapter internally.

• service=pl uses smsapiPlService()
• service=com uses smsapiComService()
• if uri is set, the package uses the matching *ServiceWithUri() variant
• MMS sending is available only for service=pl, because the official SMSAPI client exposes mmsFeature() only there

Response DTO

The channel returns NotificationChannels\SmsApi\Dto\SmsApiResponse.

For real SMSAPI sends the package maps the response returned by smsapi/php-client and normalizes it to:

• statusCode: local adapter status, currently 200 when the SMSAPI client accepted the send request
• decoded.id: SMS/MMS identifier
• decoded.points: charged points
• decoded.number: recipient number
• decoded.status: SMS/MMS status returned by SMSAPI
• decoded.idx: external identifier if present
• decoded.date_sent: ISO-8601 sent date if available

This is adapter-level data, not the raw HTTP response from SMSAPI.

Usage

To send the notification, call notify() on your model:

The model you call notify() on must use the Illuminate\Notifications\Notifiable trait.

For on-demand notifications, you can use the channel class directly:

Example:

If you do not pass the recipient directly with to(), you must define the recipient on the notifiable model:

This method name is kept for compatibility. The package supports SmsApiChannel::class for via() and on-demand Notification::route(), while model-based routing still resolves through routeNotificationForSmsApi().

In practice, a complete notifiable model can look like this:

Or provide the recipient directly in the message:

If you use to(), routeNotificationForSmsApi() is not required for that notification.

Bulk SMS Usage

To send one SMS to many recipients in a single SMSAPI request, use toMany():

You can also return an array from routeNotificationForSmsApi():

Bulk sending is available for SMS messages. MMS still requires a single recipient.

MMS Usage

To send an MMS, switch the message to MMS mode with mms($subject, $smil):

• The SMIL payload should use the SMIL 1.0 standard.
• If the MMS references files by path or URL, that path must be publicly accessible.

You can still use to() to set the recipient explicitly:

Any additional MMS-specific parameters supported by SMSAPI can be passed with set($key, $value).