Download the PHP package ahmedwaleed/mailmerge without Composer

Introduction

MailMerge is meant to provide a handful of APIs to send all sorts of emails including (batch mails, single mail) using different mail service providers such as mailgun, pepipost, and sendgrid. It also defines the strategy for resending the failed emails using different mail services.

Requirements

• PHP >= 7.4
• Laravel >= 6.0
• Redis

MailMerge uses redis for saving events and logs so you must have redis install on your host.

Installation

MailMerge will automatically register itself using package discovery.

Once Composer is done, run the following command, it will migrate mailmerge migrations:

Configuring the package

You can publish the config file with:

This is the contents of the file that will be published at config/mailmerge.php:

Please set your required env vars for all services specified in the config files. 'default' => env('DEFAULT_SERVICE', 'mailgun') set this options for your default service which will be used when no service is explicitly specified when using mailmerge api.

Usage

This package registered all api endpoint you need, run php artisan route:list to see all available endpoints.

Authentication

MailMerge uses very simple authentication method all you have to do is pass an authorization signature in the request header.

Send Single Email Message

• Api Endpoint

• Example Request Parameters

• Example Response

• Example Code

Send Batch (Bulk Emails) Message

• Api Endpoint

• Example Request Parameters

• Example Response

• Example Code

service

You can specify service in the api headers which you want to use for sending message For example:

cc, bcc

MailMerge also allows you to add cc and bcc to your message, you can add those in your request body. For example.

attachment

With MailMerge you can send one or more attachments with batch message.

* Batch Mail Template MailMerge uses its own email placeholder template for recipients custom attributes (variables) because of different integration of MSP so you don't have to worry about syntax different services. - Syntax `<% attribute.custom_attribute_name %>` - Example ## Re-Send Batch Message * Api Endpoint Sending a batch message can be a time taking task on user end, it may take time for you to arrange all the recipents list that you want to send as batch message and what if your batch message failed so instead of doing all the heavy work again and again with MailMerge its now possible to resend your batch message using different service (mailgun, pepipost, sendgrid). MailMerge saves all of your sent batch messages so you can retry that batch message in future in case of some system failure or if there are so many failed or bounced emails, when you retry or resend batch message it handle the logic of sending that batch message only for failed recipients from last batch so you can retry that batch message as many times as you want until all the emails from that batch are sent successfully. MailMerge provide a default view for handling your batch messages.  but you're free to modify it as per your need. You can run below command to publish MailMerge default view of resending batch messages. Once the view is published you can find it inside `resources/views/vendors/mailmerge` directory. ## Logging MailMerge provides centralized logging system for all supported email services using webhooks support, MailMerge register endpoint for each services so that you can add that url into your mail api webhook settings. You can find related docs for webhooks in following links: [mailgun](https://documentation.mailgun.com/en/latest/user_manual.html#webhooks), [pepipost](https://pepipost.com/features/webhooks/), [sendgrid](https://sendgrid.com/docs/for-developers/tracking-events/getting-started-event-webhook/). Whenever there is new log your mail service will hit that webhook url and MailMerge handle that request and saves that log into redis server. ### Get Logs - Request Query Parameters - Items: (optional) By default, the API will return 10 items but you can pass items param in a query to get items as per your need. - Service (required) * Example Response - Original Response: It include original payload from mail service. - Normalized Response: Normalized response that will be consistent across multiple services. ## License MailMerge is licensed under the [MIT License](http://opensource.org/licenses/MIT).