02 51 76 0 34

Accès client :  mot de passe oublié   inscription

       (oubli)

Scripts / Api pour Ruby

Il existe plusieurs méthodes de requêtes http avec Ruby, comme par exemple Net::HTTP mais qui est à notre sens plus lourd.
Nous préférons vous proposez la méthode via OpenURI plus légère et disponible partout.
Il suffit de saisir ce petit script en remplaçant l'url configurée comme il faut

require 'open-uri'

reponse = URI.open('https://www.123-sms.net/http.php?email=votre_identifiant&pass=votre_cle_api&numero=0607080910&message=TestMessage&refaccuse=o').read
puts reponse # 80 = envoyé
# L'url est à paramétrer suivant vos besoins cf procédure ci-dessous.
# Pensez à encoder votre message (URI.encode_www_form_component) pour faire passer les accents.
Url : https://www.123-SMS.net/http.php?email=&pass=&numero=&message=&refaccuse=
  • Envoi unitaire
  • Envoi en nombre (exemple : …&numero=0690919293-0690919294...)
  • Envoi immédiat ou en différé (ajouter &diff=hhmmjjmmaaaa, par exemple, &diff=123004122019 pour un envoi à 12 h 30 le 4 décembre 2019).
  • Pensez à encoder votre variable message).
  • Vous pouvez testez vos requêtes https «à blanc» (sans débiter votre compte) pour cela rajoutez &test=o
  • Vous avez la possibilité de personnaliser l’émetteur : le «sender-ID» (série de 11 caractères alpha-numériques). Vous devez le(s) déclarer en faisant votre demande par email, en précisant celui utilisé par défaut (sinon ce seront les numéros courts). Pour selectionner le Sender-ID au moment de votre envoi rajouter à la fin de la requette &sender= suivi du sender déclaré (orthographe et casse exacte). L’espace est déconseillé car il est interprété différement d’un mobile à l’autre, privilégiez le «_» le «.» ou jouez avec les majuscules ex : «DupontSarl» ou «Dupont_sarl» ou «Dupont.Sarl»).
  • Pour recevoir l’email de confirmation sur un email différent de celui du compte principal : ajouter &email_rep=mon_email@mon_domaine.com ; attention il faudra peut-être encoder le «@» pour vos tests utilisez %40 (exemple &email_rep=mon_email%40mon_domaine.com)

Partenariat

Pourquoi rendre votre PGI/ERP compabible?

Documentations Spécifiques Développeurs / API

Retour AR par http

Retour réponses SMS par http

Solde du compte SMS par http

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 :

Accueil › Développeurs / API › Ruby  ·  Mis à jour le 22 juillet 2026

Questions fréquentes — SMS et Ruby

Faut-il installer une gem pour envoyer un SMS en Ruby ?

Non : open-uri, utilisé dans l'exemple ci-dessus, fait partie de la bibliothèque standard de Ruby. Pour un contrôle plus fin (timeout, code HTTP), net/http est disponible lui aussi sans rien installer.

Comment intégrer l'envoi de SMS dans une application Rails ?

Créez un service object ou un job ActiveJob qui appelle l'API : confirmation de commande, code OTP, rappel de rendez-vous... L'envoi en tâche de fond évite de ralentir la requête web.

Comment encoder le message correctement ?

URI.encode_www_form construit la chaîne de paramètres avec l'encodage URL correct, accents compris.

Comment vérifier que le SMS est parti ?

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 Ruby, 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

Aller plus loin

  • cci-jura
  • min-ecologie
  • edf
  • cma-06
  • ibm
  • foncia
  • cci-paris
  • somfy
  • cci-06
  • smartbox
  • sernam
  • samu
  • veolia