Paramètres de compte externe SMPP

Paramètres du canal SMPP

Autoriser la translittération des caractères

La translittération est le processus de recherche de caractères équivalents à ceux qui sont manquants. Par exemple, le caractère français « ê » (avec un accent circonflexe) est absent de l’encodage GSM, mais il peut être remplacé par un « e » sans trop nuire à la lisibilité.

Si cette case n'est pas cochée, l'encodage du texte échoue s'il ne peut pas coder la chaîne telle quelle.

Si cette case est cochée, l'encodage de texte tentera de convertir la chaîne en une version approximative plutôt que d'échouer. Si certains caractères n'ont pas d'équivalent en encodage de cible, l'encodage de texte échoue.

Pour obtenir une explication plus générale du processus d'encodage, consultez la section Définir un mapping spécifique du paramètre d'encodage.

Numéro source

Définit l’adresse source par défaut des messages. Ce paramètre ne s’applique que si le numéro source a été laissé vide dans la diffusion. Par défaut, le champ du numéro source n’est pas transmis.Le fournisseur le remplace donc par le numéro court.

Ceci active la fonction d’écrasement de l’adresse d’expédition/oADC.

NPI/TON source, NPI/TON destination

TON (type de numéro) et NPI (indicateur de plan de numérotation) décrits à la section 5.2.5 de la spécification SMPP 3.4. Ces valeurs doivent être définies selon les besoins du fournisseur.

Elles sont transmises telles quelles dans les champs source_addr_ton, source_addr_npi, dest_addr_ton and dest_addr_npi du PDU SUBMIT_SM.

Type de service

Ce champ est transmis tel quel dans le champ service_type du PDU SUBMIT_SM. Définissez cette variable en fonction des besoins du fournisseur.

Débits et délais

Ces paramètres contrôlent tous les aspects du timing du canal SMPP. Certains fournisseurs ont besoin d’un contrôle très précis du taux de message, des délais de fenêtre et de reprise. Ces paramètres doivent donc être définis sur des valeurs correspondant à la capacité du fournisseur et aux conditions indiquées dans son contrat.

Fenêtre d’émission

La fenêtre est le nombre de PDU SUBMIT_SM qui peuvent être envoyés sans attendre un SUBMIT_SM_RESP correspondant.

Exemple de transmission avec une fenêtre maximale de 4 :

La fenêtre permet d’augmenter le débit lorsque la liaison réseau présente une latence élevée. La valeur de la fenêtre doit être au moins égale au nombre de SMS/s multiplié par la latence du lien en secondes, de sorte que le connecteur n’attend jamais un SUBMIT_SM_RESP avant d’envoyer le message suivant.

Si la fenêtre est trop grande, vous pouvez envoyer plus de messages en doublons en cas de problème de connexion (cela est rare). En outre, la plupart des fournisseurs ont une limite très stricte pour la fenêtre et refusent les messages qui dépassent la limite.

Comment calculer la formule optimale de la fenêtre d'émission :

Mesurez la latence maximale entre SUBMIT_SM et SUBMIT_SM_RESP.
Multipliez cette valeur (en secondes) par le débit maximal MT : cela donnera la valeur optimale de la fenêtre d’émission.
Exemple : si 300 SMS/s sont définis dans le débit maximal MT et qu’il y a une latence de 100 ms entre SUBMIT_SM et SUBMIT_SM_RESP en moyenne, la valeur optimale sera 300x0,1 = 30.

En cas de doute, préférez une fenêtre plus grande pour éviter les problèmes de performances.

Débit max de MT

Nombre maximal de MT par seconde et par connexion. Ce paramètre est strictement appliqué, le MTA n'enverra jamais de messages plus rapidement que cette limite. Il est utile pour les fournisseurs qui nécessitent un ralentissement précis.

Pour connaître la limite de débit totale, multipliez ce nombre par le nombre total de connexions, comme indiqué dans la formule ci-dessus.

0 signifie pas de limite, le MTA enverra le MT aussi vite que possible.

