v1
latestSwagger 2.02026-07-13143662.0 KBEnvoyer des SMS
Envoi de SMS vers 1 ou plusieurs destinataires
Request body
Clé API
Fuseau horaire de la date d'envoi
Paramètre optionnel, date d'envoi au format YYYY-MM-DD hh:mm
Id du repertoire
L'emetteur doit être une chaîne alphanumérique comprise entre 4 et 11 caractères. Les caractères acceptés sont les chiffres entre 0 et 9, les lettres entre A et Z et l’espace. Il ne peut pas comporter uniquement des chiffres. Pour la modification de l’émetteur et dans le cadre de campagnes commerciales, les opérateurs imposent contractuellement d’ajouter en fin de message le texte suivant : STOP XXXXX De ce fait, le message envoyé ne pourra excéder une longueur de 148 caractères au lieu des 160 caractères, le « STOP » étant rajouté automatiquement.
Le SMS long permet de dépasser la limite de 160 caractères en envoyant un message constitué de plusieurs SMS. Il est possible d’envoyer jusqu’à 6 SMS concaténés pour une longueur totale maximale de 918 caractères par message. Pour des raisons technique, la limite par SMS concaténé étant de 153 caractères. En cas de modification de l’émetteur, il faut considérer l’ajout automatique de 12 caractères du « STOP SMS ». Pour envoyer un smslong, il faut ajouter le paramètre smslong aux appels. La valeur de SMS doit être le nombre maximum de sms concaténé autorisé. Pour ne pas avoir ce message d’erreur et obtenir un calcul dynamique du nombre de SMS alors il faut renseigner smslong = "999"
Si le message n’est pas à but commercial, vous pouvez faire une demande pour retirer l’obligation du STOP. Une fois votre demande validée par nos services, vous pourrez supprimer la mention STOP SMS en ajoutant nostop = "1"
Les envois vers les préfixes opérateurs à destination des DOM TOM (ou DROM-COM) sans l'indicatif pays associé (ex: +262 pour La Réunion) seront acceptés par l'API mais ne pourront etre délivrés. Pour forcer leur traitement au tarif en vigueur, utiliser la valeur 1
Activation du mode bac à sable Ce champ permet de ne pas envoyer réellement les SMS lors de la requête Les envois ne sont pas facturés Utiliser la valeur 1
Dans le cadre d'une utilisation combinée entre SMS Azur et l'API, il est possible de forcer le numéro d'expéditeur à être le même que celui utilisé sur SMS Azur Utiliser la valeur 1
Il est également possible d’envoyer des SMS en alphabet non latin (russe, chinois, arabe, etc) sur les numéros hors France métropolitaine. Pour ce faire, la requête devrait être encodée au format UTF-8 et contenir l’argument ucs2 = "1" Du fait de contraintes techniques, 1 SMS unique ne pourra pas dépasser 70 caractères (au lieu des 160 usuels) et dans le cas de SMS long, chaque sms ne pourra dépasser 67 caractères.
Example request
{
"keyid": "VOTRE_KEYID",
"num": [
"0600123456",
"0612345678"
],
"sms": "Bonjour! Bienvenue sur iSendPro!",
"emetteur": "iSendPro"
}Response
Reponse OK