Transport Laravel

Votre application Laravel garde ses Mailable et ses Mail::to(...)->send(...). Le transport les remet à l’API transactionnelle de Lekalao, qui les envoie avec le fournisseur choisi et les garde dans son journal : livraisons, rebonds, ouvertures, clics.

Installer

Le paquet lekalao/laravel-transport est livré avec Lekalao, dans packages/laravel-transport. Laravel 11, 12 ou 13, PHP 8.2 ou plus. Depuis l’application qui envoie, déclarez le dépôt puis installez :

composer.json

{
    "repositories": [
        { "type": "path", "url": "../lekalao/packages/laravel-transport" }
    ],
    "require": {
        "lekalao/laravel-transport": "*"
    }
}

composer update lekalao/laravel-transport

Le fournisseur de services est découvert tout seul. Si l’application est sur une autre machine, copiez le dossier dans le dépôt de l’application ou publiez-le sur votre dépôt Composer privé.

Configurer

Créez un jeton Lecture et écriture dans Lekalao, puis dans config/mail.php :

config/mail.php

'mailers' => [
    // …
    'lekalao' => [
        'transport' => 'lekalao-api',
        'endpoint' => env('LEKALAO_URL'),   // https://api.lekalao.com/v1
        'token' => env('LEKALAO_TOKEN'),
    ],
],

.env

MAIL_MAILER=lekalao
LEKALAO_URL=https://api.lekalao.com/v1
LEKALAO_TOKEN=12|kJ3v8mQ2xP9…

endpoint est la racine versionnée de l’API : https://api.lekalao.com/v1 sur le service Lekalao, https://votre-domaine/api/v1 sur votre propre installation.

La clé s’appelle endpoint, pas url : Laravel lit la clé url d’un mailer comme une adresse de connexion SMTP.

Pour n’utiliser Lekalao que pour certains e-mails, laissez votre MAIL_MAILER et choisissez au cas par cas :

Mail::mailer('lekalao')->to($order->customer)->send(new OrderConfirmed($order));

Ce qui passe

Élément
Destinataires	`to`, `cc`, `bcc`.
Objet	Tel quel.
Corps	Le HTML. Un message texte seul est affiché tel qu’écrit.
Expéditeur, réponse	Tels quels. L’expéditeur doit être autorisé par Lekalao.
Pièces jointes	Toutes.

L’identifiant de l’e-mail dans Lekalao devient le Message-ID du message envoyé, ce qui permet de le retrouver dans le journal.

Choisir le fournisseur d’envoi

Ajoutez l’en-tête X-Lekalao-Mailer avec le nom d’un fournisseur configuré dans Lekalao :

public function headers(): Headers
{
    return new Headers(text: ['X-Lekalao-Mailer' => 'Postmark transactionnel']);
}

Erreurs

Un refus de Lekalao (expéditeur non autorisé, jeton révoqué, tous les destinataires dans la liste de suppression, quota épuisé) remonte comme une Symfony\Component\Mailer\Exception\TransportException qui porte le code HTTP et la raison. Envoyez vos e-mails en file (ShouldQueue) pour que Laravel réessaie tout seul. Une fois l’e-mail pris par Lekalao, send() rend la main : le fournisseur le reçoit un instant plus tard, depuis la file de Lekalao, avec de nouveaux essais pendant six heures s’il échoue. Ce qu’il est devenu se lit dans le journal transactionnel, et dans l’API par l’identifiant du message. Voir La réponse. Le délai d’attente est de 15 secondes.

L'API

Recettes

Intégrations

Transport Laravel

Installer

Configurer

Ce qui passe

Choisir le fournisseur d’envoi

Erreurs

​Installer

​Configurer

​Ce qui passe

​Choisir le fournisseur d’envoi

​Erreurs

Installer

Configurer

Ce qui passe

Choisir le fournisseur d’envoi

Erreurs