FAQ sur l'API SMPP

La FAQ suivante couvre les questions les plus fréquentes que nous recevons au support Ozeki concernant l'API SMPP proposée par Ozeki SMS Gateway.

L'API Short Message Peer-to-Peer (SMPP) est un protocole puissant pour la communication par SMS, permettant des échanges fluides entre applications et réseaux mobiles via des centres de messagerie (SMSC). Ozeki SMS Gateway intègre l'API SMPP pour offrir une plateforme robuste et sur site pour l'envoi et la réception de SMS, prenant en charge les versions 3.3, 3.4 et 5.0. Cette FAQ exhaustive aborde 100 questions critiques, compilées à partir d'analyses web et de cas d'utilisation pratiques, couvrant l'installation, la configuration, la programmation, la sécurité, la conformité RGPD, le dépannage et les fonctionnalités avancées. Que vous soyez un développeur ou une entreprise implémentant des solutions SMS, ces réponses vous guideront pour exploiter efficacement l'API SMPP avec Ozeki SMS Gateway.

Bases de l'API SMPP

1. Qu'est-ce que l'API SMPP et comment fonctionne-t-elle avec Ozeki SMS Gateway ?

L'API SMPP est un protocole pour échanger des SMS entre applications et SMSC en utilisant des unités de données de protocole (PDU). Ozeki SMS Gateway agit comme un client ou serveur SMPP, prenant en charge les versions 3.3, 3.4 et 5.0, permettant aux utilisateurs de configurer des connexions, d'envoyer/recevoir des messages et d'intégrer des bases de données ou applications pour une communication SMS efficace.

2. Quelles sont les principales versions du protocole SMPP prises en charge par Ozeki SMS Gateway ?

