Solution Pro pour l’Envoi de SMS direct opérateurs
PUSH MSISDN MODE MAIL 2 SMS
Documentation Technique
DixData - 19 Chemin des Travails - 06800 Cagnes-sur-Mer
RCS Marseille B 443 014 238 - Sarl au capital de 108 000€
Siret 44301423800028 - TVA Intra FR39443014238
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
Table des matières
I - -Introduction...................................................................................................................... p. 03
II - -Mise à jour d’un compte client............................................................................. p. 04
pour le mode PUSH MSISDN ⁄ mail 2 sms
III - - Utilisation de l’API......................................................................................................... p. 05
1 - Envoi à un seul destinataire.....................................................................................................p. 06
2 - Envoi à plusieurs destinataires ..............................................................................................p. 07
3 - Utilisation d’un fichier en pièce jointe ..................................................................................p. 08
4 - Modification de l’émetteur du SMS........................................................................................p. 09
5 - Réponses par e-mail..................................................................................................................p. 10
IV - ANNEXES..............................................................................................p. 12
2 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
I - Introduction
Ce document présente le déroulement de la procédure d’envoi de messages sur les numéros
de téléphone SFR, Bouygues, Orange, Virgin, NRJ et Free via des requÍtes HTTP.
Ce mode permet l’automatisation dans vos applicatifs de l’envoi de push. Le document est découpé
en 3 parties :
- La première partie traite de la création d’un compte d’envoi de messages
- La deuxième partie présente l’envoi de messages
- La troisième partie contient les annexes
Si vous avez des questions techniques merci de contacter le support à l’adresse suivante :
support@[Link]
Le support technique est joignable tous les jours de la semaine de 9h à 13h et de 14h à 17h.
3 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
II - Mise à jour d’un compte client pour
le mode PUSH MSISDN / mail 2 sms
Afin de permettre l’envoi de push via la plateforme SMS-Lowcost par e-mail, il faut avoir un compte
valide avec du crédit.
À chaque message envoyé, votre crédit se met à jour automatiquement.
Liste des informations à fournir pour la création d’un compte :
- Raison Sociale
- Nom Prénom
- Téléphone
- Email
- Domaine des adresses emails de l’expéditeur
Liste des informations fournies en retour :
- Identifiant
- Mot de passe
L’envoi de SMS commerciaux est formellement interdit pendant les heures comprises entre 20h00
et 8h00 les jours calendaires.
Ces restrictions contractuelles avec les opérateurs sont édictées par l’AFMM et ne sont pas
spécifiques à notre site.
Vous pouvez soit programmer votre envoi pour plus tard , soit nous demander de lever cette
restriction si vos envois ne sont pas à destination commerciale (système d’alerte par exemple)
en envoyant un email à contact@[Link]
4 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
III - Utilisation de l’API
L’e-mail doit être envoyé à sendsms@[Link]
L’e-mail attendu doit contenir une chaine de caractère sur une ligne et formatée de la manière
suivante dans le corps du message :
La chaine de caractère doit commencer par __START et se terminer par __END
Entre ces balise, les données seront de la forme __NomArgument&&ValeurArgument
L’argument emailId permet d’identifier de manière unique une demande d’envoi par e-mail.
Si 2 e-mails sont reçus avec le même emailId, alors le 2nd ne sera pas traité et un message d’erreur
sera remonté sur l’adresse email indiqué dans emailAck
Remarques :
- Le saut de ligne doit être remplacé par le caractère Õ.
- Si l’adresse email de l’expéditeur n’a pas été autorisée, les envois ne seront pas effectués.
- La clé d’identification est disponible sur votre espace client dans l’onglet « Mon compte ».
5 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
1 - Envoi à un seul destinataire
La liste des arguments attendus est :
Variable Signification Format Exemple
keyid clé d’identification du compte Chaîne de caractères a296464ce012b8ab710a
sms message à envoyer Chaîne de caractères Salut ca va ?
num numéro du destinataire 10 numérique 0601020304 ou
0701020304
emetteur emetteur du message alphanumérique MaSociete7
tracker identifiant de l’envoi alphanumérique monCompte_monId
smslong indique le nb de sms que fera le message 1 numérique 2
emailId identifiant unique de l’email numérique 1
emailNot adresse email où envoyer les retours alphanumérique not@[Link]
détaillés des envois
emailAck adresse email où envoyer si l’email a bien alphanumérique ack@[Link]
été traité ou non
Voici un exemple de contenu d’un e-mail :
__START__emailId&&1548__emailNot&¬@masociete.com__emailAck&&ack@[Link]
__keyid&&a296464ce012b8ab710a__sms&&L’été est finiÕSuper promo -10% à partir de 50€ d’
achat !!!__num&&0601020304__emetteur&&MaSociete__END
6 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
2 - Envoi à plusieurs destinataires
Cette solution permet d’envoyer un message jusqu’à 50 destinataires différents par requête,
permettant ainsi une augmentation de la vitesse des envois.
Les numéros de téléphone sont placés dans des variable numX où X est un entier allant de 1 à 50
au maximum.
Si le message est identique pour tous les destinataires, il suffit de le renseigner une seule fois dans
la variable sms.
Si le message est différent pour chaque destinataire alors les messages sont placés dans des variables
smsX où X est un entier allant de 1 à 50 au maximum. Dans ce cas le message smsX sera envoyé
au destinataire numX.
Variable Signification Format Exemple
keyid clé d’identifiant du compte Chaîne de caractères a296464ce012b8ab710a
smsX message à envoyer Chaîne de caractères Salut ca va ?
numX numéro du destinataire 10 numérique 0601020304 ou
0701020304
emetteur emetteur du message alphanumérique MaSociete7
tracker identifiant de l’envoi alphanumérique monCompte_monId
smslong indique le nb de sms que fera le message 1 numérique 2
emailId identifiant unique de l’email numérique 1
emailNot adresse email où envoyer les retours dé- alphanumérique not@[Link]
taillés des envois
emailAck adresse email où envoyer si l’email a bien alphanumérique ack@[Link]
été traité ou non
Voici un exemple de contenu d’un email pour 2 destinataires avec le même message :
__START__emailId&&1548__emailNot&¬@masociete.com__emailAck&&ack@[Link]
__keyid&&a296464ce012b8ab710a__sms&&L’été est finiÕSuper promo -10% à partir de 50€ d’
achat !!!__num1&&0601020304__num2&&0601020305__emetteur&&MaSociete__END
Voici un exemple de contenu d’un email pour 2 destinataires avec chacun leur message :
__START__emailId&&1548__emailNot&¬@masociete.com__emailAck&&ack@[Link]
__keyid&&a296464ce012b8ab710a__sms1&&L’été est finiÕSuper promo -10% à partir
de 50€ d’achat !!! __sms1&&L’été est finiÕSuper promo -20% à partir de 100€ d’achat
!!!__num1&&0601020304__num2&&0601020305__emetteur&&MaSociete__END
7 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
3 - Utilisation d’un fichier en pièce jointe
A la place de fournir les numéros de téléphones et le message associé dans le corps de l’email,
il est possible de fournir ces données dans des fichiers en pièces jointes au format «.csv»
Les arguments [sms] et [num] ne doivent plus être renseignés dans le corps du message.
Le contenu de l’email devenant :
__START__emailId&&1548__emailNot&¬@masociete.com__emailAck&&ack@masociete
.com__keyid&&a296464ce012b8ab710a__emetteur&&MaSociete__END
Le fichier contenant les numéros de mobiles doit etre nommé «[Link]»
Chaque ligne va contenir un numéro de téléphone et éventuellement des données dynamiques
supplémentaires séparées par «;;»
La structure étant de la forme :
[num];;[1];;[2];;[3]
Ex :
Sans données dynamiques :
0601020304
Avec des données dynamiques :
0601020304;;Michel;;Martin;;10/10/2015
0601020305;;Sarah;;Dupont;;02/08/2015
Le fichier contenant le message doit etre nommé «[Link]»
Le message sera sur la 1re ligne du fichier et pourra éventuellement contenir des données
dynamiques qui seront remplacées en fonction des données du fichier «[Link]»
Ex :
Sans données dynamiques :
Bonjour, votre nouvelle carte est disponible
Avec des données dynamiques :
Bonjour [1] [2], votre nouvelle carte sera disponible le [3]
Le message devenant alors
pour le 0601020304 :
Bonjour Michel Martin, votre nouvelle carte sera disponible le 10/10/2015
pour le 0601020305 :
Bonjour Sarah Dupont, votre nouvelle carte sera disponible le 02/08/2015
8 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
4 - Modification de l’émetteur du SMS
L’émetteur doit être une chaîne alphanumérique comprise entre 4 et 11 caractères. 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 SMS au XXXXX
De ce fait, le message envoyé ne pourra excéder une longueur de 141 caractères au lieu des 160
caractères, le « STOP SMS » étant rajouté automatiquement.
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 dans la requête http l’argument suivant :
__nostop&&1
9 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
5 - Réponses par e-mail
• Ack
Les emails vers l’adresse Ack seront de la forme :
<?xml version=«1.0» encoding=«ISO-8859-1»?>
<etatAck>
<emailId>[emailId]</emailId>
<code>[codeAck]</code>
<message>[messageAck]</message>
</etatAck>
Avec [emailId] : la valeur de email fourni dans l’email d’envoi ou ? si aucune valeur de trouvée
CodeAck MessageAck
0 Votre email a bien ete traite
1 emailId deja traite
2 emailId non renseigne
10 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
• Not
Les emails vers l’adresse Not seront de la forme pour un envoi unique par email :
<?xml version=«1.0» encoding=«ISO-8859-1»?>
<etatNot>
<emailId>[emailId]</emailId>
</etatNot>
<etat>
<code>[code]</code>
<tel>[tel]</tel>
<message>[message]</message>
</etat>
Les emails vers l’adresse Not seront de la forme pour un envoi multiple par email :
<?xml version=«1.0» encoding=«ISO-8859-1»?>
<etatNot>
<emailId>[emailId]</emailId>
</etatNot>
<etat1>
<code1>[code]</code1>
<tel1>[tel]</tel1>
<message1>[message]</message1>
</etat1>
…
<etatN>
<codeN>[code]</codeN>
<telN>[tel]</telN>
<messageN>[message]</messageN>
</etatN>
Avec
[emailId] : la valeur de email fourni dans l’email d’envoi ou ? si aucune valeur de trouvée
[tel] : le numéro de téléphone fournir dans l’email d’envoi
[code] : le code erreur (cf. Annexes p.10)
[message] : le message d’erreur (cf. Annexes p.10)
11 sur 12
PUSH MSISDN MODE MAIL 2 SMS Documentation Technique
IV - ANNEXES
Tableau Code Erreur
Code erreur Message
0 Votre message a bien été envoyé
1 Le champ Login est vide
2 Le champ PWD est vide
3 Vos identifiants sont incorrects
6 Vous devez saisir un numéro de téléphone
7 Un numéro de téléphone est sur 10 chiffres
11 Le numéro de téléphone est dans la liste noire
12 Votre crédit de MT est épuisé
14 L’adresse IP n’est pas autorisée
16 L’émetteur ne peut pas être vide
21 Le numéro de téléphone n’est pas attribué
22 Le téléphone est attribué à un Full MVNO
23 Le nombre maximum de téléphones par requête est de 50
24 Pas d’envoi commercial entre 20h et 08h, ni les dimanches et jours fériés
27 L’indicatif pays du téléphone n’est pas autorisé !
29 Nous ne pouvons donner suite à votre demande (overflow)
30 Erreur sur le domaine de connexion
33 Cet émetteur n’est pas autorisé!
34 La valeur de smslong doit etre un entier !
100 Vous devez saisir un type d’appel valide
101 Les appels répondeurs ne fonctionnent pas avec les numéros de fixe !
102 Vous devez saisir un fichier valide !
103 L’émetteur doit etre sur 10 chiffres !
104 L’émetteur ne doit comporter que des chiffres !
105 L’émetteur ne peut pas etre un numéro en 08,
106 Seuls les fichiers .wma, .wav sont acceptés !
107 Votre fichier dépasse 30 secondes !
1000 Le fichier a bien été importé
999 Une erreur est survenue. Merci de contacter le service technique
12 sur 12