macellan/twilio

Twilio SMS notification channel for Laravel

v2.0.0 2025-03-25 08:32 UTC

Requires

• php: ^8.2
• illuminate/notifications: ^12.0
• illuminate/support: ^12.0
• twilio/sdk: ^8.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0|^12.0

MIT

• Arif Demir

• sms
• twilio
• notification
• laravel
• macellan

README

This package makes it easy to send sms notifications using Twilio with Laravel 12.x

Contents

• Installation
  • Setting up the Twilio service
• Usage
  • On-Demand Notifications
• Testing
• Changelog
• Credits

Installation

You can install this package via composer:

composer require macellan/twilio

Setting up the Twilio service

Add your Twilio configs to your config/services.php:

// config/services.php
...
    'sms' => [
        'twilio' => [
            'account_sid' => env('TWILIO_ACCOUNT_SID', ''),
            'auth_token' => env('TWILIO_AUTH_TOKEN', ''),
            'from' => env('TWILIO_FROM', ''),
            'enable' => env('TWILIO_ENABLE', false),
            'debug' => env('TWILIO_DEBUG', false), // Will log sending attempts and results
            'sandbox_mode' => env('TWILIO_SANDBOX_MODE', false), // Will not invoke API call
        ],
    ],
...

Usage

You can use the channel in your via() method inside the notification:

use Illuminate\Notifications\Notification;
use Macellan\Twilio\TwilioSmsMessage;

class TestNotification extends Notification
{
    public function via($notifiable): array
    {
        return ['twilio'];
    }

    public function toTwilio(object $notifiable): TwilioSmsMessage
    {
        return new TwilioSmsMessage('Twilio test message');
    }
}

In your notifiable model, make sure to include a routeNotificationForSms() method, which returns a phone number.

public function routeNotificationForSms(): string
{
    return $this->phone;
}

On-Demand Notifications

Sometimes you may need to send a notification to someone who is not stored as a "user" of your application. Using the Notification::route method, you may specify ad-hoc notification routing information before sending the notification:

Notification::route('sms', '[phone]')  
            ->notify(new TestNotification());

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Credits

• Arif Demir