Mobile Terminated SMS Gateway Date : Version : 2.3. Contenu :

Transcription

1 Mobile Terminated SMS Gateway Date : Version : 2.3 Contenu :. Introduction 2. Connecter le SMS Gateway 3. Paramètres 4. Valeurs Retour 5. Rapport de livraison 6. Types de champs 7. Montant du crédit API

2 . Introduction: Ce document fournit les instructions nécessaires pour intégrer les services SMS- MT de Spryng et les diverses solutions pour utiliser Spryng SMS MT HTTP API. Lorsque vous créez un compte sur la page vous devez choisir un nom d utilisateur et un mot de passe qui sont spécifiques a votre compte. Le service SMS- MT HTTP API de Spryng supporte GET et HTTP Post avec un contenu de type : application/x- www- form- urlencoded via both HTTP and HTTPS. Pour plus d informations à propos de Spryng SMS- MT HTTP API, veuillez contacter le service support et assistance à l adresse suivante : info@spryng.fr. 2. Connecter le SMS Gateway : Pour envoyer un SMS, un HTTP GET ou un HTTP POST, vous devez vous rendre à l adresse suivante : Pour envoyer un SMS via HTTPS, vous devez vous rendre sur : Exemple pour envoyer des SMS: *****&DESTINATION=336********&SENDER=Spryng&ROUTE=BUSINESS&BODY=test&ALLO WLONG= ou ******&DESTINATION=336********&SENDER=Spryng&ROUTE=BUSINESS&BODY=test&ALL OWLONG=

3 3. Paramètres (nom des paramètres = sensible aux majuscules et minuscules) USERNAME PASSWORD REFERENCE DESTINATION SENDER BODY SERVICE ROUTE ALLOWLONG Choisi par l utilisateur lors de la création du compte sur Choisi par l utilisateur lors de la création du compte sur Reference unique pour les rapports de remise Numéro du destinataire Adresse de l expéditeur Contenu du SMS Etiquette a ajouter pour faire la différence entre les destinataires finaux. Pour sélectionner Spryng Business, Spryng Economy ou une autre route spéciale. Si vous souhaitez envoyer un long SMS NOM D UTILISATEUR Choisi par l utilisateur lors de la création du compte sur Alphanumérique, sensible aux majuscules et minuscules 2 32 USERNAME=username MOT DE PASSE Choisi par l utilisateur lors de la création du compte sur Type: Oui Alphanumérique, sensible aux majuscules et minuscules 6 32 PASSWORD=password

4 REFERENCE Reference unique pour les rapports de remise Type: Seulement si vous souhaitez recevoir des rapports de remise Alphanumérique 256 REFERENCE= abc23 Doit être unique DESTINATAIRE Numéro(s) de(s) destinataire(s) Type: Exemple: Oui MSISDN- numeric (format international important 00 or + ) MSISDN.000 MSISDN DESTINATION= , Plus de détails pour gérer les erreurs dans le chapitre 3 sur le résultat des valeurs EXPEDITEUR Adresse de l expéditeur Numeric or Alphanumeric 4 pour Numérique or pour Alphanumérique SENDER= SENDER=Votre nom

5 CORPS DU TEXTE Contenu du SMS GSM 7- bit alphabet pour le message texte 60 caract. pour le message texte (default : ALLOWLONG=0) 62 caract. (ALLOWLONG=) Lorsque vous utilisez des longs SMS, le système divisera automatiquement votre message en un message de 53 caractères par SMS. BODY=This%20is%20a%20test%20SMS Plus de détails sur les caractères dans le chapitre 5 sur le type de champs SERVICE Des étiquettes peuvent être utilisées pour créer un filtre dans les statistiques. non Alphanumérique 0 SERVICE=Client ROUTE Pour sélectionner la route Spryng Business, Spryng Economy ou une autre route spécifique. Prédéfini BUSINESS, ECONOMY, 0-9 (Route spécifique de l utilisateur) BUSINESS ROUTE=BUSINESS

6 LONG SMS Si vous souhaitez envoyer des longs SMS. Valeurs: Seulement si vous souhaitez envoyer des longs SMS Prédéfini 0, 0 ALLOWLONG= Lorsque vous utilisez des longs SMS, le système divisera automatiquement votre message en un message de 53 caractères par SMS. 4. Valeurs de retour : Reçu avec succès 00 paramètre manquant 0 nom d utilisateur trop court 02 nom d utilisateur trop long 03 mot de passe trop court 04 mot de passe trop long 05 destinataire trop court 06 destinataire trop long 07 expéditeur trop long 08 expéditeur trop court 09 corps du texte trop court 0 corps du texte trop long 200 Erreur de sécurité 20 route inconnue 202 violation d accès de la route 203 crédit insuffisant 800 erreur technique

7 5. Rapport de remise Vous pouvez gérer les rapports de remise en vous connectant sur votre compte sur et en sélectionnant dans le menu, l onglet paramètre dans votre tableau de bord SMS. Ici, vous pouvez entre un URL dans votre script (servlet, php script, perl, etc ) sur lequel vous recevrez les rapports de remises. Le script devrait recevoir deux paramètres qui sont envoyés via un HTTP GET. Lorsque vous souhaitez avoir un rapport de remise, vous ne devez pas spécifier plus de destinataire dans la requête. Les valeurs suivantes seront envoyées : 0 Délivré 20 Non délivré Exemple: REFERENCE=abc23&STATUS=0 6. Types de champs Numérique: caractères de 0 à 9 Alphanumérique: caractères de ISO MSISDN- numérique caractères 0 to 9 GSM 7- bit alphabet (caractères autorises dans les messages texte): Les caractères de 'a' a 'z', 'A' a 'Z', '0' a '9', saut de ligne, retour à la ligne $ èéùìòçøøåå_^{}\[~] ÆæßÉ!"# %&'()*+,-./:;<=>? ÄÖÑÜ äöñüà 7. Montant du credit API