Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Expert Advisors

Alertes, e-mails et notifications push dans un Expert Advisor MQL5

Prévenir l’opérateur avec Alert, SendMail et SendNotification : configuration du terminal, limites de fréquence, codes d’erreur et module d’alertes qui évite d’inonder votre téléphone.

Mis à jour le 23 octobre 2026Lecture : 8 minPar Alix, OptiBot Trading

Un Expert Advisor MQL5 dispose de trois moyens natifs pour vous prévenir : Alert affiche une fenêtre d’alerte dans le terminal, SendMail envoie un e-mail via le serveur SMTP configuré dans le terminal, et SendNotification envoie une notification push sur l’application mobile MetaTrader identifiée par votre MetaQuotes ID. Aucune de ces fonctions ne fonctionne dans le Strategy Tester, et SendNotification est soumise à des limites strictes : 255 caractères par message, 2 envois par seconde et 10 par minute au maximum. Un EA en production doit donc filtrer et regrouper ses messages.

Cette page de la rubrique Construire un Expert Advisor en MQL5 détaille chaque canal, montre comment les configurer et propose un module d’alertes qui respecte les limites. Pour l’affichage dans le journal pendant le développement, voyez Print, Comment, Alert : déboguer avec le journal.

Les trois canaux

FonctionOù arrive le messageRéglage dans le terminalTesteur
Alert(...)fenêtre d’alerte du terminal, avec signal sonoreaucunne fonctionne pas
SendMail(sujet, texte)boîte e-mail configuréeonglet « E-mail » des paramètresne fonctionne pas
SendNotification(texte)application mobile MetaTraderonglet « Notifications » (MetaQuotes ID)ne fonctionne pas

Alert

Alert accepte jusqu’à 64 paramètres de types simples, séparés par des virgules, et ne renvoie rien. Elle n’est utile que si quelqu’un regarde l’écran du terminal : sur un serveur distant, une alerte affichée sans personne pour la voir ne sert à rien. Réservez-la au développement et aux usages sur votre poste.

SendMail

bool SendMail(string subject, string some_text) place le message dans la file d’envoi du terminal. Un retour true signifie que le message a été mis en file, pas qu’il a été livré. L’envoi utilise le serveur, l’identifiant et l’adresse saisis dans l’onglet « E-mail » des paramètres du terminal ; si l’envoi est désactivé ou si l’adresse est vide, l’appel échoue. La propriété TerminalInfoInteger(TERMINAL_EMAIL_ENABLED) indique si l’envoi est autorisé. L’e-mail convient aux rapports détaillés (bilan quotidien, liste des trades) plutôt qu’aux alertes urgentes.

SendNotification

bool SendNotification(string text) envoie un message aux terminaux mobiles dont le MetaQuotes ID a été saisi dans l’onglet « Notifications » des paramètres. Le MetaQuotes ID est affiché dans l’application mobile MetaTrader installée sur votre téléphone. Avant l’envoi, vérifiez TerminalInfoInteger(TERMINAL_NOTIFICATIONS_ENABLED). En cas d’échec, GetLastError() peut renvoyer :

CodeConstanteSignification
4515ERR_NOTIFICATION_SEND_FAILEDéchec de l’envoi
4516ERR_NOTIFICATION_WRONG_PARAMETERparamètre invalide (texte vide, par exemple)
4517ERR_NOTIFICATION_WRONG_SETTINGSréglages absents ou incorrects (MetaQuotes ID non saisi)
4518ERR_NOTIFICATION_TOO_FREQUENTenvois trop fréquents

L’usage est surveillé dynamiquement : un programme qui dépasse les limites de fréquence peut voir la fonction désactivée. C’est la raison principale pour laquelle les notifications doivent passer par un module qui les limite.

Choisir un canal selon l’environnement d’exécution