Il est généralement recommandé de maintenir ce paramètre en dessous de 1000, puisqu’il est impossible de garantir un débit précis au-dessus de ce nombre, à moins que l’architecture finale ne soit correctement évaluée et que le fournisseur SMPP ait été spécifiquement demandé. Il peut être préférable d'augmenter le nombre de connexions au-dessus de 1000 MT/s.

Temps avant reconnexion

Lorsque la connexion TCP est perdue, le connecteur attend ce nombre de secondes avant d'essayer d'établir une connexion.

Délai d'expiration des MT

Il s’agit du délai entre SUBMIT_SM et son SUBMIT_SM_RESP correspondant. Si le RESP n’est pas reçu à temps, le message sera considéré comme ayant échoué et la politique de reprise globale du MTA s’appliquera.

Délai d’attente maximal d’un bind

Délai entre la tentative de connexion TCP et la réponse BIND_*_RESP. Lorsqu’elle expire, la connexion est fermée par le connecteur Campaign et il faut attendre la valeur du temps avant reconnexion avant de réessayer.

Spécificités du SMSC

Activer message_payload

Lorsque l’option n’est pas cochée, les SMS longs sont fractionnés par le MTA et envoyés dans plusieurs PDU SUBMIT_SM avec l’UDH. Le message est recomposé par le téléphone portable suivant les données UDH.

Si cette option est cochée, un SMS long est envoyé dans un PDU SUBMIT_SM, plaçant le texte dans le champ message_payload facultatif (voir la spécification SMPP pour plus d’informations sur le sujet).

Si cette fonction est activée, Campaign ne peut pas comptabiliser les parties SMS individuellement : tous les messages sont comptés comme envoyés en une seule partie.

Envoyer le numéro de téléphone complet

Si cette case n’est pas cochée, seuls les chiffres du numéro de téléphone sont envoyés au fournisseur (champ destination_addr du champ SUBMIT_SM). Il s’agit du comportement par défaut puisque l’indicateur de numéro international, généralement un préfixe +, est remplacé par les champs TON et NPI en SMPP.

Si cette case est cochée, le numéro de téléphone est envoyé tel quel, sans prétraitement ni espaces potentiels, préfixe + ou signes livre sterling/dièse/étoile.

Cette fonctionnalité a également un effet sur le comportement de la fonctionnalité de quarantaine et de réponse automatique : lorsque la case n’est pas cochée, un préfixe + est ajouté aux numéros de téléphone insérés dans le tableau de quarantaine afin de compenser la suppression du préfixe + du numéro de téléphone par le protocole SMPP lui-même.

Expression régulière d'extraction de l'ID dans le SR

Le format SR n’est pas strictement appliqué par la spécification du protocole SMPP. Il ne s’agit que d’une recommandation décrite à l’annexe B de la spécification. Certains implémenteurs SMPP formatent ce champ différemment, de sorte que Campaign a besoin d’un moyen d’extraire le champ correct.

Par défaut, il capture jusqu’à 10 caractères alphanumériques après « id ».

L’expression régulière doit comporter exactement un groupe de capture (une partie entre parenthèses). Les parenthèses doivent entourer la partie qui correspond à l’identifiant. Le format d’expression régulière est PCRE.

Lors de la modification de ce paramètre, veillez à inclure le plus de contexte possible pour éviter les faux triggers. S’il existe des préfixes spécifiques, tels que « id » dans la norme, incluez-les dans l’expression régulière. Utilisez également autant que possible des délimiteurs de mots (\b) pour éviter de capturer du texte au milieu d’un mot.

Ne pas inclure suffisamment de contexte dans l’expression régulière peut introduire un petit défaut de sécurité : le contenu réel du message peut être inclus dans le SR. Ainsi, si vous faites simplement correspondre un format d’ID spécifique sans contexte (par exemple un UUID), il peut analyser le contenu réel du texte (par exemple un UUID incorporé dans le champ de texte) au lieu de l’ID.

Regex d’extraction du statut dans le SR

Cette expression régulière capture le statut à partir du champ de texte des messages SR.

Par défaut, il capture entre 5 et 15 caractères après « stat: ».

L’expression régulière doit comporter exactement un groupe de capture (une partie entre parenthèses). Les parenthèses doivent entourer la partie correspondant au statut. Le format d’expression régulière est PCRE.