PHPackages archintel-dev/laravel-ses - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. archintel-dev/laravel-ses ActiveLibrary[Mail & Notifications](/categories/mail) archintel-dev/laravel-ses ========================= Allows you to track opens, deliveries, bounces, complaints and clicked links when sending emails through Laravel and Amazon SES. Credits to Oliver Eady <oliveready7@gmail.com>. v1.1.2(6y ago)022MITPHP Since Oct 2Pushed 6y ago1 watchersCompare [ Source](https://github.com/archintel-developer/laravel-ses)[ Packagist](https://packagist.org/packages/archintel-dev/laravel-ses)[ RSS](/packages/archintel-dev-laravel-ses/feed)WikiDiscussions master Synced 2mo ago READMEChangelogDependencies (8)Versions (8)Used By (0) laravel-ses =========== [](#laravel-ses) A Laravel 5.5+ Package that allows you to get simple sending statistics for emails you send through SES, including deliveries, opens, bounces, complaints and link tracking. ###### Cloned from [oliveready7/laravel-ses](https://github.com/oliveready7/laravel-ses) [](#cloned-from-oliveready7laravel-ses) ###### SesCompanion - Updated and added some features on existing package. [Instructions](https://packagist.org/packages/archintel-dev/ses-companion) [](#sescompanion---updated-and-added-some-features-on-existing-package-instructions) Install via composer Add to composer.json ``` composer require archintel-dev/laravel-ses ``` Make sure your app/config/services.php has SES values set ``` 'ses' => [ 'key' => your_ses_key, 'secret' => your_ses_secret, 'domain' => your_ses_domain, 'region' => your_ses_region, ], ``` Important to note that if you're using an IAM, it needs access to SNS (for deliveries, bounces and complaints) as well as SES Make sure your mail driver located in app/config/mail.php is set to 'ses' Publish these two service providers ``` php artisan vendor:publish --provider="ArchintelDev\LaravelSes\LaravelSesServiceProvider" ``` then ``` php artisan vendor:publish --provider="ArchintelDev\SesCompanion\SesCompanionServiceProvider" ``` You can find the package installation instruction [here](https://packagist.org/packages/archintel-dev/ses-companion). Config Options - aws\_sns\_validator - whether the package uses AWS's SNS validator for inbound SNS requests. Default = false Run command in **production** to setup Amazon email notifications to track bounces, complaints and deliveries. Make sure in your configuration your app URL is set correctly. If your application uses the http protocol instead of https add the --http flag to this command ``` php artisan setup:sns ``` Usage ----- [](#usage) **You can use the added features [here](https://packagist.org/packages/archintel-dev/ses-companion).** To send an email with all tracking enabled ``` SesMail::enableAllTracking() ->to('hello@example.com') ->send(new Mailable); ``` All tracking allows you to track opens, bounces, deliveries, complaints and links You can, of course, disable and enable all the tracking options ``` SesMail::disableAllTracking(); SesMail::disableOpenTracking(); SesMail::disableLinkTracking(); SesMail::disableBounceTracking(); SesMail::disableComplaintTracking(); SesMail::disableDeliveryTracking(); SesMail::enableAllTracking(); SesMail::enableOpenTracking(); SesMail::enableLinkTracking(); SesMail::enableBounceTracking(); SesMail::enableComplaintTracking(); SesMail::enableDeliveryTracking(); ``` The batching option gives you the chance to group emails, so you can get the results for a specific group ``` SesMail::enableAllTracking() ->setBatch('welcome_emails') ->to('hello@example.com') ->send(new Mailable); ``` You can manipulate the results manually by querying the database. Or you can use functions that come with the package. ``` SesMail::statsForBatch('welcome_emails'); //example result [ "send_count" => 8, "deliveries" => 7, "opens" => 4, "bounces" => 1, "complaints" => 2, "click_throughs" => 3, "link_popularity" => collect([ "https://welcome.page" => [ "clicks" => 3 ], "https://facebook.com/brand" => [ "clicks" => 1 ] ]) ] ``` Send count = number of emails that were attempted Deliveries = number of emails that were delivered Opens = number of emails that were opened Complaints = number of people that put email into spam Click throughs = number of people that clicked at least one link in your email Link Popularity = number of unique clicks on each link in the email, ordered by the most clicked. ### API INFO [](#api-info) Data always has the 'success' key indicating whether the request was successful or not 400 bad request = validation for the endpoint failed 404 = something in your query was not found 422 = any other error that might have occurred `GET /laravel-ses/api/has/bounced/{email}` #### Parameters - none [](#parameters---none) #### Response [](#response) ``` { "success": "true", "bounced": "true", "bounces": [ { "message_id":"7a", "sent_email_id": "1", "type": "Permanent", "email": "harrykane@gmail.com", "bounced_at": "2018-01-01 12:00:00" } ] } ``` `GET /laravel-ses/api/has/complained/{email}` #### Parameters - none [](#parameters---none-1) #### Response [](#response-1) ``` { "success": "true", "complained": "true", "complaints": [ { "message_id":"8b", "sent_email_id": "23", "type": "abuse", "email": "wanyama@hotmail.com", "complained_at": "2018-01-02 09:12:00" } ] } ``` `GET /laravel-ses/api/stats/batch/{batchName}` #### Parameters - none [](#parameters---none-2) #### Response [](#response-2) ``` { "success": "true", "data": { "success":true, "data": { "send_count":0, "deliveries":0, "opens":0, "bounces":0, "complaints":0, "click_throughs":0, "link_popularity":[] } } } ``` `GET /laravel-ses/api/stats/email/{email}` #### Parameters - none [](#parameters---none-3) #### Response [](#response-3) ``` { "success": true, "data": { "counts": { "sent_emails": 3, "deliveries": 2, "opens": 1, "bounces": 1, "complaints": 1, "click_throughs": 2 }, "data": { "sent_emails": [ { "id": 1, "message_id": "d3e2028a324fde23363ec3a073ecd436@swift.generated", "email": "something@gmail.com", "batch": "welcome_emails", "sent_at": "2018-03-18 10:28:26", "delivered_at": "2017-08-25 07:58:40", "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" }, { "id": 9, "message_id": "b623bf23064c088fa044a58f22ddacad@swift.generated", "email": "something@gmail.com", "batch": "win_back", "sent_at": "2018-03-18 10:28:26", "delivered_at": "2017-08-25 07:58:40", "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" }, { "id": 10, "message_id": "ec100dcd13ce91b6b28002173564d1b9@swift.generated", "email": "something@gmail.com", "batch": "june_newsletter", "sent_at": "2018-03-18 10:28:26", "delivered_at": null, "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" } ], "deliveries": [ { "id": 1, "message_id": "d3e2028a324fde23363ec3a073ecd436@swift.generated", "email": "something@gmail.com", "batch": "welcome_emails", "sent_at": "2018-03-18 10:28:26", "delivered_at": "2017-08-25 07:58:40", "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" }, { "id": 9, "message_id": "b623bf23064c088fa044a58f22ddacad@swift.generated", "email": "something@gmail.com", "batch": "win_back", "sent_at": "2018-03-18 10:28:26", "delivered_at": "2017-08-25 07:58:40", "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" } ], "opens": [ { "id": 1, "sent_email_id": "1", "email": "something@gmail.com", "batch": "welcome_emails", "beacon_identifier": "bfd935de-2219-4f86-9bd3-24afd06cc37a", "url": "https://laravel-ses.com/laravel-ses/beacon/bfd935de-2219-4f86-9bd3-24afd06cc37a", "opened_at": "2018-03-18 10:28:26", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" } ], "bounces": [ { "id": 3, "message_id": "b623bf23064c088fa044a58f22ddacad@swift.generated", "sent_email_id": "9", "type": "abuse", "email": "something@gmail.com", "complained_at": "2017-08-25 07:58:39", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" } ], "complaints": [ { "id": 3, "message_id": "b623bf23064c088fa044a58f22ddacad@swift.generated", "sent_email_id": "9", "type": "abuse", "email": "something@gmail.com", "complained_at": "2017-08-25 07:58:39", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26" } ], "click_throughs": [ { "id": 1, "link_identifier": "0f14e25d-4712-4a9a-be6b-b190dc1a31b3", "sent_email_id": "1", "original_url": "https://google.com", "batch": "welcome_emails", "clicked": "1", "click_count": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26", "message_id": "d3e2028a324fde23363ec3a073ecd436@swift.generated", "email": "something@gmail.com", "sent_at": "2018-03-18 10:28:26", "delivered_at": "2017-08-25 07:58:40", "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1" }, { "id": 1, "link_identifier": "c7933d15-8e22-41e7-9074-e327ee02cf1a", "sent_email_id": "1", "original_url": "https://superficial.io", "batch": "welcome_emails", "clicked": "1", "click_count": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26", "message_id": "d3e2028a324fde23363ec3a073ecd436@swift.generated", "email": "something@gmail.com", "sent_at": "2018-03-18 10:28:26", "delivered_at": "2017-08-25 07:58:40", "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1" }, { "id": 9, "link_identifier": "be2d0bc9-87b7-48cc-8b57-6b714bfc9d48", "sent_email_id": "9", "original_url": "https://google.com", "batch": "win_back", "clicked": "1", "click_count": "1", "created_at": "2018-03-18 10:28:26", "updated_at": "2018-03-18 10:28:26", "message_id": "b623bf23064c088fa044a58f22ddacad@swift.generated", "email": "something@gmail.com", "sent_at": "2018-03-18 10:28:26", "delivered_at": "2017-08-25 07:58:40", "complaint_tracking": "1", "delivery_tracking": "1", "bounce_tracking": "1" } ] } } ``` ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community4 Small or concentrated contributor base Maturity63 Established project with proven stability How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 7 Last Release 2394d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5eddcdbc4bfcd1708af032797626ef8b81b0bf28efaf93104534a6944e5c0803?d=identicon)[archintel-developer](/maintainers/archintel-developer) ### Embed Badge ![Health badge](/badges/archintel-dev-laravel-ses/health.svg) ``` [![Health](https://phpackages.com/badges/archintel-dev-laravel-ses/health.svg)](https://phpackages.com/packages/archintel-dev-laravel-ses) ``` ### Alternatives [jdavidbakr/mail-tracker Logs and tracks all outgoing emails from Laravel 6181.2M1](/packages/jdavidbakr-mail-tracker)[laravel-notification-channels/aws-sns Amazon Simple Notification Service (AWS SNS) notification channel for Laravel. 541.1M2](/packages/laravel-notification-channels-aws-sns)[putyourlightson/craft-campaign Send and manage email campaigns, contacts and mailing lists. 6435.0k1](/packages/putyourlightson-craft-campaign)[juhasev/laravel-ses Allows you to track opens, deliveries, bounces, complaints and clicked links when sending emails through Laravel and Amazon SES 1710.0k](/packages/juhasev-laravel-ses)[sunaoka/laravel-ses-template-driver Amazon SES template mail driver for Laravel. 1088.0k](/packages/sunaoka-laravel-ses-template-driver) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)