Configurer une connexion SMPP au Maroc : guide pas-à-pas pour les entreprises à fort volume

La solution standard de l'industrie télécom est le protocole SMPP (Short Message Peer-to-Peer).

Bien qu'il soit extrêmement rapide et asynchrone, configurer une connexion SMPP directe avec les passerelles marocaines demande une rigueur d'ingénierie absolue. Voici comment réussir cette intégration.

Le SMPP (actuellement en v3.4 pour la majorité des passerelles) est un protocole binaire fonctionnant sur TCP/IP. Contrairement à HTTP où vous ouvrez et fermez une connexion pour chaque envoi, le SMPP ouvre un tunnel permanent (un Bind) entre votre serveur (l'ESME) et la passerelle du fournisseur (le SMSC).

Ce que cela apporte :

• Débit massif : Vous envoyez un flux binaire continu. Pas de headers HTTP lourds. Le débit n'est plus limité par une requête HTTP par message.
• DLR natifs et asynchrones : Les Delivery Reports (Accusés de réception) remontent de l'opérateur marocain (IAM, inwi, Orange) directement dans ce même tunnel TCP. Vous n'avez plus besoin d'exposer un webhook web sur votre serveur.

À partir de quand l'utiliser ?
Le développement d'un client SMPP prend 10 fois plus de temps qu'une intégration API. N'utilisez SMPP que si votre volume excède 1 million de SMS par mois ou si votre SLA d'OTP exige une soumission à la passerelle en moins de 100 millisecondes.

Pour établir une connexion SMPP avec une passerelle qui la propose (chez EnvoiSMS, le SMPP n'est proposé que sur demande, pour les gros volumes ; par défaut, les envois passent par l'API REST et son endpoint bulk), votre fournisseur vous fournira 4 éléments vitaux : l'IP, le Port, le System ID (votre login) et le Password.

Mais vous devez configurer le comportement de votre client SMPP de manière optimale :

1. Le Bind Type :

• Transmitter (TX) : Pour uniquement envoyer des SMS.
• Receiver (RX) : Pour uniquement recevoir les DLR et SMS entrants.
• Transceiver (TRX) : La recommandation standard. Permet d'envoyer et de recevoir sur la même connexion TCP.

1. Le fenêtrage (Window Size) : C'est le secret de la vitesse du SMPP. C'est le nombre de messages que vous pouvez envoyer dans le tunnel avant d'attendre la confirmation (Acknowledge) du serveur. Si le serveur autorise une fenêtre de 50, vous envoyez 50 PDU asynchrones d'un coup.
2. L'Enquire Link (Keep-alive) : Étant donné que le tunnel doit rester ouvert 24/7, votre script doit envoyer un enquire_link toutes les 30 ou 60 secondes pour prouver au serveur opérateur que vous êtes toujours en ligne.

Ne vous connectez jamais directement à l'adresse de production. Une boucle d'erreur de votre code SMPP peut inonder le serveur (DDoS involontaire) et entraîner la suspension de votre IP.

1. Connectez-vous à la Sandbox SMPP du fournisseur.
2. Envoyez un submit_sm (la requête d'envoi d'un SMS) avec un numéro de test (ex: +212600000000).
3. Vérifiez la réception du submit_sm_resp avec un statut ESME_ROK (Code 0x00000000), ce qui signifie que l'envoi est validé.
4. Laissez votre client inactif pendant 10 minutes pour vérifier que votre mécanisme enquire_link maintient bien la connexion sans Timeout.

• L'encodage DCS (Data Coding Scheme) : C'est le problème #1 au Maroc. En SMPP, vous devez préciser explicitement le format de votre texte. Pour du français standard, utilisez DCS 0x00 (SMSC Default) ou 0x01 (ASCII). Pour la darija avec caractères arabes, vous devez obligatoirement convertir votre texte en Hexadécimal et définir le DCS sur 0x08 (UCS-2).
• Le format TON/NPI : Pour des numéros de destination marocains internationaux (+212), vous devez configurer le TON (Type of Number) sur 1 (International) et le NPI (Numbering Plan Indicator) sur 1 (ISDN/E.164). Si vous laissez ces valeurs à 0, Maroc Telecom ou Orange peuvent rejeter la trame.
• Rupture de la file d'attente (Queue Drop) : Si votre connexion TCP coupe, tous les SMS de votre RAM non confirmés par la passerelle sont perdus. Votre client doit utiliser un système externe comme Redis ou RabbitMQ pour garantir que tout message non "Acké" est remis dans la file pour la prochaine reconnexion.