Passer au contenu principal
D’un jeton d’API à un e-mail dans votre propre boîte : un modèle dans l’interface, un appel depuis votre code, une lecture pour le voir partir.
Pas encore de fournisseur d’envoi ni de domaine vérifié ? Une clé de test déroule chaque étape ci-dessous sans rien envoyer : écrivez à delivered@sink.lekalao.dev au lieu de votre propre adresse, et l’e-mail est journalisé, marqué sent et signalé délivré, webhooks compris.

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é.
Gardez-le sur votre serveur. Voir Authentification.

2. Écrivez le modèle

Transactionnel → Modèles transactionnels → Nouveau modèle. Nommez-le confirmation-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.
Enregistrer l’e-mail. Le nom est ce que votre application envoie ; le reste peut changer sans toucher à votre code. Voir Modèles transactionnels.

3. Envoyez-le

Mettez votre propre adresse dans to, pour voir l’e-mail arriver. Une adresse qui n’existe pas rebondit, et part dans votre liste de suppression.
Sur votre propre installation, l’adresse est 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 son id :
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.