TUTORIAL
Setting up SMPP access with smsmode©
SMPP or Short Message Peer-to-Peer is the protocol most often used by telecom companies and aggregators to connect directly to telephone operators.
SUMMARY
Why use the SMPP to connect to the platform smsmode© ?
Our customers can use our SMPP service to send and receive mobile messages (SMS MT & SMS MO), as well as message delivery reports (DLR) to and from the gateway. SMS smsmode©.
For customers who already have an SMPP implementation within their architecture, this connection enables them to avoid re-implementing the sending of messages via the API, which may be necessary following API updates. For customers without an SMPP implementation, it should be borne in mind that setting up this protocol can be quite complex, requiring low-level development.
How do I configure the SMPP connection?
Prerequisite
Contact our team by phone on +33(0)4 91 05 64 63 or by email at support(at)smsmode.com. Your account manager will set up your personalized SMPP access and send you your channel login details.
Direct use of Kannel
Edit the kannel.conf file and replace SMSMODE_USER and SMSMODE_PASSWORD with the credentials we've emailed you.
For security reasons, the default configuration uses SSL (certificate*.smsmode.com) and only authorizes connections from localhost. To authorize connections from a different machine, edit the required fields in kannel.conf. For example, for IP address 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"
Restart Kannel.
To send a message, make the following request:
http://localhost:13018/cgi-bin/sendsms?username=username&password=password&to=336XXXXXXXX&text=Hello%20World&from=MySenderID&dlr-mask=11
Using Kannel with Docker
For Docker users, smsmode© provides you with a Kannel image with the pre-defined configuration to ensure SMPP connection with the server smsmode©.
To use the smsmode© with Docker, simply follow these two steps:
To install and launch the Kannel image, run the following command, replacing SMSMODE_USER and SMSMODE_PASSWORD with the credentials we've emailed you.
docker run -d --name kannel -e 'SMSMODE_USER=COMPLETE-HERE' -e 'SMSMODE_PASSWORD=COMPLETE-HERE' -p 13018:13018 smsmode/kannel
Then, to send a message, run the following command and enter the desired number.
curl -v "http://localhost:13018/cgi-bin/sendsms?&username=username&password=password&to=336XXXXXXXX&from=MySenderID&text=Hello%20World&smsc=smsmodeFranceTrans&dlr-mask=11"