Avec le nouveau endpoint /send/batch, vous envoyez plusieurs e-mails en une seule requête API. Pratique lorsque votre application génère plusieurs e-mails en même temps, par exemple après le traitement d'un import ou lors de la gestion d'une queue.
Qu'est-ce que batch email ?
Au lieu de faire une requête séparée pour chaque e-mail, vous les regroupez et envoyez tout en une fois. Vous envoyez un array avec jusqu'à 500 e-mails vers l'endpoint /send/batch de Lettermint.
Batch email peut être utilisé de différentes manières. Envoyez des e-mails complètement uniques avec différents destinataires, sujets et contenus. Ou envoyez le même e-mail à plusieurs destinataires en une fois, comme une newsletter.
Ainsi, vous évitez d'envoyer des centaines de requêtes séparées à notre API en peu de temps. Plus de longues boucles qui envoient les e-mails un par un. À la place, vous regroupez tout et l'envoyez en une seule requête.
Comment ça marche ?
L'endpoint batch supporte les mêmes options que notre endpoint /send standard pour les e-mails transactionnels. Vous pouvez donc travailler avec des pièces jointes, des tags, des routes et toutes les autres fonctionnalités que vous connaissez.
Un exemple avec curl :
curl --request POST \
--url https://api.lettermint.co/v1/send/batch \
--header 'x-lettermint-token: your-api-key' \
--header 'Content-Type: application/json' \
--data '{
"messages": [
{
"from": "shop@example.com",
"to": "customer1@example.com",
"subject": "Your order is ready",
"html": "Your order has been shipped."
},
{
"from": "shop@example.com",
"to": "customer2@example.com",
"subject": "Your order is ready",
"html": "Your order has been shipped."
}
]
}'
Vous recevrez une réponse avec un message_id pour chaque e-mail. Utilisez celui-ci pour suivre le statut de chaque e-mail via le tableau de bord ou via webhooks.
Disponibilité
L'endpoint batch est disponible pour tous les utilisateurs, y compris notre plan gratuit. Vous pouvez envoyer jusqu'à 500 e-mails par requête avec une taille maximale de 25MB. Cela inclut les éventuelles pièces jointes. Fonctionne aussi bien pour les e-mails transactionnels que les e-mails broadcast.
Vous envoyez plus de 500 e-mails ? Divisez-les en plusieurs requêtes batch. Consultez la documentation complète sur docs.lettermint.co.