Le bon canal dépend de l’endroit où tourne l’EA. Sur votre ordinateur, pendant que vous êtes devant l’écran, Alert suffit. Sur un serveur distant, seuls l’e-mail et la notification push vous atteignent. Si vous utilisez l’hébergement intégré à MetaTrader, vérifiez que les réglages d’e-mail et de notifications sont bien disponibles dans l’environnement hébergé avant de compter dessus.

Ce qui mérite une alerte

Une notification utile appelle une action ou signale un changement d’état. Si votre téléphone vibre à chaque tick ou à chaque bougie, vous finirez par ignorer les messages, y compris le seul qui comptait. Classez les événements :

  • Critique (notification immédiate) : limite de perte journalière atteinte, ordre rejeté de façon répétée, connexion perdue depuis plusieurs minutes, trading automatique désactivé.
  • Information (notification, sans urgence) : ouverture et fermeture de position, si le rythme de trading est faible.
  • Rapport (e-mail) : bilan quotidien ou hebdomadaire, état du compte.
  • Diagnostic (journal uniquement) : valeurs des indicateurs, raisons de non-entrée, détails techniques.

Code : un module d’alertes avec limitation

Le module ci-dessous centralise les envois. Il tronque les messages à 255 caractères, impose un intervalle minimal entre deux notifications d’un même type pour éviter les répétitions, respecte une cadence globale de sécurité et bascule sur le journal dans le Strategy Tester.

#property version "1.00"

input bool InpPushEnabled  = true;   // notifications push
input bool InpMailEnabled  = false;  // e-mail pour les rapports
input int  InpRepeatSec    = 900;    // délai minimal entre deux alertes de même clé

#define MAX_KEYS 32
string   g_keys[MAX_KEYS];           // clés d'alertes déjà envoyées
datetime g_keyTime[MAX_KEYS];        // heure du dernier envoi par clé
int      g_keyCount = 0;
datetime g_lastPush = 0;             // dernier envoi push, toutes clés confondues

//--- true si cette clé n'a pas été envoyée récemment
bool CanSend(const string key)
  {
   datetime now = TimeLocal();
   for(int i = 0; i < g_keyCount; i++)
      if(g_keys[i] == key)
        {
         if(now - g_keyTime[i] < InpRepeatSec) return(false);
         g_keyTime[i] = now;
         return(true);
        }
   if(g_keyCount < MAX_KEYS)
     {
      g_keys[g_keyCount] = key;
      g_keyTime[g_keyCount] = now;
      g_keyCount++;
     }
   return(true);
  }

//--- point d'entrée unique pour les alertes
void Notify(const string key, const string text)
  {
   string msg = StringFormat("[%s %s] %s", MQLInfoString(MQL_PROGRAM_NAME), _Symbol, text);
   Print(msg);                                            // toujours une trace dans le journal
   if(MQLInfoInteger(MQL_TESTER)) return;                 // aucun envoi dans le testeur
   if(!CanSend(key)) return;                              // même alerte envoyée récemment

   if(InpPushEnabled && TerminalInfoInteger(TERMINAL_NOTIFICATIONS_ENABLED))
     {
      if(TimeLocal() - g_lastPush < 7)                   // cadence de sécurité : < 10 par minute
         Print("Notification différée par la limite de fréquence : ", key);
      else
        {
         if(!SendNotification(StringSubstr(msg, 0, 255)))  // 255 caractères au maximum
            Print("SendNotification a échoué, erreur ", GetLastError());
         g_lastPush = TimeLocal();
        }
     }
  }

//--- rapport détaillé par e-mail
void SendReport(const string subject, const string body)
  {
   if(!InpMailEnabled || MQLInfoInteger(MQL_TESTER)) return;
   if(!TerminalInfoInteger(TERMINAL_EMAIL_ENABLED))
     {
      Print("Envoi d'e-mails non configuré dans le terminal");
      return;
     }
   if(!SendMail(subject, body))
      Print("SendMail a échoué, erreur ", GetLastError());
  }

