Send SMS (Sendsms.ro)

Description

Send SMS integrates the Enso SMS notification flows with the Sendsms.ro API.

The package stores the remote credentials, exposes the settings endpoints used by the admin UI, and provides a small service/action/endpoint chain for sending messages through the Sendsms.ro JSON API.

It is intended for private deployments that need Sendsms.ro as a text messaging provider.

Installation

This is a proprietary package distributed through the private Enso registry or a private path repository.

Run the package migrations after installation:

php artisan migrate

Then configure the integration from the Send SMS settings screen. The settings record stores:

• API endpoint URL
• account credentials (username, password)
• enabled flag

Optional config publish:

php artisan vendor:publish --tag=send-sms-config

Config file: config/enso/send-sms.php

return [
    'settingsId' => env('SENDSMS_SETTINGS_ID', 1),
];

Features

• Settings API for enabling the integration and storing credentials securely with encrypted username and password casts.
• Sms service and action classes for sending messages through the native Enso API client flow.
• Endpoint abstraction that builds Sendsms.ro requests with the configured credentials and default JSON URL fallback.
• Built-in validation for phone numbers, requiring a leading + and numeric digits only.
• Specific API and phone-number exception handling.

Usage

Enable the integration from the settings form before using the SMS flow.

To send an SMS message programmatically, you can simply use the exposed service class:

use LaravelEnso\SendSms\Services\Sms;

$phone = '+407XXYYYZZZ';
$message = 'Test message via Sendsms.ro API';

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

The package exposes the following core service classes:

• LaravelEnso\SendSms\Services\Sms
• LaravelEnso\SendSms\Actions\Sms
• LaravelEnso\SendSms\Endpoints\Sms

The endpoint uses the configured URL when present and otherwise falls back to:

https://api.sendsms.ro/json

API

HTTP routes

Settings:

• GET api/integrations/sendSms/settings
• PATCH api/integrations/sendSms/settings/{setting}

Core classes

Depends On

Required Enso packages:

• laravel-enso/api ↗
• laravel-enso/helpers for encrypted settings casts

Companion frontend package:

• @enso-ui/send-sms