Download the PHP package norialabs/send without Composer

Noria Send for Laravel

Send transactional email and SMS through Noria Send instead of wiring SES and OnFon into every product. Registers a Laravel mail transport and an SMS notification channel, so Mail::send() and $user->notify() keep working exactly as they do today.

This repository is a read-only split of sdks/php in norialabs/send. Open pull requests there; the mirror is force-pushed on every release and anything committed here is lost.

NORIA_SEND_URL defaults to https://send.noria.co.ke; set it to reach a local service or another instance.

Everything else the package reads, with its default:

Sending never blocks on the provider, so the timeout covers the enqueue call rather than delivery, and two retries are about a service restart rather than a bounce.

That is the whole email integration. Every Mail::send(), Mail::to()->queue(), notification and mailable in the application now goes through the service and gets queueing, retries, suppression, delivery events and per-workspace isolation without touching a call site.

SMS

SMS arrives as a notification channel, which is how Laravel expects to send it.

The notifiable says where it goes:

toSendSms() may also return a plain string. To send a stored template instead of a body, use SmsMessage::make()->template('otp', ['code' => $code]).

Beyond the transport

The client is bound in the container and available as a facade, grouped by resource.

Each accessor returns a typed resource object, so PHPStan resolves the methods on it without a hand-maintained @method list.

Per-message options

Set headers on a mailable; the transport strips them and maps them onto the API.

Any other custom header is passed through to the message itself.

Suppressed recipients

By default a send to a suppressed address or number is a no-op rather than an exception, so one opt-out cannot fail a queued job or a batch notification. Set NORIA_SEND_FAIL_ON_SUPPRESSED to raise SendException instead.

Webhooks

An interrupted send is retried by the client, and the client attaches an idempotency key of its own so the retry is a replay rather than a second message. Pass your own key when you want that guarantee to span your retries too, not only the SDK's.

Set NORIA_SEND_WEBHOOK_SECRET to the secret shown once when the endpoint was created.

Delivery is at-least-once: a retry or a provider redelivery can bring the same event twice. $event['id'] — the Noria-Event-Id header — is stable across both, so record it and ignore an id you have already handled.

Requirements

PHP 8.3 or newer, and Laravel 13. Laravel 11 and 12 were dropped: every Noria product is moving to 13, and supporting three majors meant the test suite ran against 12 and never against the version we actually ship on — which is how a Laravel 13 container-binding change sat unnoticed. ^8.3 is the framework's own floor and admits 8.6 when it arrives.

Tests

tests/LiveTest.php runs against a real instance and is skipped unless you point it at one:

That reaches http://localhost:4800, so it exercises a service you are running yourself. Set NORIA_SEND_LIVE_URL to aim it elsewhere. The SMS case additionally needs NORIA_SEND_LIVE_MSISDN set to a number you control, because it sends a real message.