Envoyer des SMS depuis une URL - http2sms

Objectif

Différentes méthodes existent pour envoyer des SMS. L'une d'entre elles consiste à utiliser l'outil Wget, par exemple directement depuis la barre d'adresses de votre navigateur Internet.

Apprenez comment envoyer des SMS grâce à l'outil Wget.

Prérequis

• Avoir créé un utilisateur SMS via l'espace client OVHcloud ou directement via les API. À cet effet, vous pouvez consulter le guide suivant : Tout savoir sur les utilisateurs SMS
• Disposer d'un compte SMS OVHcloud avec des crédits SMS
• Disposer d'un expéditeur SMS actif. Pour en savoir plus à ce sujet, vous pouvez consulter ce guide

En pratique

L'envoi d'un SMS se fait via une requête HTTPS avec ses champs obligatoires (et facultatifs, le cas échéant) à l'adresse suivante : https://www.ovh.com/cgi-bin/sms/http2sms.cgi?.

Étape 1 : Inclure les champs obligatoires

Votre URL devra avoir la forme suivante :

https://www.ovh.com/cgi-bin/sms/http2sms.cgi?&account=XXXXXXX&login=XXXXXXX&password=XXXXXXX&from=XXXXXXX&to=XXXXXXX&message=XXXXXXX

Les paramètres suivants doivent être séparés par le caractère &. Remplacez les X de l'exemple ci-dessus par les informations suivantes :

Par défaut, le message est envoyé immédiatement.
Votre navigateur vous affichera les informations suivantes :

• statut de l'envoi
• nombre de crédits restants sur le compte SMS
• ID(s) des SMS envoyés

Par exemple :

OK
85.95
123456789

Retrouvez plus de détails sur l'analyse des envois effectués dans l'étape 3 de ce guide.

Cas particulier : envoi d'un SMS depuis un expéditeur au format court permettant la réponse

Pour envoyer un SMS depuis un expéditeur au format court permettant la réponse du destinataire, vous devez laisser vide le paramètre from et ajouter le champ senderForResponse=1.

Votre URL aura ainsi la forme suivante (où les X doivent être remplacés par les valeurs décrites dans le tableau ci-dessus) :

https://www.ovh.com/cgi-bin/sms/http2sms.cgi?&account=XXXXXXX&login=XXXXXXX&password=XXXXXXX&from=&senderForResponse=1&to=XXXXXXX&message=XXXXXXX

Étape 2 : Ajouter des champs facultatifs

Vous pouvez ajouter des champs supplémentaires dans le sujet, tels que :

https://www.ovh.com/cgi-bin/sms/http2sms.cgi?&account=XXXXXXX&login=XXXXXXX&password=XXXXXXX&from=XXXXXXX&to=XXXXXXX1,XXXXXXX2&message=XXXXXXX&deferred=XXXXXXX&class=X&smsCoding=X&noStop=X

Remplacez les X par les informations ci-dessous :

Taille des SMS à caractère commercial

Un SMS à caractère commercial devra obligatoirement inclure la mention STOP. Celle-ci contient 11 caractères et est automatiquement déduite des 160 caractères de base du 1er SMS. Le tableau ci-dessous indique donc le nombre maximum de caractères autorisés pour les SMS à caractère commercial.

Exemple : en encodage 7bits, si votre message fait plus de 149 caractères, il sera envoyé en 2 SMS et coûtera donc 2 crédits.

Étape 3 : Analyser les envois effectués

Une fois l'envoi effectué, un code de retour API vous indiquera si votre SMS a bien été envoyé ou s'il est en échec. Un code supérieur à 100 et inférieur à 200 indique que le message a bien été envoyé.

Voici la liste des codes de retour de l'API :

• 100 ou 101 : requête traitée.
• 201 : un paramètre est manquant (exemples : Missing login, Missing password).
• 202 : un paramètre est incorrect (exemples : Invalid tag: is too long, Invalid deferred time).
• 401 : pas d'IP autorisée. Pour gérer les IP autorisées, vous pouvez appliquer des restrictions depuis votre espace-client.

Lors d'un échec, la cause est inscrite :

• dans le champ message pour le json ou le xml et
• sur la deuxième ligne pour le html et le text/plain.

XML

• En cas de succès :

<?xml version="1.0" encoding="UTF-8" ?><response><status>100</status><creditLeft>1987</creditLeft><smsIds><smsId>10867690</smsId></smsIds></response>

• En cas d'échec :

<?xml version="1.0" encoding="UTF-8" ?><response><status>201</status><message>Missing message. For more informations : https://help.ovhcloud.com/csm/fr-sms-sending-via-url-http2sms?id=kb_article_view&sysparm_article=KB0051397</message></response>

JSON

• En cas de succès :

{"status":100,"creditLeft":"1987","SmsIds":["10867690"]}

• En cas d'échec :

{"status":201,"message":"Missing message. For more informations : https://help.ovhcloud.com/csm/fr-sms-sending-via-url-http2sms?id=kb_article_view&sysparm_article=KB0051397"}

HTML

• En cas de succès :

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" >
<title>HTTP2SMS</title>
</HEAD>
<BODY>
OK<br>
1987<br>
10867690<br>
</BODY>
</HTML>

• En cas d'échec :

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" >
<title>HTTP2SMS</title>
</HEAD>
<BODY>
KO<br>Missing message. For more informations : https://help.ovhcloud.com/csm/fr-sms-sending-via-url-http2sms?id=kb_article_view&sysparm_article=KB0051397<br>
</BODY>
</HTML>

Text/plain

• En cas de succès :

OK
1987
10867690

• En cas d'échec :

KO
Missing message. For more informations : https://help.ovhcloud.com/csm/fr-sms-sending-via-url-http2sms?id=kb_article_view&sysparm_article=KB0051397

Annexe

Les deux tableaux ci-dessous listent les caractères autorisés en encodage 7bit. Les caractères du tableau « Extensions » comptent double.

La taille maximum d’un SMS est de 160 caractères en encodage 7bit (norme GSM 03.38).

L’utilisation de caractères ne figurant pas dans ces tableaux provoquera le basculement de l’encodage en Unicode et réduit à 70 caractères la taille maximale d’un SMS.

Aller plus loin

Échangez avec notre communauté d'utilisateurs.