jfunu/laravel-ses-manager

Logs SES bounces and complaints for Laravel app

dev-master 2024-11-29 07:12 UTC

Requires

• ext-curl: *
• ext-json: *
• aws/aws-php-sns-message-validator: ^1.5
• illuminate/support: ^5.8 | ^6.0 | ^7.0 | ^8.0 | ^9.0 | ^10.0 | ^11.0

Requires (Dev)

• orchestra/testbench: ^3.8 | ^8.0

MIT

• jfunulab

• laravel

README

Logs AWS Simple Email Service bounces and complaints for Laravel app

Setup

composer require Megaverse/laravel-ses-manager
php artisan migrate

• Add the routes to your controller and off you go

// api.php
Route::post('/webhooks/ses/bounce', [Megaverse\LaravelSesManager\Controllers\SESWebhookController::class, 'bounce']);
Route::post('/webhooks/ses/complaint', [Megaverse\LaravelSesManager\Controllers\SESWebhookController::class, 'complaint']);

• Map the hooks in your SES dashboard to the your application routes.

Usage

Use Megaverse\LaravelSesManager\Eloquent\BlackListItem is the model for blacklisted emails.

// check if email is blacklisted
$blackListItem = Megaverse\LaravelSesManager\Eloquent\BlackListItem::query()
  ->whereNotNull('blacklisted_at')
  ->where('email', $email)
  ->first();

// whitelist email while keeping it in the history
$blackListItem->delete();

// remove email and remove it from the history
$blackListItem->forceDelete();