Arrière-plan
brainCloud intègre la messagerie électronique de transaction SendGrid. En intégrant brainCloud à leur propre compte SendGrid, les développeurs d'applications peuvent:
Utilisez SendGrid pour tous les e-mails liés à l'authentification des e-mails (validation, réinitialisation du mot de passe, etc.)
Personnalisez les e-mails générés par brainCloud à l'aide de la fonction de modèle de SendGrid
Envoyez des e-mails aux utilisateurs via la nouvelle API brainCloud Mail
Installation
Voici comment intégrer SendGrid avec brainCloud:
Étape 1 – Créez votre compte SendGrid
Si vous ne l'avez pas encore fait, rendez-vous sur http://sendgrid.com et créez un compte. SendGrid propose des comptes gratuits qui vous permettent d'envoyer jusqu'à 12 000 e-mails par mois.
Étape 2 – Créer une clé API SendGrid
Remarque: il peut falloir quelques heures à SendGrid pour provisionner votre nouveau compte, période pendant laquelle vous ne pourrez pas accéder à votre ID d'application SendGrid.
Connectez-vous à SendGrid .
Choisissez la page Paramètres | Clés API dans le menu de gauche.
Cliquez sur [Créer une clé API] en haut à droite, en choisissant l’ option Clé API générale .
Donnez un nom à la clé , par exemple "application brainCloud".
Configurez les autorisations pour la clé API. La documentation de SendGrid n'est pas très complète dans ce domaine. Nous vous recommandons d'accorder à votre clé API les autorisations minimales suivantes :
Envoi de courrier électronique – Accès complet
Activité de courrier électronique – Accès en lecture
Suppressions – Accès complet
Authentification de l'expéditeur – Accès complet
Moteur de modèles – Accès complet
Analyse entrante – Accès complet (pour une utilisation future)
Campagnes marketing – Accès complet (utilisation future)
Appuyez sur [Enregistrer] et copiez la clé API dans votre presse-papiers ou dans un document pour la conserver en toute sécurité.
Étape 3 – Configurer l’intégration SendGrid dans brainCloud
Connectez-vous au portail brainCloud.
Accédez à Conception | Intégrations | Gérer les intégrations et faites défiler jusqu'à l'intégration SendGrid.
Cliquez sur [x] Activer l’intégration SendGrid et saisissez la clé API SendGrid que vous avez créée à l’étape 2.
Saisissez une adresse e-mail et un nom d'expéditeur par défaut à utiliser dans les e-mails envoyés depuis votre application. Vous pouvez également remplir les champs Répondre à.
Cliquez sur le bouton [Test] pour valider que tout est correctement connecté. brainCloud doit envoyer un e-mail de test à l'adresse e-mail que vous avez utilisée pour vous connecter au portail.
Une fois que vous avez confirmé que l'e-mail a été envoyé, cliquez sur le bouton [Enregistrer] pour enregistrer la configuration et activer l'intégration SendGrid.
Étape 4 – Activer la vérification de l’e-mail
Si votre application utilise l'authentification par e-mail et que vous souhaitez valider l'e-mail de l'utilisateur lorsqu'il crée un compte, vous pouvez le faire à l'aide de notre service d'authentification par e-mail.
L'activation de la vérification à l'aide d'e-mails en texte brut est simple et rapide:
Accédez à Conception | Authentification | Authentification des e-mails dans le portail.
Cliquez sur [x] Envoyer un e-mail de vérification à l'aide de Sendgrid pour activer l'envoi d'un e-mail de vérification aux utilisateurs qui créent de nouveaux comptes à l'aide de leur identité de messagerie. L'e-mail qui leur sera envoyé contiendra un lien sur lequel cliquer pour confirmer leur adresse e-mail.
Activez [x] Rejeter les connexions par e-mail non vérifiées pour empêcher les utilisateurs de se connecter à leur application tant qu'ils n'ont pas cliqué sur le lien.
Activez [x] Envoyer un e-mail de confirmation pour envoyer une confirmation finale à l'utilisateur après qu'il a cliqué sur le lien et s'est inscrit avec succès à votre application. C'est le moment idéal pour lui souhaiter la bienvenue dans votre application et cela améliore également votre taux de "rebond" des e-mails (que vous devez surveiller pour que votre point de terminaison de messagerie ne soit pas confondu avec un compte de spam).
Confirmez ensuite vos modèles d’e-mails:
Pour l'instant, nous supposons que vous avez sélectionné (x) Utiliser des e-mails en texte brut simple .
Personnalisez le contenu des modèles d'e-mail. Utilisez la liste déroulante Modèle pour parcourir les différents modèles. Cliquez sur le bouton [+ Ajouter une langue] en bas pour ajouter des langues supplémentaires.
Cliquez sur [Tester] pour tester des modèles individuels.
Cliquez sur [Enregistrer] lorsque vous êtes satisfait de vos modifications.
Étape 5 – Créer des modèles SendGrid
La véritable puissance de l’intégration avec SendGrid réside dans l’utilisation de modèles personnalisés et professionnels dans votre application.
Nous n'allons pas passer en revue tous les tenants et aboutissants de la création de modèles dans SendGrid, mais nous vous expliquerons les bases :
Connectez-vous à SendGrid
Choisissez la fonctionnalité Modèles | Transactionnels dans le menu de gauche
Cliquez sur [Créer un modèle]
Saisissez un nom pour le modèle, par exemple "Vérification de l'e-mail brainCloud"
Choisissez maintenant + Ajouter une version dans le menu Actions .
Saisissez un nom de version dans le champ Nom du modèle du menu de gauche. Nous vous suggérons "VerifyV1". [Remarque: cette terminologie de SendGrid est déroutante et semble être utilisée de manière incohérente. Le principe de base est qu'un modèle peut avoir plusieurs versions, dont une seule sera active.]
Modifiez l’ objet de l’e-mail – vous devez identifier votre application et l’objectif de l’e-mail
Utilisez l'éditeur pour créer votre modèle . Vous pouvez utiliser une variante du texte ci-dessous.
Vous devrez utiliser un paramètre de substitution pour garantir que l'URL Web soit placée dans votre e-mail. Les paramètres valides sont répertoriés au bas de cette page. Pour l'instant, ajoutez "-weburl-" au bas de la page.
Cliquez sur [Enregistrer] pour enregistrer le modèle, puis sur la flèche gauche sur le côté gauche de l'écran pour quitter l'éditeur.
Dans l'écran de liste des modèles, cliquez sur le bouton d'action de la version du modèle et choisissez [Aperçu et test]. Cliquez ensuite sur [Envoyer le test] , puis sur [Envoyer] pour vous envoyer un e-mail de test brut (sans substitution). Cliquez sur [Annuler] pour quitter l'écran.
Pendant que vous y êtes, vous devez également créer les modèles pour les e-mails de réinitialisation du mot de passe et de confirmation . Lorsque vous configurez des modèles enrichis pour l'authentification par e-mail, vous devez configurer tous les modèles pour une langue en même temps.
Le texte suggéré pour réinitialiser le mot de passe est:
Bonjour,
Cet e-mail a été envoyé automatiquement par AwesomeApp3 suite à votre demande de réinitialisation de votre mot de passe oublié.
Pour réinitialiser votre mot de passe, veuillez cliquer sur le lien ci-dessous (ou copier et coller le lien dans votre navigateur), puis entrez votre nouveau mot de passe.
Si vous n'avez pas oublié votre mot de passe, veuillez ignorer cet e-mail.
{{URL du site}}
Pour l'application de confirmation, le texte suggéré dépend entièrement de vous. Remerciez-les simplement de s'être inscrits à votre application et indiquez-leur où obtenir plus d'informations !
Étape 6 – Configurer les modèles enrichis dans brainCloud
Maintenant que nous avons créé nos modèles SendGrid, connectons-les.
Accéder à Conception | Authentification | Authentification des e-mails dans le portail brainCloud
Sélectionnez (x) Utiliser des modèles de services de messagerie enrichis
Accédez à la liste déroulante E-mail de vérification et choisissez le modèle approprié dans la liste. Cliquez sur [Tester] pour vous envoyer un e-mail de test.
Faites de même pour les paramètres de réinitialisation du mot de passe et de confirmation de vérification , puis cliquez sur [Enregistrer].
Voilà! Vous êtes prêt!
Étape 7 – [Facultatif] Envoyez un e-mail depuis votre application!
Vous pouvez également envoyer des e-mails aux utilisateurs par programmation. Découvrez nos nouvelles API de service de messagerie !