Ozeki SMS Gateway prend en charge SMPP v3.3 (liens séparés pour l'émission et la réception), v3.4 (mode transceiver pour une efficacité en lien unique) et v5.0 (champs TLV, adoption limitée). SMPP v3.4 est le plus répandu en raison de son efficacité et de sa compatibilité étendue.

3. Quelle est la différence entre SMPP v3.3, v3.4 et v5.0 ?

SMPP v3.3 (1997) utilise des liens séparés pour l'envoi et la réception. SMPP v3.4 introduit un mode transceiver pour un seul lien TCP/IP, améliorant l'efficacité. SMPP v5.0 (2003) ajoute des champs Type-Length-Value (TLV) et la diffusion cellulaire mais a une adoption limitée. Ozeki prend en charge les trois, avec v3.4 comme version par défaut.

4. Que sont les PDU SMPP et pourquoi sont-elles importantes ?

Les unités de données de protocole (PDU) sont des messages structurés dans l'API SMPP, comme bind_transceiver, submit_sm et deliver_sm, utilisés pour établir une connexion, envoyer et recevoir des messages. Elles assurent une communication fiable entre Ozeki SMS Gateway et le SMSC.

5. Quel est le rôle de la PDU bind_transceiver dans l'API SMPP ?

La PDU bind_transceiver authentifie et établit une seule connexion TCP/IP pour l'envoi et la réception de SMS et de rapports de livraison. Dans Ozeki, configurez-la avec les identifiants SMSC pour initier une session.

6. Comment fonctionne la PDU deliver_sm dans l'API SMPP ?

La PDU deliver_sm livre les SMS entrants ou les rapports de livraison du SMSC à Ozeki SMS Gateway. Elle inclut les numéros de l'expéditeur et du destinataire, le texte du message et le statut (ex. "DELIVRD"). Ozeki les achemine vers des applications ou bases de données.

7. À quoi sert la PDU enquire_link dans l'API SMPP ?

La PDU enquire_link vérifie l'état de la connexion entre Ozeki et le SMSC, évitant une déconnexion due à l'inactivité. Activez "Envoyer des paquets keepalive" dans Ozeki pour l'envoyer périodiquement (ex. toutes les 30 secondes).

8. Ozeki SMS Gateway peut-il agir à la fois comme client et serveur SMPP ?

Oui, Ozeki SMS Gateway peut fonctionner comme un client SMPP (se connectant à un SMSC) ou un serveur (acceptant des connexions d'autres clients), permettant un routage flexible des SMS pour des configurations mono ou multi-applications.

9. Quels types d'applications bénéficient de l'API SMPP ?

L'API SMPP est idéale pour les applications nécessitant des SMS en masse, des échanges bidirectionnels ou un suivi de livraison, comme les campagnes marketing, l'authentification à deux facteurs, les notifications et les systèmes de support client.

10. Pourquoi SMPP v3.4 est-il la version la plus utilisée ?

Le mode transceiver de SMPP v3.4 utilise un seul lien TCP/IP pour l'envoi et la réception, réduisant l'utilisation des ressources et simplifiant la gestion des connexions. Son adoption généralisée et sa compatibilité en font la norme pour Ozeki et la plupart des SMSC.

Installation et configuration

11. Comment configurer une connexion client SMPP dans Ozeki SMS Gateway ?

Dans la console de gestion d'Ozeki, allez dans "Connexions", sélectionnez "Ajouter une nouvelle connexion" > "Client SMPP", et entrez l'hôte du SMSC (ex. "192.168.1.1"), le port (ex. 9500), le nom d'utilisateur, le mot de passe et SMPP v3.4. Activez "Se connecter automatiquement" et "Envoyer des paquets keepalive", puis cliquez sur "Connecter".

12. Comment configurer Ozeki SMS Gateway comme serveur SMPP ?

Dans la console de gestion, sélectionnez "Ajouter une nouvelle connexion" > "Serveur SMPP". Spécifiez un port (ex. 9500), définissez les identifiants utilisateur et configurez le mode de liaison (transceiver recommandé). Activez la journalisation et configurez le routage pour transférer les messages vers des applications ou autres connexions.

13. Quels identifiants sont nécessaires pour une connexion client SMPP ?

Vous avez besoin du nom d'hôte/IP du SMSC, du port, du nom d'utilisateur (ID système), du mot de passe, et éventuellement du type système et de la plage d'adresses, fournis par votre opérateur SMS. Entrez-les dans les paramètres du client SMPP d'Ozeki.

14. Comment activer les rapports de livraison dans Ozeki SMS Gateway ?

Dans l'onglet "Avancé" du client SMPP, cochez "Demander un rapport de livraison" pour instruire le SMSC d'envoyer des reçus via des PDU deliver_sm. Assurez-vous que votre SMSC prend en charge les rapports de livraison.

15. Comment configurer un numéro virtuel pour recevoir des SMS dans Ozeki ?

Obtenez un numéro virtuel (IMSI) auprès de votre fournisseur SMSC et entrez-le dans le champ "Plage d'adresses" du client SMPP. Configurez Ozeki pour acheminer les PDU deliver_sm vers une base de données ou une application.

16. Puis-je utiliser plusieurs connexions SMPP dans Ozeki SMS Gateway ?

Oui, Ozeki prend en charge plusieurs connexions client SMPP pour l'équilibrage de charge ou différents fournisseurs. Ajoutez chaque connexion dans le panneau "Connexions" avec des identifiants uniques et configurez des règles de routage.

17. Comment configurer Ozeki pour stocker les SMS dans une base de données ?

Créez un utilisateur de base de données dans la console de gestion d'Ozeki, spécifiez une connexion (ex. MySQL), et définissez des requêtes SQL (ex. INSERT INTO ozekimessagein (sender, receiver, msg) VALUES (?, ?, ?)) pour stocker les SMS entrants et les rapports de livraison.

18. Quel est le port par défaut pour les connexions SMPP ?

Le port SMPP par défaut est 2775, mais de nombreux fournisseurs, y compris ceux compatibles avec Ozeki, utilisent des ports personnalisés comme 9500 pour les connexions standard ou 9501 pour SMPPS. Confirmez avec votre fournisseur SMSC.

19. Comment activer la journalisation des PDU SMPP dans Ozeki ?

Dans l'onglet "Avancé" du client SMPP, activez "Journaliser les événements de communication" pour capturer des PDU comme bind_transceiver et deliver_sm. Consultez les journaux dans le panneau "Événements" pour le débogage.

20. Comment tester une connexion SMPP avant la mise en production ?

Utilisez un simulateur SMSC (ex. Melrose Labs) pour tester l'API SMPP. Configurez Ozeki avec l'hôte/port du simulateur, envoyez/recevez des messages tests et vérifiez les journaux pour valider les échanges de PDU avant de vous connecter à un SMSC réel.

21. Puis-je utiliser l'API SMPP sans fournisseur SMSC ?

Non, l'API SMPP nécessite un SMSC pour acheminer les messages vers les réseaux mobiles. Ozeki SMS Gateway se connecte à un SMSC comme client ou agit comme serveur SMSC pour d'autres clients.

22. Comment configurer Ozeki pour des connexions SMPP haute disponibilité ?

Configurez plusieurs connexions client SMPP vers différents SMSC pour la redondance. Activez "Se connecter automatiquement au démarrage" et surveillez l'état des connexions dans le panneau "Connexions" d'Ozeki pour assurer le basculement.

23. Qu'est-ce que le champ Type système dans la configuration SMPP ?

Le type système est un champ optionnel dans la PDU bind_transceiver, souvent défini sur "SMPP" ou une valeur spécifique au fournisseur. Il identifie l'objectif du client et est configuré dans les paramètres du client SMPP d'Ozeki.

24. Comment gérer plusieurs fournisseurs SMSC dans Ozeki ?

Ajoutez des connexions client SMPP séparées pour chaque SMSC dans le panneau "Connexions" d'Ozeki. Utilisez des règles de routage pour prioriser les fournisseurs selon le coût, la fiabilité ou la région pour une livraison efficace.

25. Comment configurer Ozeki pour gérer les demandes de désinscription ?

Configurez un utilisateur de base de données pour détecter les messages entrants "STOP" via des PDU deliver_sm. Utilisez une requête SQL (ex. UPDATE consent_log SET status='opt-out' WHERE msg='STOP') pour mettre à jour les enregistrements de consentement.

26. Puis-je utiliser Ozeki SMS Gateway avec un serveur proxy ?

Ozeki ne prend pas directement en charge les serveurs proxy pour les connexions SMPP. Configurez votre réseau pour autoriser un accès TCP/IP direct à l'hôte/port du SMSC, en assurant que les règles de pare-feu permettent les connexions sortantes.

27. Comment configurer l'API SMPP pour la messagerie bidirectionnelle ?

Utilisez le mode transceiver avec bind_transceiver pour envoyer et recevoir des SMS. Configurez Ozeki pour acheminer les PDU deliver_sm vers une application ou base de données pour traiter les réponses, permettant une communication bidirectionnelle.

28. Comment configurer Ozeki pour des campagnes de SMS en masse ?

Configurez une connexion client SMPP, utilisez une base de données pour stocker les listes de destinataires et envoyez des messages via le panneau "Messages" ou l'API d'Ozeki. Implémentez une limitation de débit pour éviter la limitation et assurez-vous que les rapports de livraison sont activés.

29. Qu'est-ce que le champ Plage d'adresses dans la configuration SMPP ?

Le champ Plage d'adresses dans la PDU bind_transceiver spécifie les numéros pour recevoir des SMS. Dans Ozeki, définissez-le sur un numéro virtuel ou un motif (ex. "+123*") fourni par votre SMSC pour filtrer les messages entrants.

30. Comment mettre à jour Ozeki SMS Gateway vers la dernière version ?

Téléchargez la dernière version (Ozeki SMS Gateway) depuis la page de téléchargement d'Ozeki SMS Gateway, sauvegardez votre répertoire de données (C:\Program Files\Ozeki\Data) et suivez le guide d'installation pour la mise à niveau, en assurant la compatibilité avec les fonctionnalités de l'API SMPP.

Programmation avec l'API SMPP

31. Comment envoyer des SMS avec l'API SMPP en Python ?

Utilisez une bibliothèque SMPP Python comme smpp.py. Connectez-vous au SMSC via le port serveur SMPP d'Ozeki, envoyez une PDU submit_sm avec l'expéditeur, le destinataire et le texte du message, et gérez les réponses. L'API HTTP d'Ozeki peut aussi être utilisée pour une intégration plus simple.

32. Comment envoyer des SMS avec l'API SMPP en Java ?

Utilisez une bibliothèque SMPP Java comme JSMPP. Configurez une connexion au serveur SMPP d'Ozeki ou à un SMSC, créez une PDU submit_sm et spécifiez les paramètres du message. La documentation de l'API d'Ozeki fournit des exemples de code pour l'intégration.

33. Comment envoyer des SMS avec l'API SMPP en C# ?

Utilisez une bibliothèque SMPP C# ou l'API .NET d'Ozeki. Connectez-vous au SMSC ou au serveur SMPP d'Ozeki, construisez une PDU submit_sm et envoyez des messages avec un encodage approprié. Consultez la documentation d'Ozeki pour des exemples en C#.

34. Comment envoyer des SMS avec l'API SMPP en PHP ?

Utilisez une bibliothèque SMPP PHP comme PHP-SMPP. Connectez-vous au serveur SMPP d'Ozeki, authentifiez-vous avec bind_transceiver et envoyez des PDU submit_sm. Alternativement, utilisez l'API HTTP d'Ozeki pour un envoi de SMS plus simple.

35. Comment envoyer des SMS avec l'API SMPP en JavaScript/Node.js ?

Utilisez la bibliothèque node-smpp. Connectez-vous au serveur SMPP d'Ozeki, authentifiez-vous et envoyez des PDU submit_sm. L'API HTTP d'Ozeki est une alternative pour les applications Node.js, simplifiant l'intégration.

36. Comment envoyer des SMS avec l'API SMPP en C++ ?

Utilisez une bibliothèque SMPP C++ ou créez un client personnalisé pour vous connecter au serveur SMPP d'Ozeki. Construisez des PDU submit_sm avec les détails du message. La documentation d'Ozeki fournit des exemples en C++ pour l'intégration de l'API SMPP.

37. Comment recevoir des SMS avec l'API SMPP en Python ?

Utilisez smpp.py pour vous lier en tant que transceiver et écouter les PDU deliver_sm. Analysez le champ short_message de la PDU pour le contenu du SMS et acheminez-le via l'intégration de base de données ou d'application d'Ozeki.

38. Comment recevoir des rapports de livraison avec l'API SMPP en Java ?

Avec JSMPP, liez-vous en tant que transceiver et gérez les PDU deliver_sm avec ESM Class 0x04. Extrayez l'ID du message et le statut (ex. "DELIVRD") et stockez-les via l'intégration de base de données d'Ozeki.

39. Comment gérer les messages SMS longs programmatiquement ?

Divisez les messages longs en parties (153 caractères pour GSM 7-bit, 67 pour UCS2), ajoutez un en-tête de données utilisateur (UDH) pour la concaténation et envoyez via des PDU submit_sm. Ozeki gère automatiquement la concaténation si configuré dans les paramètres du client SMPP.

40. Comment implémenter des opérations asynchrones avec l'API SMPP dans Ozeki ?

Configurez le client SMPP d'Ozeki en mode asynchrone dans l'onglet "Avancé", en définissant une taille de fenêtre (ex. 10) pour les PDU non acquittées. Utilisez des bibliothèques comme JSMPP ou node-smpp pour envoyer plusieurs PDU submit_sm sans attendre de réponses.

41. Comment analyser les formats de reçus de livraison en Python ?

Analysez le champ short_message de la PDU deliver_sm avec des regex pour extraire des champs comme id, stat et err. Stockez les résultats dans la base de données d'Ozeki en utilisant un script Python intégré à l'API d'Ozeki.

42. Puis-je utiliser l'API HTTP d'Ozeki au lieu de SMPP pour la programmation ?

Oui, l'API HTTP d'Ozeki simplifie l'envoi/réception de SMS sans manipulation directe des PDU SMPP. Utilisez des points de terminaison REST (ex. /api?action=sendmessage) pour l'intégration avec des langages comme Python ou PHP.

43. Comment gérer les messages Unicode dans la programmation de l'API SMPP ?

Définissez le schéma de codage des données (DCS) à 8 pour l'encodage UCS2 dans les PDU submit_sm. Divisez les messages Unicode longs en parties de 67 caractères avec UDH. Configurez le client SMPP d'Ozeki pour prendre en charge UCS2 dans l'onglet "Avancé".

44. Comment implémenter une logique de réessai pour les messages SMPP échoués ?

Surveillez les PDU submit_sm_resp pour les codes d'erreur (ex. ESME_RTHROTTLED). Implémentez une logique de réessai avec un backoff exponentiel et configurez Ozeki pour journaliser les tentatives échouées pour analyse.

45. Comment intégrer l'API SMPP avec une application web ?

Utilisez l'API HTTP d'Ozeki pour envoyer/recevoir des SMS depuis une application web ou connectez-vous directement au serveur SMPP d'Ozeki avec une bibliothèque comme node-smpp. Acheminez les messages entrants vers votre application via la base de données ou les webhooks d'Ozeki.

46. Comment envoyer des SMS flash avec l'API SMPP ?

Définissez l'ESM Class dans la PDU submit_sm à 0x10 pour les SMS flash (affichés directement sur l'écran du destinataire). Configurez le client SMPP d'Ozeki pour prendre en charge cela dans l'onglet "Avancé", si autorisé par votre SMSC.

47. Comment gérer les messages SMS binaires avec l'API SMPP ?

Utilisez DCS 4 pour les messages binaires dans les PDU submit_sm. Encodez le message en format binaire (ex. pour WAP push) et configurez Ozeki pour traiter le contenu binaire via les paramètres du client SMPP.

48. Comment surveiller le trafic de l'API SMPP programmatiquement ?

Activez la journalisation des PDU dans l'onglet "Avancé" d'Ozeki et analysez les journaux avec un script (ex. Python) pour extraire les détails des PDU. Alternativement, utilisez une bibliothèque comme JSMPP pour capturer et analyser le trafic SMPP en temps réel.

49. Comment implémenter une file d'attente de messages dans les applications SMPP ?

Utilisez une file d'attente (ex. RabbitMQ) pour tamponner les messages avant l'envoi via le client SMPP d'Ozeki. Configurez Ozeki pour tirer les messages de la file en utilisant une intégration de base de données ou d'API pour une livraison contrôlée.

50. Comment gérer plusieurs langues dans les messages SMS ?

Utilisez l'encodage UCS2 (DCS 8) pour les langues non latines (ex. arabe, chinois). Configurez le client SMPP d'Ozeki pour prendre en charge UCS2 et testez les messages pour assurer un rendu correct sur les appareils des destinataires.

Sécurité et conformité

51. Comment assurer la conformité RGPD avec Ozeki SMS Gateway ?

Obtenez un consentement explicite via des formulaires d'opt-in, incluez des options de désinscription (ex. "Répondez STOP") et stockez les enregistrements de consentement dans une base de données. Utilisez SMPPS pour le chiffrement, sécurisez le serveur d'Ozeki et conservez un minimum de données pour une période limitée (ex. 30 jours).

52. Comment activer SMPPS (SMPP sur SSL/TLS) dans Ozeki ?

Dans les paramètres du client SMPP, spécifiez le port sécurisé du SMSC (ex. 9501) et activez SSL dans l'onglet "Avancé". Assurez-vous que votre SMSC prend en charge SMPPS pour une transmission chiffrée.

53. Comment sécuriser l'interface web d'Ozeki ?

Changez le mot de passe admin par défaut (admin/abc123), activez HTTPS (port 443) et restreignez l'accès aux IPs de confiance dans le menu "Préférences serveur". Utilisez des règles de pare-feu pour limiter l'accès à http://127.0.0.1:9501.

54. Comment empêcher l'accès non autorisé aux connexions SMPP ?

Utilisez des identifiants SMSC forts, activez SMPPS et configurez Ozeki pour autoriser uniquement les connexions depuis des IPs spécifiques. Surveillez les journaux pour les tentatives de liaison non autorisées et mettez à jour Ozeki pour corriger les vulnérabilités.

55. Comment implémenter une limitation de débit pour les connexions SMPP entrantes ?

Dans les paramètres du serveur SMPP d'Ozeki, définissez un débit maximal (ex. 10 messages/seconde) par client dans l'onglet "Avancé" pour éviter les abus et assurer une utilisation équitable des ressources.

56. Comment implémenter une limitation de débit pour les connexions SMPP sortantes ?

Configurez le client SMPP d'Ozeki pour limiter les soumissions (ex. 50 messages/seconde) dans l'onglet "Avancé". Alignez-vous avec les limites TPS de votre SMSC pour éviter les erreurs ESME_RTHROTTLED.

57. Comment limiter les liaisons SMPP pour éviter les abus ?

Dans les paramètres du serveur SMPP d'Ozeki, définissez un nombre maximal de liaisons (ex. 5 par client) dans l'onglet "Avancé". Surveillez les liaisons actives dans le panneau "Connexions" pour éviter la surcharge.

58. Comment gérer les droits des personnes concernées sous le RGPD avec Ozeki ?

Configurez Ozeki pour stocker les données SMS dans une base de données. Gérez les demandes d'accès, de rectification ou d'effacement avec des requêtes SQL (ex. DELETE FROM ozekimessagein WHERE phone_number='...';) dans le délai de 30 jours du RGPD.

59. Comment sécuriser le stockage des bases de données dans Ozeki SMS Gateway ?

Utilisez une base de données chiffrée (ex. MySQL avec ENCRYPTION) et restreignez l'accès avec des identifiants forts. Configurez l'utilisateur de base de données d'Ozeki pour utiliser des chaînes de connexion sécurisées sans paramètres non sécurisés.

60. Comment résoudre les vulnérabilités connues dans Ozeki SMS Gateway ?

Mettez à niveau vers Ozeki 10, qui corrige des problèmes comme l'injection CSV et les vulnérabilités de suppression de fichiers dans les versions jusqu'à 4.17.6. Vérifiez régulièrement cvedetails.com pour les mises à jour.

61. Comment activer l'authentification à deux facteurs pour l'interface admin d'Ozeki ?

Ozeki ne prend pas en charge nativement l'authentification à deux facteurs (2FA). Implémentez la 2FA au niveau du serveur avec des outils comme Duo ou Authy, et restreignez l'interface web d'Ozeki à un VPN pour plus de sécurité.

62. Comment assurer la conformité PECR pour le marketing SMS ?

Selon PECR, obtenez un consentement explicite ou utilisez l'opt-in doux pour les clients existants. Incluez des instructions de désinscription (ex. "Répondez STOP") dans chaque SMS marketing et traitez les désinscriptions via l'intégration de base de données d'Ozeki.

63. Comment chiffrer les sauvegardes SMPP dans Ozeki ?

Sauvegardez le répertoire de données d'Ozeki (C:\Program Files\Ozeki\Data) et chiffrez-le avec des outils comme VeraCrypt. Planifiez des sauvegardes automatisées et chiffrées en suivant le guide de sauvegarde d'Ozeki.

64. Comment surveiller les journaux de sécurité de l'API SMPP ?

Activez "Journaliser les événements de communication" dans les paramètres client/serveur SMPP d'Ozeki. Consultez les journaux dans le panneau "Événements" pour les tentatives de liaison, erreurs ou activités suspectes, et exportez-les pour des audits.

65. Comment me conformer aux politiques de conservation des données dans Ozeki ?

Configurez Ozeki pour supprimer les messages après une période définie (ex. 30 jours) dans le menu "Préférences serveur". Utilisez des scripts SQL (ex. DELETE FROM ozekimessagein WHERE timestamp < DATE_SUB(NOW(), INTERVAL 30 DAY)) pour un nettoyage automatisé.

66. Comment gérer les violations de données dans Ozeki SMS Gateway ?

Surveillez les journaux pour les accès non autorisés, isolez le serveur et notifiez les utilisateurs affectés dans les 72 heures du RGPD. Mettez à jour Ozeki, corrigez les vulnérabilités et révisez les paramètres de sécurité pour éviter une récidive.

67. Comment restreindre l'accès à l'API SMPP à des utilisateurs spécifiques ?

Dans les paramètres du serveur SMPP d'Ozeki, définissez des identifiants utilisateur et des limites de liaison. Utilisez une liste blanche d'IP dans le menu "Préférences serveur" pour restreindre l'accès aux clients autorisés uniquement.

68. Comment implémenter des pistes d'audit pour l'activité SMPP ?

Activez la journalisation des PDU dans Ozeki et stockez les journaux dans une base de données. Utilisez des requêtes SQL pour suivre les envois, reçus et tentatives de liaison, créant une piste d'audit vérifiable pour la conformité.

69. Comment sécuriser les connexions SMPP sur des réseaux publics ?

Utilisez SMPPS avec SSL/TLS et configurez Ozeki pour se connecter via un VPN ou un tunnel SSH pour chiffrer le trafic sur les réseaux publics, assurant une communication sécurisée avec le SMSC.