tomatophp/filament-twilio

Filament Twilio

Send Whatsapp messages using Twilio and native filament Notification Facade class

Screenshots

Requirements

The Filament v3 line continues on the v3 branch.

Installation

composer require tomatophp/filament-twilio

Using

first of all you need to add this variables to your .env file

TWILIO_SID=
TWILIO_TOKEN=
TWILIO_SENDER_NUMBER=

then clear you cache

php artisan config:cache

Messages are sent from a queued job to the model's phone column (E.164 format, for example +201000000000). Users without a phone number are skipped, and nothing is sent until the SID, token and sender number are configured.

now on your User model add this trait

use TomatoPHP\FilamentTwilio\Traits\InteractsWithTwilioWhatsapp;

class User extends Authenticatable
{
    use InteractsWithTwilioWhatsapp;
}

now you are ready to use the notification

\Filament\Notifications\Notification::make()
    ->body('Your Message You Like To Send Here!')
    ->sendToTwilioWhatsapp(
        user: $user,
        mediaURL: "https://images.unsplash.com/photo-1545093149-618ce3bcf49d?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=668&q=80"
    );

or you can use it from user model direct

$user->notifyTwilioWhatsapp(
    message: 'Your Message You Like To Send Here!',
    mediaURL: "https://images.unsplash.com/photo-1545093149-618ce3bcf49d?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=668&q=80"
);

Publish Assets

you can publish config file by use this command

php artisan vendor:publish --tag="filament-twilio-config"

Testing

The Twilio client is resolved from the container, so you can swap it in your own tests (the package suite uses a fake Twilio\Http\Client and never calls Twilio):

composer test

Other Filament Packages

Checkout our Awesome TomatoPHP