PUSH MSISDN MODE MAIL 2 SMS

Transcription

1 Solution Pro pour l Envoi de SMS direct opérateurs PUSH MSISDN MODE MAIL 2 SMS Documentation Technique DixData - 19 Chemin des Travails Cagnes-sur-Mer RCS Marseille B Sarl au capital de Siret TVA Intra FR

2 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 Envoi à un seul destinataire...p Envoi à plusieurs destinataires...p Utilisation d un fichier en pièce jointe...p Modification de l émetteur du SMS...p Réponses par ...p. 10 IV ANNEXES...p sur 12

3 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@sms-lowcost.com Le support technique est joignable tous les jours de la semaine de 9h à 13h et de 14h à 17h. 3 sur 12

4 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 , 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 - - Domaine des adresses s 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 à contact@sms-lowcost.com 4 sur 12

5 III - Utilisation de l API L doit être envoyé à sendsms@sms-lowcost.com L 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 id permet d identifier de manière unique une demande d envoi par . Si 2 s sont reçus avec le même id, alors le 2nd ne sera pas traité et un message d erreur sera remonté sur l adresse indiqué dans ack Remarques : - Le saut de ligne doit être remplacé par le caractère Õ. - Si l adresse 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

6 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 ou 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 id identifiant unique de l numérique 1 not ack adresse où envoyer les retours détaillés des envois adresse où envoyer si l a bien été traité ou non alphanumérique alphanumérique not@masociete.com ack@masociete.com Voici un exemple de contenu d un START id&&1548 not&&not@masociete.com ack&&ack@masociete.com keyid&&a296464ce012b8ab710a sms&&l été est finiõsuper promo -10% à partir de 50 d achat!!! num&& emetteur&&masociete END 6 sur 12

7 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 ou 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 id identifiant unique de l numérique 1 not ack adresse où envoyer les retours détaillés des envois adresse où envoyer si l a bien été traité ou non alphanumérique alphanumérique not@masociete.com ack@masociete.com Voici un exemple de contenu d un pour 2 destinataires avec le même message : START id&&1548 not&&not@masociete.com ack&&ack@masociete.com keyid&&a296464ce012b8ab710a sms&&l été est finiõsuper promo -10% à partir de 50 d achat!!! num1&& num2&& emetteur&&masociete END Voici un exemple de contenu d un pour 2 destinataires avec chacun leur message : START id&&1548 not&&not@masociete.com ack&&ack@masociete.com 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&& num2&& emetteur&&masociete END 7 sur 12

8 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 , 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 devenant : START id&&1548 not&&not@masociete.com ack&&ack@masociete.com keyid&&a296464ce012b8ab710a emetteur&&masociete END Le fichier contenant les numéros de mobiles doit etre nommé «mobiles.csv» 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 : Avec des données dynamiques : ;;Michel;;Martin;;10/10/ ;;Sarah;;Dupont;;02/08/2015 Le fichier contenant le message doit etre nommé «message.csv» Le message sera sur la 1 re ligne du fichier et pourra éventuellement contenir des données dynamiques qui seront remplacées en fonction des données du fichier «mobiles.csv» 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 : Bonjour Michel Martin, votre nouvelle carte sera disponible le 10/10/2015 pour le : Bonjour Sarah Dupont, votre nouvelle carte sera disponible le 02/08/ sur 12

9 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

10 5 - Réponses par Ack Les s vers l adresse Ack seront de la forme : <?xml version=«1.0» encoding=«iso »?> <etatack> < id>[ id]</ id> <code>[codeack]</code> <message>[messageack]</message> </etatack> Avec [ id] : la valeur de fourni dans l d envoi ou? si aucune valeur de trouvée CodeAck MessageAck 0 Votre a bien ete traite 1 id deja traite 2 id non renseigne 10 sur 12

11 Not Les s vers l adresse Not seront de la forme pour un envoi unique par <?xml version=«1.0» encoding=«iso »?> <etatnot> < id>[ id]</ id> </etatnot> <etat> <code>[code]</code> <tel>[tel]</tel> <message>[message]</message> </etat> Les s vers l adresse Not seront de la forme pour un envoi multiple par <?xml version=«1.0» encoding=«iso »?> <etatnot> < id>[ id]</ id> </etatnot> <etat1> <code1>[code]</code1> <tel1>[tel]</tel1> <message1>[message]</message1> </etat1> <etatn> <coden>[code]</coden> <teln>[tel]</teln> <messagen>[message]</messagen> </etatn> Avec [ id] : la valeur de fourni dans l d envoi ou? si aucune valeur de trouvée [tel] : le numéro de téléphone fournir dans l d envoi [code] : le code erreur (cf. Annexes p.10) [message] : le message d erreur (cf. Annexes p.10) 11 sur 12

12 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 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