Passerelle d'alertes et de messagerie avec SendGrid

Introduction

Information

Avertissement

  • Vous aurez besoin de l'adresse e-mail de votre propre site web pour envoyer des e-mails ; Gmail, Yahoo, AOL et autres services de messagerie publics peuvent ne pas fonctionner avec cette méthode.
  • Avis de compatibilité : À compter de juin 2023, seuls les compteurs EG4xxx seront compatibles avec la passerelle SMTP SendGrid. Les anciens compteurs, tels que les EG30xx et eGauge2, ne pourront plus envoyer d’alertes via cette passerelle.

SendGrid est un service tiers gratuit et indépendant d'eGauge qui assure un envoi fiable des e-mails sortants. Il peut être utilisé pour la diffusion des alertes eGauge et offre une meilleure fiabilité que l'absence de configuration de passerelle de messagerie. Sans passerelle de messagerie configurée, les e-mails d'alerte peuvent être rejetés, perdus ou ne pas être distribués de manière systématique.

Il s'agit d'un service commercial destiné aux entreprises plutôt qu'aux utilisateurs finaux individuels.

SendGrid permet d'envoyer jusqu'à 100 e-mails par jour avec le forfait gratuit .

SendGrid fournit des informations et un suivi de la livraison, notamment les échecs de livraison des e-mails, le nombre d'e-mails envoyés et d'autres fonctionnalités.

Clause de non-responsabilité

SendGrid est un service de messagerie tiers sans aucun lien avec eGauge Systems. eGauge Systems ne peut garantir la distribution des e-mails, la disponibilité du service ni la sécurité de l'utilisation de SendGrid.

Les informations de cette page seront mises à jour dans la mesure du possible. Toutefois, l'exactitude et la fiabilité des informations, notamment les prix, les instructions d'installation, les captures d'écran et l'emplacement des articles, ne sont pas garanties.

eGauge Systems n'offre aucun support pour les services de SendGrid et ne peut pas aider à la création de comptes, à la récupération de mots de passe ou à des problèmes similaires.

Notes de pré-installation

Les e-mails peuvent être envoyés depuis le compteur eGauge via le serveur SMTP smtp.sendgrid.com et une clé API Sendgrid.

Si vous utilisez les alertes sur plusieurs appareils, il est conseillé de configurer une clé API unique pour chacun d'eux, afin que si la clé est compromise ou si le compteur devient inaccessible et que les alertes ne peuvent pas être désactivées, la clé API puisse être révoquée uniquement pour ce compteur.

Les clés API sont des mots de passe et ne sont affichées qu'une seule fois après leur création.

Installation

  1. Configurer les clés API :
    Assistant de création et de configuration du compte initial pour le premier e-mail
    ou
    Ajouter une deuxième clé API, ou l'ajouter sans l'assistant depuis le tableau de bord principal
  2. Vérifier l'identité de l'expéditeur
  3. Configurer le compteur eGauge

Assistant de création et de configuration initiale du compte pour le premier e-mail

  1. Créez un compte sur SendGrid
  2. Cliquez sur « Démarrer » à droite de « Intégrer à l’aide de notre API Web ou de notre relais SMTP ».
  3. Dans « Choisir une méthode de configuration », choisissez « Relais SMTP ».
  4. Donnez un nom à la clé API, par exemple « E-mails d'alerte eGauge », puis appuyez sur « Créer une clé ».
  5. Vous allez maintenant recevoir le serveur SMTP (smtp.sendgrid.net), votre nom d'utilisateur (apikey) et votre mot de passe (masqué). Ce dernier ne sera affiché qu'une seule fois ; si vous comptez l'utiliser à nouveau, conservez-le précieusement, par exemple dans un trousseau chiffré. Gardez cette page ouverte ou copiez le mot de passe, car il vous sera demandé ultérieurement.

Ajouter une deuxième clé API ou l'ajouter sans l'assistant depuis le tableau de bord principal

  1. Dans le tableau de bord principal, dans le menu latéral gauche, développez « Paramètres » et cliquez sur « Clés API ».

  1. Cliquez sur « Créer une clé API » dans le coin supérieur droit :

  1. Choisissez « Accès restreint » comme autorisation de clé API, développez la section « Envoi de courrier » et cliquez sur le point situé à droite de la barre en regard de « Envoi de courrier » pour accorder cette autorisation.
  2. Cliquez sur « Créer et afficher », puis copiez la clé API affichée sur l’écran suivant. Elle servira à configurer le compteur eGauge ultérieurement.

Vérifier l'identité de l'expéditeur

Vous devrez configurer l'authentification de l'expéditeur afin que le serveur de messagerie destinataire fasse confiance au courriel envoyé par le compteur eGauge et l'accepte. Suivez les instructions pour l'authentification de l'expéditeur unique (simple : envoi d'un lien par courriel pour vérifier l'adresse courriel) ou pour l'authentification du domaine (avancée : nécessite la modification des entrées DNS sur votre site Web).

Sans authentification de l'expéditeur, vous verrez une erreur du type The from address does not match a verified Sender Identity lors de l'envoi d'un e-mail de test sans vérification. Ce message contiendra un lien vous permettant de configurer l'authentification de l'expéditeur.

L'adresse e-mail que vous vérifiez sera utilisée dans le paramètre Custom "From" address des paramètres d'alerte du compteur eGauge.

Configurer le compteur électronique

  1. Accédez à Paramètres -> Alertes, vérifiez que « Fournisseur d'alertes » est bien défini sur « Passerelle SMTP » et cliquez sur « Afficher/Modifier la passerelle et les destinations d'alerte ». Saisissez le nom d'hôte du serveur de messagerie (smtp.sendgrid.com), le nom d'utilisateur (apikey) et la clé API/le mot de passe créés précédemment. Pour l'adresse d'expéditeur personnalisée, saisissez une adresse e-mail vérifiée à l'étape précédente.

  1. Saisissez la ou les adresses électroniques qui doivent recevoir les alertes du compteur sous Destinations des alertes.

  1. Cliquez sur « Enregistrer » en bas de la page, puis sur « Envoyer un message de test » à droite de chaque destination d'alerte pour vérifier que la livraison fonctionne.