symfony/prelude-notifier

Symfony Prelude Notifier Bridge

v8.1.0-BETA1 2026-04-30 08:33 UTC

Requires

• php: >=8.4
• symfony/http-client: ^7.4|^8.0
• symfony/notifier: ^7.4|^8.0

Requires (Dev)

• symfony/http-client: ^7.4|^8.0

MIT

• Imad Zairig
• Symfony Community

• symfony
• sms
• notifier
• Prelude

README

The prelude-notifier package provides a Prelude bridge for Symfony Notifier.

Installation

composer require symfony/prelude-notifier

Configuration

1. Register the bundle in your application (if not using Symfony Flex).

2. Configure the DSN in your .env file:

   # API Key is required
   # Sender ID is optional (can be set in options or DSN)
   PRELUDE_DSN=prelude://YOUR_API_KEY@default?sender=YOUR_SENDER_ID

Usage

The Prelude Notify API requires a template_id. You must use PreludeOptions to provide it.

use Symfony\Component\Notifier\Message\SmsMessage;
use Symfony\Component\Notifier\Bridge\Prelude\PreludeOptions;

$options = (new PreludeOptions())
    ->templateId('template_01k8xxxxxxxxxxxxx') // Required
    ->variables([
        'order_id' => '12345',
        'amount' => '$49.99',
    ])
    // Optional parameters
    // ->from('MySenderID')
    // ->locale('fr-FR')
    // ->callbackUrl('https://example.com/webhook')
    // ->preferredChannel('whatsapp')
;

$message = (new SmsMessage('[phone]', 'Subject (ignored)'))
    ->options($options);

$notifier->send($message);

Options

• templateId (string, required): The template identifier.
• variables (array): Key-value pairs for template variables.
• from (string): The Sender ID.
• locale (string): BCP-47 formatted locale string.
• expiresAt (string): Message expiration date (RFC3339).
• scheduleAt (string): Schedule delivery time (RFC3339).
• callbackUrl (string): URL for delivery events.
• correlationId (string): User-defined identifier.
• preferredChannel (string): 'sms' or 'whatsapp'.