02 51 76 0 34

Accès client :  mot de passe oublié   inscription

       (oubli)
Accueil › Développeurs / API › Nagios

Notifications Nagios par SMS (plugin 123-SMS)

Mis à jour le 17 juillet 2026

Quand un hôte tombe, l'e-mail Nagios attend l'ouverture des bureaux — le SMS réveille l'astreinte. Voici le script de notification complet, avec les définitions de commandes prêtes à coller dans votre configuration.

1Le script de notification (bash + curl)

#!/usr/bin/env bash
# =====================================================================
#  notify_sms_123sms.sh - Notifications Nagios / Icinga / Centreon
#  par SMS via l'API 123-SMS.net
#  Documentation : https://www.123-sms.net/developpeurs-api.php
#  (c) 123-SMS.net - licence MIT, reutilisation libre
# =====================================================================
#  Usage : notify_sms_123sms.sh <numero> <message>

EMAIL="votre-email@exemple.fr"   # e-mail du compte 123-SMS.net
CLE_API="XXXXXX"                 # cle API : espace client > API

NUMERO="${1:?Usage: $0 <numero> <message>}"
MESSAGE="${2:?Usage: $0 <numero> <message>}"

curl -sS --get "https://www.123-sms.net/http.php" \
  --data-urlencode "email=${EMAIL}" \
  --data-urlencode "pass=${CLE_API}" \
  --data-urlencode "numero=${NUMERO}" \
  --data-urlencode "message=${MESSAGE}" > /dev/null

2Installation et utilisation

  • Copiez notify_sms_123sms.sh dans /usr/local/bin/ et rendez-le exécutable.
  • Renseignez EMAIL et CLE_API dans le script.
  • Ajoutez les commandes de commands-sms.cfg (fournies dans l'archive) à votre configuration.
  • Déclarez le mobile de chaque contact dans son champ pager et associez les commandes de notification.
  • Testez : notify_sms_123sms.sh 0612345678 "Test Nagios".
La clé API se génère dans l'espace client, rubrique API › Générer Clé API. Les codes réponse et le retour des accusés de réception par HTTP sont détaillés dans la documentation technique.

Questions fréquentes

Avec quelles versions est-ce compatible ?

Nagios Core 3 et 4, Icinga 1 et 2 (commandes legacy) et Centreon : le format de commande est identique.

Où déclarer le numéro du destinataire ?

Dans le champ pager du contact Nagios — la macro $CONTACTPAGER$ des commandes fournies le récupère automatiquement.

Et pour Zabbix, Centreon, Grafana ou Uptime Kuma ?

Le même script s'adapte en quelques lignes (webhook ou script d'alerte). Des intégrations dédiées arrivent — contactez-nous pour être prévenu.

Pourquoi le SMS plutôt que l'e-mail pour l'astreinte ?

Parce qu'il réveille : délivré en quelques instants, lu immédiatement. Et chez 123-SMS les crédits n'expirent jamais — une réserve d'alerte reste disponible tant qu'elle n'est pas consommée.

Testez avec votre propre besoin

Inscription gratuite Voir les tarifs SMS Contacter l'équipe

Téléchargement

123-sms_nagios.zip

Licence MIT — libre et gratuit.

L'essentiel

  • API HTTPS en un appel GET : email, clé API, numéro, message.
  • Code réponse immédiat + accusés de réception par HTTP.
  • Crédits prépayés sans abonnement ni expiration.
  • Adaptations spécifiques développées gratuitement.

Autres langages