TUTORIEL
Paramétrage de l’accès SMPP avec smsmode©
Le SMPP ou Short Message Peer-to-Peer est le protocole le plus souvent utilisé par les sociétés de télécommunication et agrégateurs pour se connecter directement aux opérateurs téléphoniques.
Sommaire
Pourquoi utiliser le SMPP pour me connecter à la plateforme smsmode© ?
Nos clients peuvent utiliser notre service SMPP pour envoyer et recevoir des messages mobiles (SMS MT & SMS MO), ainsi que les rapports de remise de ces messages (DLR) à destination et en provenance de la passerelle SMS smsmode©.
Pour les clients ayant déjà une implémentation SMPP au sein de leur architecture, cette connexion leur permet d’éviter de ré-implémenter l’envoi de messages via l’API qui peuvent être nécessaires suite aux mises à jour de cette dernière. Pour les clients n’ayant pas d’implémentation SMPP, il faut prendre en compte que la mise en place de ce protocole peut s’avérer être assez complexe tout en requérant un développement de bas niveau.
Comment configurer la connexion SMPP ?
Pré-requis
Contactez notre équipe par téléphone au +33(0)4 91 05 64 63 ou par email à support(at)smsmode.com. Votre account manager configurera votre accès SMPP personnalisé et vous enverra vos identifiants de connexion au canal.
Utilisation directe de Kannel
Éditer le fichier kannel.conf et remplacer SMSMODE_USER et SMSMODE_PASSWORD par les identifiants que nous vous avons communiqué par email.
Pour des raisons de sécurité, la configuration par défaut utilise le SSL (certificat*.smsmode.com) et n’autorise que les connexions venant de localhost. Afin d’autoriser les connexions d’une machine différente, éditer les champs requis dans kannel.conf. Par exemple, pour l’addresse IP X.X.X.X :
admin-allow-ip = "127.0.0.1;X.X.X.X"
box-allow-ip = "127.0.0.1;X.X.X.X"
user-allow-ip = "127.0.0.1;X.X.X.X"
Redémarrer Kannel.
Pour envoyer un message, effectuez la requête suivante :
http://localhost:13018/cgi-bin/sendsms?username=username&password=password&to=336XXXXXXXX&text=Hello%20World&from=MySenderID&dlr-mask=11
Utilisation de Kannel avec Docker
Pour les utilisateurs de Docker, smsmode© vous met à disposition une image Kannel avec la configuration pré-définie pour assurer la connexion SMPP avec le serveur smsmode©.
Pour utiliser le service SMPP de smsmode© avec Docker, il suffit de suivre les deux étapes suivantes :
Pour installer et lancer l’image Kannel, exécutez la commande suivante en remplaçant SMSMODE_USER et SMSMODE_PASSWORD par les identifiants que nous vous avons communiqués par email.
docker run -d --name kannel -e 'SMSMODE_USER=COMPLETE-HERE' -e 'SMSMODE_PASSWORD=COMPLETE-HERE' -p 13018:13018 smsmode/kannel
Ensuite, pour l’envoi de message, exécutez le commande suivante en renseignant le numéro désiré.
curl -v "http://localhost:13018/cgi-bin/sendsms?&username=username&password=password&to=336XXXXXXXX&from=MySenderID&text=Hello%20World&smsc=smsmodeFranceTrans&dlr-mask=11"