02 51 76 0 34

Accès client :  mot de passe oublié   inscription

       (oubli)

Script / Api Sms par javaScript



  • Pour envoyer un sms pro et récupérer le code réponse :
    // SMSViaJavaScript
    // Script d'envoi de SMS par www.123-Sms.net
    // Copyright (C) 2024 / 123-Sms.net
    // Licence MIT : réutilisation libre (github.com/123-smsnet/api-sms-exemples)
    
    // explications des variables :
    //user :  identifiant envoyé lors de l'inscription à www.123-sms.net sur votre boîte mail (réinitialisable dans votre espace client).
    //cleAPI :  clé envoyée lors de l'inscription à www.123-sms.net sur votre boîte mail (réinitialisable dans votre espace client).
    //message :  message que l'on désire envoyer
    // *** (3 étoiles pour retour chariot)
    // numero : '33611223344-0660616263' numéros de téléphones auxquels on envoie le message(les numéros st séprarés par un tiret '-'); 336 OU 06 pour envoi vers la France
    // refaccuse : pour obtenir un accusé de récépetion par http (url à déclarer par mail sur 123-SMS.net)
    // sender : personnalisation de l'emetteur (doit être déclaré par mail à 123-SMS.net)
    
    // Définition de l'URL de base pour l'envoi de SMS
    const apiUrl = 'https://www.123-SMS.net/http.php';
    
    // Paramètres requis pour l'envoi de SMS, avec l'encodage du message et inclusion du sender-ID personnalisé
    const params = {
      user: 'votre_identifiant_utilisateur',
      cleAPI: 'votre_cle_API',
      numero: 'numéro_de_destinataire', // Exemple: '33601020304'
      message: encodeURIComponent('Votre message ici'), // Encodage du message pour la requête HTTP
      sender: 'votre_sender_ID', // Sender-ID personnalisé
      refaccuse: 'votre_reference_accuse' // Optionnel
    };
    
    // Convertir les paramètres en chaîne de requête
    const queryString = Object.keys(params).map(key => `${encodeURIComponent(key)}=${params[key]}`).join('&');
    
    // Fonction pour gérer les codes de réponse de l'API
    function handleApiResponse(code) {
      switch (code) {
        case '80':
          console.log("Le message a été envoyé.");
          break;
        case '81':
          console.log("Le message est enregistré pour un envoi en différé.");
          break;
        // Ajouter d'autres cas selon la documentation
        case '82':
          console.error("Le login et/ou mot de passe n’est pas valide.");
          break;
        // Complétez avec d'autres codes d'erreur selon vos besoins
        default:
          console.error("Réponse inconnue de l'API:", code);
      }
    }
    
    // Effectuer la requête HTTPS pour envoyer le SMS
    fetch(apiUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/x-www-form-urlencoded'
      },
      body: queryString
    })
    .then(response => response.text())
    .then(data => {
      console.log("Réponse de l'API:", data);
      handleApiResponse(data); // Traiter le code de réponse
    })
    .catch(error => console.error('Erreur lors de l\'envoi du SMS:', error));
    
    
    
Une fois le code appelé dans votre développement celui-ci affichera un code en réponse. Voice la liste et signification de ces codes réponses aux Sms pro envoyés.
  • 80 : Le message a été envoyé
  • 81 : Le message est enregistré pour un envoi en différé
  • 82 : Le login et/ou mot de passe n’est pas valide
  • 83 : vous devez créditer le compte
  • 84 : le numéro de gsm n’est pas valide
  • 85 : le format d’envoi en différé n’est pas valide
  • 86 : le groupe de contacts est vide
  • 87 : la valeur email est vide
  • 88 : la valeur pass est vide
  • 89 : la valeur numero est vide
  • 90 : la valeur message est vide
  • 91 : le message a déjà été envoyé à ce numéro dans les 24 dernières heures (L’erreur 91 peut être désactivée dans la rubrique «Modifier les options »)
  • 92 le test d’envoi «à blanc» est positif
  • 93 pour effectuer l’envoi de SMS vers les DOM TOM, vous devez activer l’option (14) dans l’espace client
  • 94 votre envoi en différé est supprimé
  • 95 votre envoi en différé n’a pas pu être supprimé
  • 96 votre adresse IP n’est pas valide
  • 97 le SENDER ID n’est pas valide
  • 98 la date de début n’est pas valide
  • 99 la date de fin n’est pas valide
  • 100 la date de fin est supérieure à la date de début
  • 101 le numéro de mobile est bloqué et/ou blacklisté
  • 102 le changement de Sender-ID vous oblige à rajouter «stop SMS au 36001» à la fin de votre message

Partage / Test

Si vous avez des scripts à faire partager sous licence GNU n'hésitez pas à nous les envoyer par email à , nous les mettrons en ligne.

Faîtes une demande de test gratuit :

AccueilDéveloppeurs / API › JavaScript  ·  Mis à jour le 22 juillet 2026

Questions fréquentes — SMS et JavaScript

Puis-je appeler l'API 123-SMS directement depuis le navigateur ?

C'est déconseillé : votre clé API serait visible par n'importe qui dans le code source de la page, et les navigateurs bloquent généralement ce type d'appel inter-domaines (CORS). La bonne pratique : votre page envoie la demande à votre propre serveur, et c'est le serveur qui appelle l'API — par exemple en Node.js ou en PHP.

Le code de cette page fonctionne-t-il avec Node.js ?

Oui : fetch est natif depuis Node.js 18, le même code fonctionne côté serveur sans aucune dépendance npm. Une page dédiée Node.js propose un script prêt à télécharger avec gestion des codes de réponse.

Comment gérer les accents et caractères spéciaux du message ?

Passez toujours le message dans encodeURIComponent() avant l'appel, comme dans l'exemple ci-dessus. Un SMS standard contient 160 caractères (norme GSM) ; au-delà, il est facturé en plusieurs segments — détails sur la page nombre de caractères d'un SMS.

Comment savoir si le SMS a bien été envoyé ?

Immédiatement : l'API renvoie un code de statut dans sa réponse : 80 = message envoyé, 81 = enregistré pour un envoi différé, 82 = identifiants invalides, 83 = crédit insuffisant, 84 = numéro invalide (liste complète affichée sur cette page). Vous pouvez aussi recevoir les accusés de réception par HTTP avec le paramètre refaccuse.

5 SMS offerts pour votre essai, sur simple demande : précisez que vous intégrez l'API en JavaScript, et nous créditons votre compte professionnel le temps de vérifier vos premiers envois. Offre réservée aux professionnels : entreprises, associations et collectivités.

Demander 5 SMS de test