02 51 76 0 34

Accès client :  mot de passe oublié   inscription

       (oubli)
AccueilDéveloppeurs / API › PowerShell

Envoyer un SMS en PowerShell (API 123-SMS)

Mis à jour le 17 juillet 2026

Pour les administrateurs Windows, PowerShell est le chemin le plus court vers le SMS d'alerte : une fonction, un appel HTTPS, et vos scripts de supervision, sauvegardes et tâches planifiées savent prévenir l'astreinte.

1Le script complet (PowerShell 5.1+)

# =====================================================================
#  Envoi de SMS via l'API 123-SMS.net  (PowerShell 5.1 ou superieur)
#  Documentation : https://www.123-sms.net/developpeurs-api.php
#  (c) 123-SMS.net - licence MIT, reutilisation libre
# =====================================================================

# --- Vos identifiants (espace client 123-SMS.net) --------------------
$Email  = "votre-email@exemple.fr"   # e-mail du compte
$CleApi = "XXXXXX"                   # cle API : espace client > API

function Send-Sms123 {
    param(
        [Parameter(Mandatory)][string]$Numero,
        [Parameter(Mandatory)][string]$Message
    )
    $url = "https://www.123-sms.net/http.php?email={0}&pass={1}&numero={2}&message={3}" -f
        [uri]::EscapeDataString($Email),
        [uri]::EscapeDataString($CleApi),
        [uri]::EscapeDataString($Numero),
        [uri]::EscapeDataString($Message)
    $reponse = Invoke-WebRequest -Uri $url -UseBasicParsing
    return $reponse.Content.Trim()
}

# --- Exemple ---------------------------------------------------------
$code = Send-Sms123 -Numero "0612345678" -Message "Test 123-SMS depuis PowerShell !"
Write-Host "Reponse de l'API : $code"

2Installation et utilisation

  • Téléchargez l'archive ou copiez le code dans Envoyer-SMS.ps1.
  • Renseignez $Email et $CleApi (espace client › API).
  • Lancez : powershell -ExecutionPolicy Bypass -File Envoyer-SMS.ps1.
  • Intégrez la fonction Send-Sms123 dans vos scripts d'exploitation.
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

Quelle version de PowerShell ?

Windows PowerShell 5.1 (inclus dans Windows 10/11 et Windows Server) comme PowerShell 7 : l'exemple fonctionne sur les deux.

Peut-on l'appeler depuis le Planificateur de tâches ?

Oui : powershell -ExecutionPolicy Bypass -File C:\Scripts\Envoyer-SMS.ps1 — idéal pour alerter en cas d'échec de sauvegarde, de service arrêté ou de disque plein.

Les accents passent-ils correctement ?

Oui : [uri]::EscapeDataString encode proprement accents, espaces et caractères spéciaux avant l'appel.

Comment protéger la clé API ?

Restreignez les droits du fichier au compte de service qui l'exécute, et régénérez la clé dans l'espace client au moindre doute.

Téléchargement

123-sms_powershell.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.