Dans une application, il arrive qu'on ait besoin d'envoyer des emails de manière automatique. Dans ce blog, je vais vous montrer comment vous pouvez envoyer des emails dans une application sailsjs avec le service de messagerie automatique mailgun. Si vous ne connaissez pas le framework sailsjs, je vous conseille de lire mon blog qu'est ce que sailsjs.
Création du compte mailgun pour sailsjs
Pour utiliser le service de messagerie mailgun, vous devez créer un compte gratuitement sur le site de mailgun. Une fois le compte créé vous aurez un domain (sandbox) et une API Key. Vous retrouverez ces information dans votre espace mailgun comme le montrent les images ci-dessous.
Configuration de mailgun dans sailsjs
Nous allons maintenant configurer mailgun dans sailsjs. Nous allons d'abord installer le module mailgun puis definir quelques variables.
Installer le module mailgun
npm install mailgun-js --save
Cette commande va installer le module mailgun dans votre application sailsjs.
Après installation, ouvrez le fichier config/custom.js et definissez les 3 variables suivantes:
mailgunDomain: 'votre_domaine_mailgun',
mailgunSecret: 'Votre_api_key',
mailgunFrom:'Email_source',
Création d'un helper pour envoyer les emails
Nous allons maintenant créer un helper dans notre application sailsjs pour envoyer les emails. Un helper dans une application sailsjs est comme un service que vous pouvez appeler depuis n'importe quel controller.
sails generate helper send-single-email
Cette commande va générer la structure d'un helper. Modifier le code comme ci-dessous.
var mailgun = require('mailgun-js')({apiKey: sails.config.custom.mailgunSecret, domain: sails.config.custom.mailgunDomain});
module.exports = {
friendlyName: 'Send single email',
description: '',
inputs: {
options:{
type:'json'
}
},
exits: {
},
fn: async function (inputs, exits) {
mailgun.messages().send(inputs.options, function (error, body) {
if(error){
return exits.error(error)
}
// All done.
return exits.success(body);
});
}
};
Notre helper prend comme input un objet de type json.
Envoi des emails depuis un controller
Une fois votre helper créé, vous pouvez l'appeller depuis n'importe quel controller de votre application sailsjs.
await sails.helpers.mail.sendSingleEmail({
to:'destination@email.com',
from:sails.config.custom.mailgunFrom,
subject:'Sujet',
text:'Votre message'
})
C'est terminé. Vous pouvez donc envoyer des emails avec sailsjs at mailgun. Dans un prochain blog, je vous expliquerai comment envoyer un mail avec un template pour une meilleure présentation de votre message.
