Api : envoi d’une diffusion de sms via sftp
Dans cet article nous allons créer une diffusion SMS, via SFTP.
Afin de renforcer la sécurité de nos transferts de fichiers, nous vous encourageons vivement à privilégier l’utilisation du protocole SFTP (port 2222) au lieu du protocole FTP (port 21).
Vous devez avoir souscrit les options FTP et Web Services dans DMC (Bon de Commande) pour effectuer ce type d’envoi.
Pour élaborer une diffusion de SMS via le dépôt FTP, vous devez :
Constituer un fichier à plat au format csv, celui-ci devra être encodé en ISO-8859-15.
Ce fichier est composé d’une partie « commande » et d’une partie « données ».
- La partie commande est un ensemble de lignes au format « <nom>:<valeur> » avec les informations liés au service DMC.
- La partie « données » est un ensemble de contacts au format csv avec un point-virgule comme séparateur.
Le déclenchement de la diffusion de SMS est réalisé grâce à la dépose du fichier CSV dans le dossier « in » du compte SFTP.
NOTE :
- Un batch scrute l’existence d’un fichier dans le répertoire IN toutes les 60 secondes et traite la demande.
- Un SMS fait au maximum 160 caractères avec l’encodage ISO-8859-15
- Un SMS fait au maximum 70 caractères avec l’encodage UNICODE
- Dans tous les cas un SMS ne peut pas être constitué de plus de 4 SMS (cas des SMS LONG)
- Si vous utilisez des champs dynamiques, ceux-ci doivent être obligatoirement renseignés dans la partie données du contact.
Ci-dessous un exemple (format JSON)
#COMMAND
encoding: ISO8859-1
serviceId:1234567890
spaceId:00000
broadcastName:Non de la diffusion
scenarioId:000000
callPlanningId:0000
priority:1
customizableId:00000
multimediaType:TXT
text: Bonjour |contact.prenom| |contact.nom|, exemple test SOFT de message par SFTP. stop au |shortcode|.
messageFrom:OADC
smsLong:1
#CONTACTS
NAME;FORENAME;PHONENUMBER1
DUPOND;MARTIN;0600000000
#END
Information sur les paramètres du fichier CSV :
– Pour connaître le scenarioId via l’interface DMC :
Sélectionner l’onglet ADMINISTRATION et sélectionner scenarii de diffusion.
Positionner la souris sur un scénario sous la colonne Nom, le scenarioId apparaît en info bulle Scénario N° 12345
– Pour connaître le customizableId via les APIs DMC cliquez ici.
Vous pouvez télécharger le fichier d’exemple ci dessus en cliquant ici.
