Avant de commencer
Les cinq minutes commencent quand ces trois conditions sont remplies. Les deux premières dépendent de votre fournisseur et de votre DNS, pas de Lekalao : elles peuvent prendre plus longtemps.1
Un fournisseur d'envoi qui envoie
Lekalao n’envoie rien lui-même : il remet chaque e-mail à un fournisseur. Paramètres → Fournisseurs d’envoi liste ceux que votre équipe peut utiliser : les vôtres, et celui que le service partage avec toutes les équipes quand il en propose un. L’un d’eux doit être choisi pour les E-mails transactionnels, ou être le Fournisseur par défaut.Si la liste est vide, Ajouter un fournisseur d’envoi (SES, Postmark, Mailgun, SendGrid, Brevo, Resend ou SMTP), puis Envoyer un e-mail de test : il prouve les identifiants. Voir Fournisseurs d’envoi.
2
Un expéditeur sur un domaine vérifié
Sur le service Lekalao, l’adresse d’expédition doit être sur un domaine que votre équipe a ajouté et vérifié dans Délivrabilité. Sinon l’appel est refusé (
422), et le message nomme le domaine. Les enregistrements DNS mettent de quelques minutes à quelques heures à être vus : commencez par là. Voir Domaines d’envoi.Sur votre propre installation, cela ne s’applique que si son administrateur l’exige.3
Le bon rôle
Créer un jeton demande le rôle éditeur ou propriétaire dans l’équipe.
1. Créez un jeton
Paramètres → Jetons d’API → Nouveau jeton. Donnez-lui un nom (« Boutique en ligne »), et sous Ce qu’il peut faire, choisissez Lecture et écriture : envoyer est une écriture, suivre l’e-mail une lecture. Activez Clé de test pour essayer sans envoyer. Créer, puis copiez le jeton : il ne sera plus affiché.2. Écrivez le modèle
Transactionnel → Modèles transactionnels → Nouveau modèle. Nommez-leconfirmation-commande, gardez l’éditeur HTML, Créer. Puis, sur sa page :
-
Objet :
Commande {{ order.number }} confirmée -
le contenu :
- Adresse d’expédition : une adresse de votre domaine vérifié. Vide, celle de l’équipe dans Paramètres → Général est utilisée.
3. Envoyez-le
Mettez votre propre adresse dansto, pour voir l’e-mail arriver. Une adresse qui n’existe pas rebondit, et part dans votre liste de suppression.
https://votre-domaine/api/v1/transactional-mails/send.
L’Idempotency-Key rend l’appel sûr à répéter : envoyé deux fois, il envoie un seul e-mail. Donnez à chaque e-mail sa propre clé, par exemple le numéro de commande et l’action.
4. Lisez la réponse
La réponse arrive dès que Lekalao a écrit l’e-mail dans le journal :202, avec status à pending.
202 Accepted
pending n’est pas un problème : l’e-mail part d’une file d’attente un instant plus tard. Gardez son id.
5. Voyez-le partir
Lisez l’e-mail par sonid :
Quand le fournisseur échoue, Lekalao réessaie pendant six heures au plus avant d’abandonner. Dans votre application, laissez Lekalao vous prévenir plutôt que de demander : les webhooks
transactional.* disent quand l’e-mail est envoyé, délivré, a rebondi ou a échoué.
L’e-mail est aussi dans Transactionnel, le journal, avec son contenu et ses ouvertures. Voir Journal.
Quand il n’arrive pas
Ensuite
Tout sur l'envoi
Sans modèle, pièces jointes, langues, nouveaux essais et renvois.
Webhooks
Envoyé, délivré, rebondi, ouvert : la vie de chaque e-mail, signée, dans votre application.
Depuis Laravel
Gardez
Mail::to()->send(), et envoyez par Lekalao.Erreurs
Chaque code, et quand réessayer.