Envoi de message par module http SMS, Push wap Le module d’envoi SMS, MMS, Push WAP HTTP AllMySMS répond à un besoin simple : envoyer via HTTP des SMS, MMS, messages Push WAP à l’unité ou en nombre, immédiatement ou en différé, de la façon la plus rapide et la plus efficace qui soit, sans signer de contrat ni avoir à étudier de longue documentation technique. En effet, dès créditation de votre compte avec un pack de SMS, vous pourrez automatiquement envoyer des SMS, MMS, Push WAP par HTTP en plus du site et du logiciel gratuit (procédure ci-dessous).
Vous serez capable d’envoyer des SMS partout dans le monde en appelant le module SMS HTTP depuis une page web, un script ou un logiciel dans la limite de votre crédit de SMS. Cette solution est particulièrement adaptée aux besoins des webmasters, développeurs ou professionnels qui souhaitent proposer une valeur ajoutée à leurs réalisations en y intégrant le SMS gratuitement .
N’utilisant que le protocole HTTP utilisé par le web, le module SMS est intégrable dans toutes vos réalisations, quelque soit le langage (asp, c, c++, delphi, java, jsp, php, windev, etc…). Il suffit pour cela d’envoyer un flux XML vers une url comme indiqué ci-dessous:
Procédure d’utilisation du module SMS HTTP AllMySMS Le module SMS HTTP fonctionne par transmission de flux XML vers l’URL suivante (requêtes HTTP GET ou POST ):http://api.msinnovations.com/amsmodule.sendsms.v6.php?clientcode=login &passcode=mot de passe &XMLFlow=flux XML à transmettre
Les login et mot de passe à transmettre correspondent aux identifiants de votre compte AllMySMS. Le flux XML à transmettre est détaillé ci-dessous.
Flux XML à transmettre:
<DATA> <MESSAGE><![CDATA[ message - 640 caractères maximum]]></MESSAGE> <DYNAMIC> 2 (contiendra le nombre de paramètres variables du message)</DYNAMIC> (obligatoire si le message est variable) <LOWCOST> 0 -> utilisation du canal normal, 1 -> utilisation du canal LOWCOST (option facultative)</LOWCOST> <CAMPAIGN_NAME> nom de campagne </CAMPAIGN_NAME> (option facultative) <DATE> date différée facultative ex.: 2007-11-05 15:10:00 </DATE> (option facultative) <TPOA> nom de l’émetteur (option facultative)</TPOA> <MSGCLASS> 0 pour un message flash, 1 un pour un message normal </MSGCLASS> (option facultative) <MAIL_NOTIF> 0 pour refuser les notifications d’envoi par mail, 1 pour les accepter </MAIL_NOTIF> (option facultative) <ALERTING> 0 -> utilisation du canal normal, 1 -> utilisation du canal d’alerte (option facultative)</ALERTING> <SMS> <MOBILEPHONE> 36xxxxxxxx</MOBILEPHONE> <PARAM_1> Parametre 1</PARAM_1> <PARAM_2> Parametre 2</PARAM_2> </SMS> <SMS> <MOBILEPHONE> 36xxxxxxxx</MOBILEPHONE> <PARAM_1> Parametre 1</PARAM_1> <PARAM_2> Parametre 2</PARAM_2> </SMS> </DATA>
Veuillez indiquer:
- votre login en majuscules entre les balises <CLIENT> et </CLIENT> , - un message ne dépassant pas 640 caractères ( 1 SMS = 160 caractères ) entre les balises <MESSAGE> et </MESSAGE> , - un nom de campagne pour identification ultérieure si nécessaire (facultatif), - une date au format YYYY-MM-JJ HH:MM:SS si vous souhaitez effectuer un envoi différé (facultatif), - le format du message (flash ou pas): 0 pour flash, 1 pour un message normal (facultatif), - la notification par mail: 0 pour refuser d’en recevoir, 1 pour accepter (facultatif), - un ou plusieurs numéros de téléphone mobile au format international avec ou sans + et entouré(s) pour chaque numéro des balises <MOBILEPHONE> et </MOBILEPHONE>. (ex.: 33600112233, +44700112233 – Pour la France, le 06 est accepté)
La page appelée vous retournera en réponse le status de votre requête (voir ci-dessous), son explication textuelle, votre crédit SMS restant et les numéros qui ont été refusés par le module. En cas d’erreur lors de la requête http, une copie de l’erreur vous sera envoyée par e-mail (si notification demandée). Si vos problèmes persistent, contactez le support .
La réponse du module HTTP SMS sera de la forme suivante, selon la correspondance décrite dans le tableau ci-après:
Status=100 StatusText=Le message a été envoyé Credits=416 UnvalidNums=0400000000
Status StatusText 100 Le message a été envoyé 101 Le message a été programmé pour un envoi différé 102 Probleme de connexion – Aucun compte ne correspond aux clientcode et passcode spécifiés 103 Crédit SMS épuisé. Veuillez recréditer votre compte sur AllMySMS.com 104 Crédit insuffisant pour traiter cet envoi. A utiliser: XX Crédits, Disponibles: XX Crédits. Veuillez recréditer votre compte sur AllMySMS.com 105 Flux XML Vide 106 Flux XML invalide ou incomplet après la balise <DATA> 107 Flux XML invalide ou incomplet après la balise <CLIENT> 108 Le code CLIENT donné dans le flux XML est incorrect, il doit correspondre au clientcode en majuscule 109 Flux XML invalide ou incomplet après la balise <MESSAGE> 110 Message non défini (vide) dans le flux XML 111 Le message dépasse 640 caractères 112 Flux XML invalide ou incomplet après la balise <MOBILEPHONE> 113 Certains numéros de téléphone sont invalides ou non pris en charge 114 Aucun numéro de téléphone valide dans le flux. Veuillez vous référer à la documentation en ligne pour connaitre les formats valides. 115 Flux XML invalide ou date mal formatée entre les balises <DATE> et </DATE>
Les statistiques d’envoi sont consultables sur allmysms.com (rubrique campagnes envoyées ) comme pour vos campagnes depuis le web ou le logiciel.