int OnInit()
  {
   if(InpPushEnabled && !MQLInfoInteger(MQL_TESTER) &&
      !TerminalInfoInteger(TERMINAL_NOTIFICATIONS_ENABLED))
      Print("Attention : notifications push non activées dans les paramètres du terminal");
   Notify("start", "EA démarré");
   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   //--- exemples d'appels :
   //--- Notify("dailylimit", "Limite journalière atteinte, entrées bloquées");
   //--- Notify("reject", "Ordre rejeté : code " + (string)trade.ResultRetcode());
  }

Points clés du module

  • Le journal reçoit toujours le message : c’est la trace de référence, consultable après coup, y compris sur un serveur distant.
  • La clé ("dailylimit", "reject"…) identifie le type d’événement. Un ordre rejeté dix fois de suite ne produit qu’une notification par quart d’heure.
  • Une notification bloquée par la cadence de sécurité n’est pas renvoyée automatiquement. Pour un EA critique, ajoutez une petite file d’attente vidée depuis OnTimer.
  • Le nom du programme et le symbole en tête du message permettent de savoir immédiatement quel robot parle quand plusieurs tournent en parallèle.

Un rapport quotidien plutôt que des dizaines de messages

Pour les informations qui ne demandent pas d’action immédiate, regroupez-les. Une fois par jour, au changement de bougie journalière détecté par l’EA, composez un rapport qui reprend le nombre de trades de la veille, le résultat réalisé, les capitaux propres, le plus grand recul de la journée et les éventuels incidents (rejets, reconnexions, blocages par filtre). Envoyez-le avec SendReport par e-mail, et ne gardez en notification push qu’une ligne de synthèse. Vous obtenez ainsi un historique lisible de la vie du robot, sans dépasser les limites de fréquence, et vous remarquez plus facilement une dérive lente, comme une hausse progressive des rejets ou du glissement, qu’aucune alerte ponctuelle n’aurait signalée.

Tester les notifications

Puisque les trois fonctions ne fonctionnent pas dans le Strategy Tester, testez-les en démonstration : attachez l’EA à un graphique, déclenchez volontairement un événement (par exemple avec un paramètre de test qui envoie un message au démarrage) et vérifiez la réception sur le téléphone et dans la boîte e-mail. Faites ce contrôle sur la machine de production elle-même, car les réglages e-mail et notifications sont propres à chaque installation du terminal. Ce test figure dans la checklist avant mise en production.

Pièges fréquents

  • Envoyer depuis OnTick sans filtre. C’est la cause la plus courante de désactivation pour envois trop fréquents.
  • Croire qu’un e-mail est parti. SendMail renvoie true dès la mise en file ; un mot de passe SMTP erroné fera échouer la livraison plus tard. Vérifiez le journal du terminal.
  • Messages illisibles sur mobile. Un message tronqué à 255 caractères perd sa fin : placez l’information essentielle au début.
  • Notifications depuis OnDeinit. À la fermeture du terminal, le temps disponible est court et la connexion peut déjà être coupée ; ne comptez pas sur un message envoyé à ce moment-là.

Questions fréquentes

Pourquoi SendNotification renvoie-t-il false avec l’erreur 4517 ?

Le terminal n’a pas de MetaQuotes ID valide dans l’onglet « Notifications » de ses paramètres, ou les notifications n’y sont pas activées. Saisissez l’identifiant affiché dans votre application mobile, activez l’option, puis utilisez le bouton de test du terminal.

Peut-on envoyer des notifications depuis le Strategy Tester ?

Non. Alert, SendMail et SendNotification ne fonctionnent pas dans le testeur. Utilisez Print pour vérifier la logique de déclenchement pendant les tests.

Combien de notifications un EA peut-il envoyer ?

Pas plus de 2 par seconde et 10 par minute. En pratique, visez beaucoup moins : quelques messages par jour, réservés aux événements qui demandent votre attention.

Faut-il préférer l’e-mail ou la notification push ?

La notification push pour l’urgent, car elle arrive en quelques secondes sur le téléphone ; l’e-mail pour les rapports détaillés, que vous lirez à tête reposée.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.