Sms Advert

Description

Sms Advert integrates Laravel Enso with the SMS Advert API.

The package stores provider settings, exposes a callback endpoint for delivery updates, and provides an action object for dispatching SMS messages with optional outbound filters and automatic callback registration.

It is intended for sale-channel and commercial flows that need SMS delivery notifications or transactional outbound messages through the Sms Advert provider.

Installation

Install the package:

composer require laravel-enso/sms-advert

Run the package migrations:

php artisan migrate

Features

• Settings screen for base URL, auth token, test phone, and enablement.
• Callback endpoint for delivery-status updates.
• Sms action wrapper that applies filters and injects the callback URL.
• Message model and dynamic relation support for linked SMS messages.

Usage

Main route groups:

• integrations.smsAdvert.settings.*
• integrations.smsAdvert.callbacks.*

Typical send flow:

use LaravelEnso\SmsAdvert\Actions\Sms;

(new Sms($phone, $message))
    ->filters($filters)
    ->handle();

The action resolves the provider endpoint, sends shortTextMessage, and always includes the callback route so delivery updates can be persisted locally.

API

HTTP routes

• GET api/integrations/smsAdvert/settings
• PATCH api/integrations/smsAdvert/settings/{settings}
• POST api/integrations/smsAdvert/callbacks/sms

Action

• LaravelEnso\\SmsAdvert\\Actions\\Sms

Behavior:

• sends a short or long SMS payload
• applies outbound filter objects
• appends the local callback URL

Depends On

Required Enso packages:

• laravel-enso/api ↗
• laravel-enso/core ↗
• laravel-enso/enums ↗
• laravel-enso/helpers ↗
• laravel-enso/sale-channels ↗

Companion frontend package:

• @enso-ui/sms-advert ↗