Transactional mails

Using Laravel

You can use Mailcoach to send all mails for your Laravel application. Behind the scenes, we'll use separate servers to send your bulk campaigns and transactional mails.

Sending transactional mails using Mailcoach in a Laravel app

To send transactional emails from your Laravel through Mailcoach, install our Laravel Mailcoach Mailer package.

composer require spatie/laravel-mailcoach-mailer

In your mail.php config file, you must add a mailer in the mailers key that uses the mailcoach transport. You should also specify your mailcoach domain (this is the first part) and a Mailcoach API token. In many cases, you also want to make Mailcoach the default mailer in your app.

Here's an example:

// in config/mail.php
    
'default' => 'mailcoach',

'mailers' => [
    'mailcoach' => [
        'transport' => 'mailcoach',
        'domain' => '<your-mailcoach-subdomain>.mailcoach.app',
        'token' => '<your-api-token>',
    ],
],

You'll find the Mailcoach subdomain by simply looking at any URL of the Mailcoach UI. You can create an API token on the API token screen in the settings.

screenshot

You can run this artisan command to test if everything is set up correctly.

php artisan mailcoach-mailer:send-test

This above command will try to send a transactional mail through Mailcoach using your configuration.

screenshot

Look in your mailbox for the mail sent.

screenshot

With this setup out of the way, you can send emails like you're used to.

// will be sent through mailcoach

Mail::to('john@example.com')->send(new OrderShippedMail());

Editing the content of your emails on Mailcoach

Instead of saving the content of your emails in Mailable classes in your app, you can administer them in the Mailcoach UI. This way, non-technical people, such as marketeers, can edit the content of emails without a developer having to push code changes.

To get started, first create a template. A template is used to store the basic layout of your mail. Typically you would only set this up just once.

Next, you can create an email on the Transactional > Email screen.

screenshot

On the created email, which we named order-confirmation, you can pick the template you want to use and specify the subject and content of the mail.

screenshot

As you can see in the screenshot above, you can add placeholders, such as ::productName:: to your mail.

In your Laravel app, here's how you would create a mailable that uses that order-confirmation mail. Don't forget to apply that UsesMailcoachMail on your mailable.

namespace App\Mails;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Envelope;
use Illuminate\Queue\SerializesModels;
use Spatie\MailcoachMailer\Concerns\UsesMailcoachMail;

class OrderConfirmationMail extends Mailable
{
    use Queueable, 
    use SerializesModels, 
    use UsesMailcoachMail;

    public function __construct(
        protected Product $product,
        protected Carbon $shippingDate,
    ) {}

    public function build()
    {
        $this
            ->mailcoachMail('order-confirmation', [
                'productName' => $this->productName,
                'shippingDate' => $this->shippingDate->format('Y-m-d'),
            ]);
    }
}

Now you can send that order confirmation like you're used to.

Mail::to('happy@customer.com')->send(new OrderConfirmation($product, $shippingDate));

Should any changes be needed to the copy of the order confirmation, your marketeer can edit the content of the mail on Mailcoach. No code changes are needed in your app.

Next
Using Symfony Mailer