Connexion SMS et Voice

Transcription

1 Version 8.30 docref : 0/fr Prologue - Pour nous contacter au sujet de ce document : support@prologue.fr Tel : Fax :

2 Table des matières 1 - Généralités... p Copyright... p A propos... p Convention de typographie... p Présentation... p Configuration du connecteur SMS/VOICE au niveau de Use It Messaging Server (DMServer)... p Configuration de Use It Messaging Application Connector (DMac).. p Configuration du DM Data Transfer (DMdt)... p Création de la configuration SMS... p Création de la configuration Voice...p Suivi de l'envoi SMS/Voice... p Rapatriement des accusés... p Configuration d'un proxy socks... p Utilisation à partir d'un client messagerie...p Configuration... p Envoi d'un message SMS via le connecteur SMTP SMS... p Envoi d'un message Voice via le connecteur SMTP Voice...p Accusés de transmissions...p Demande de rapport de transmission dans le sujet...p Envoi d'un message trop long...p.50 2/50

3 1 - Généralités Copyright Tous droits réservés. Aucune partie de cette documentation ne peut être reproduite, stockée sur un système d'archivage ou transmise à quelque fin ou par quelque moyen que ce soit, sans la permission écrite préalable de l'éditeur, sauf s'il s'agit de courtes citations reprises dans des articles ou des critiques. Toutes les marques citées dans ce manuel sont les propriétés de leurs auteurs respectifs. Au cours de la préparation de cette documentation, les auteurs et l'éditeur ont particulièrement veillé à l'exactitude de son contenu. Toutefois ces informations sont fournies sans garantie, expresse ou implicite. Les auteurs, les revendeurs et les distributeurs ne peuvent pas être tenus pour responsables des dommages éventuellement causés ou censés avoir été causé, de manière directe ou indirecte par cette documentation. Les informations contenues dans ce document pourront faire l'objet de modifications sans préavis. Sauf mention contraire, les sociétés, les noms et données utilisés dans les exemples sont fictifs A propos Avant de commencer le mise en place du produit, assurez vous de bien lire les instructions de configuration, les conseils ainsi que toute autre information essentielle contenue dans ce guide Convention de typographie Ce guide s'appuie sur les conventions suivantes : Caractères gras Libellés des champs et des boîtes de dialogue. Nom des touches. Commandes et boutons à utiliser Caractères italiques Titres des autres parties, chapitres et sections du manuel. Titres des autres manuel. Noms de logiciels Prologue et d'autres éditeurs. Caractères espacement fixe Puce Remarque : à Exemples de syntaxe de codes, de clés et d'instructions. Procédure courte ou sous-procédure étape par étape. Les remarques contiennent des informations importantes mises en exergue par rapport au texte. Attention : indique les Les messages de ce type indiquent les précautions que vous précautions à prendre devez observer pour éviter une erreur ou un problème risquant de porter à conséquence. 3/50

4 2 - Présentation La connexion SMS/Voice permet à Use It Messaging Server d'envoyer des SMS ou des messages vocaux via Use It Messaging Application Connector (DMac) et le DMdt. Les messages SMS et Voice sont envoyés via l'opérateur PGS (Première Global Service). Cette connexion se configure dans l'administration de Use It Messaging Server, de Use It Messaging Application Connector et du DMdt. Pour les messages vocaux, il faut aussi configurer un modèle sur le site PGS. Terminologies Logiciel : Le terme "logiciel" représente l'ensemble des programmes et de la documentation s'y rapportant. Il concerne le fonctionnement d'un ensemble de traitement de données et appartient à un même sous-système. Sigles utilisés FTP : File Transfer Protocol 4/50

5 3 - Configuration du connecteur SMS/VOICE au niveau de Use It Messaging Server (DMServer) Ce connecteur de sorties permet l'envoi de messages SMS (Short Message Service) et de messages vocaux vers un téléphone mobile : 5/50

6 Activer : Mise en activité effective de ce connecteur. Description : Nom descriptif du connecteur SMS/VOICE. Chemin du répertoire : Répertoire de dépose des fichiers de soumission au serveur SMS/VOICE. Pièces jointes : Acceptation ou refus de traiter les messages avec pièces jointes. Ignorer les pièces jointes : Les messages avec pièces jointes seront traités. Seul le message sera émis. Rejet : Les messages avec pièces jointes seront refusés. Un message d'avertissement d'échec de la transmission sera envoyé. Taille des messages : La taille maximale d'un message SMS est de 160 caractères. 6/50

7 Tronquer les messages de plus de 160 caractères : Les messages dont la taille est supérieure à 160 caractères seront traités. Les 160 premiers caractères du message composeront le message SMS. Rejet : Les messages dont la taille est supérieure à 160 caractères seront refusés. Un message d'avertissement d'échec de la transmission sera envoyé. Remarque : Les messages vocaux ne sont jamais tronqués ni rejetés. Onglet rapport de transmission L'onglet Rapport de transmission vous permet de Configurer la génération des accusés de transmission pour les messages SMS et vocaux. 7/50

8 Paramètres SMS : Configuration pour les messages de type SMS. Activation : Critère de génération d'un accusé de transmission. Aucun : Les accusés de transmission sont désactivés. En cas d'échec : Un accusé de transmission est généré si l'envoi du message échoue. Toujours : Un accusé de transmission est systématiquement généré. Type : Sélectionne le type d'accusé de transmission. Accusé par destinataire : Un accusé de transmission est généré pour chaque destinataire du message. Accusé consolidé : Un seul accusé de transmission est généré contenant le résultat des envois pour tous les destinataires. Mode : Sélection de l'événement déclenchant la génération de l'accusé de transmission. A l'envoi du message : L'accusé de transmission indique le résultat de l'opération de dépose du message chez l'opérateur de téléphonie. A la lecture du message : L'accusé de transmission indique le résultat de la tentative d'envoi du message sur le téléphone du destinataire. Paramètres VOICE : Configuration pour les messages vocaux. Activation : Critère de génération d'un accusé de transmission. Aucun : Les accusés de transmission sont désactivés. En cas d'échec : Un accusé de transmission est généré si l'envoi du message échoue. Toujours: Un accusé de transmission est systématiquement généré. Type : Sélectionne le type d'accusé de transmission. Accusé par destinataire : Un accusé de transmission est généré pour chaque destinataire du message. Accusé consolidé : Un seul accusé de transmission est généré contenant le résultat des envois pour tous les destinataires. Mode : Sélection de l'événement déclenchant la génération de l'accusé de transmission. A l'envoi du message : L'accusé de transmission indique le résultat de l'opération de dépose du message chez l'opérateur de téléphonie. A la lecture du message : L'accusé de transmission indique le résultat de la tentative d'envoi du message sur le téléphone du destinataire. Adressage Le numéro de téléphone du mobile et/ou le nom du ou des destinataires sont à indiquer dans le champ Adresse du message comme suit : <Name>.<Number>@<SMSDomain> ou, <Number>@<SMSDomain> 8/50

9 Exemple : john_smith @sms.prologue.fr ou, @SMS.prologue.fr L'administrateur peut alors mettre en oeuvre une solution de routage des mails adressés au domaine "sms" vers la boîte aux lettres POP3 scrutée par Use It Messaging Server par exemple. Mais il est préférable d'utiliser le transfert en SMTP vers Use it Messaging Serveur (via IIS SMTP) et la scrutation dans un répertoire. Ce mécanisme, utilisant un connecteur SMTP du DM Server, est préconisé pour tous les environnements messagerie, y compris Exchange et Notes. Pour les messages vocaux, remplacer SMS par VOICE. 9/50

10 4 - Configuration de Use It Messaging Application Connector (DMac) La sortie SMS - Message Vocal doit être activée au niveau de Use It Messaging Application Connector (DMAC). La boîte de dialogue des Propriétés SMS - Message Vocal permet de configurer les options pour l'émission des SMS (Short Message Service) ou des Messages Vocaux traités par Use It Messaging Application Connector (DMAC) via Internet. L'émission de SMS - Message Vocal par Use It Messaging Application Connector (DMAC) demande un abonnement spécifique. Vous accédez à la fenêtre Propriétés de SMS - Message Vocal en cliquant sur le noeud Sorties, la liste des sorties vous est proposée (cadre de droite). Cliquez droit sur l'item SMS - Message Vocal, la fenêtre suivante apparaît : 10/50

11 Activer : Active la fonction SMS - Message Vocal Objet par défaut : Objet du message par défaut à chaque émission, Corps du message : Définissez le comportement, si vous dépassez la longueur maximale définie. Le message est tronqué, rejeté, ou émis tel quel vers le fournisseur SMS Message Vocal. La longueur habituelle d'un message SMS - Message Vocal est de 160 caractères. Ajouter une signature : La signature est ajoutée à la fin du message pour chaque émission. Pour une utilisation via Use It Messaging Server (DMServer), activez seulement la fonction SMS - Message Vocal. La licence correspondante à cette sortie doit être valide. Le paramétrage des accusés s'effectue au niveau du noeud principal du serveur de messagerie. Pour ce faire, vous devez cliquer droit sur le noeud principal -> Propriétés puis sélectionner l'onglet Messagerie. L'écran suivant s'affiche : 11/50

12 Il est nécessaire d'activer la sortie mail. Cliquez droit sur l'item Courrier -> Propriétés, La fenêtre Propriétés de Courrier s'affiche : 12/50

13 La licence correspondante à cette sortie doit être valide. 13/50

14 5 - Configuration du DM Data Transfer (DMdt) Création de la configuration SMS A partir de la console d'administration de DM Server, Déployez le noeud DM Data Transfer Cliquez droit sur le noeud SMS/message vocal. L'assistant de création présente la boîte de dialogue Général : 14/50

15 Cochez les cases Active et Configuration par défaut. Pour l'instant, seule la configuration par défaut est utilisée pour la sortie SMS. Saisir un nom et une adresse dans les zones Nom Descriptif et Adresse du serveur. Saisir un compte utilisateur et un mot de passe dans les zones Compte utilisateur et Mot de passe du compte PGS. Ces informations proviennent du document d'ouverture de compte fourni par PGS. Cliquez sur le bouton Suivant, la fenêtre Proxy apparaît : 15/50

16 Cochez la case Utilisation d'un proxy ftp ou proxy socks si l'utilisation d'un proxy pour le FTP ou SOCKS est envisagée. Cliquer sur le bouton Terminer. Toutes les nouvelles configurations apparaissent dans le cadre de droite. La configuration est prise en charge par le service DM Data Transfer( DMdt) 16/50

17 automatiquement dans le cas d'une création. Dans le cas d'une modification, une fenêtre vous demande d'appliquer ou non la modification; vous pouvez aussi appliquer la modification après avoir cliqué dans la toolbar sur le bouton suivant ou, cliquez droit sur le module DMdt installé puis sélectionnez Toutes tâches. Ces informations apparaissent que si le serveur DM Data transfer est sélectionné (Exemple PRO2207). 17/50

18 5.2 - Création de la configuration Voice Les messages vocaux sont gérés pour l'instant comme une option d'envoi de SMS au niveau du module DMdt. Dans un premier temps, il faut créer une configuration SMS en cochant l'option Envoi en tant que message vocal : Pour l'instant, seule la configuration par défaut est utilisée pour la sortie «message vocal». Création de la template xpedite Créez une «template xpedite». Connectez vous au site Sélectionnez voicereach à partir du cadre Accès clients, 18/50

19 Authentifiez-vous avec le compte/password xpedite : 19/50

20 Choisissez SCRIPT MANAGER dans le menu du haut Choisissez «TTS TEMPLATES»dans le menu de gauche, option «BUILD TEMPLATE». 20/50

21 La page peut comporter des champs d'insertion qui permettent d'ajouter du texte provenant de Use It Messaging Server (DM Server). La template est au format xml. 21/50

22 Utilisez "insert[1]" pour insérer du texte (Exemple ci-dessous) : 22/50

23 Exemple sans insertion : <speak version="1.0" xml:lang="fr-fr"> <voice gender="female" category="adult"></voice> Bonjour, la commande 2045 vient de partir </speak> Exemple avec insertion : <speak version="1.0" xml:lang="fr-fr"> <voice gender="neutral" category="adult"></voice> Bonjour, <insert keyword="insert[1]" segment="inserts"/> </speak>: La template doit être sauvegardée sous le nom template_xpedite. Lorsque la template est sauvegardée, déloguez vous du site. La configuration pour des envois de messages vocaux est terminée. Quelques restrictions sont à noter par rapport aux messages SMS : Évitez les caractères accentués La ponctuation n'est pas gérée Les retours à la ligne et les lignes vides correspondent à des fins de messages pour PGS. Enfin pour que le message soit délivré instantanément, il faut que l'interlocuteur se manifeste oralement. Dans le cas contraire, le message est délivré après un timeout de plusieurs secondes. 23/50

24 Suivi de l'envoi SMS/Voice A partir de l'administration du module DMdt, l'item Journal d'activité permet de consulter l'activité du module : Dans la partie résultat de l'administration, les upload/download web, ainsi que les envois SMS et messages vocaux sont «logués» : Par défaut, les messages sont logués dans l'ordre inverse de l'ordre chronologique. En ce qui concerne les messages vocaux, trois états sont remontés: «Sent» : Le message a bien été reçu et écouté, «Canceled» : Le numéro est invalide, «Error» : L'envoi du message a généré une erreur générique, Le suivi peut-être effectué au niveau du site PGS, après vous êtes Authentifié (Cf. chapitre «mode opératoire SMS option VoiceReach»). Choisissez le menu «JobManager» : 24/50

25 Cette vue permet de visualiser les envois en cours et terminés Rapatriement des accusés Les accusés de réception sont rapatriés en local dès le premier envoi SMS ou «Message Vocal». Ils sont stockés dans le sous répertoires "data" du répertoire "dmdt"de l'arborescence principale. Le répertoire à le nom du compte : 25/50

26 Dans un premier temps, les fichiers d'acquittement (préfixés «mbx») sont rapatriés, puis dès la première demande de notification, ils sont analysés et copiés dans le fichier «ack.log» Configuration d'un proxy socks Ce mode opératoire a été validé pour les proxy SOCKS 4. sur plate forme Windows 2003 ou XP avec Internet explorer version 7 d'installé. L'utilisation d'un proxy SOCKS implique de paramétrer le DMdt en conséquence; un onglet supplémentaire a été ajouté pour gérer cette configuration : Activer l'option proxy SOCKS et renseigner l'adresse et le port du proxy; cliquer sur Terminer. Le proxy SOCKS peut déjà être activé et renseigné au niveau d'internet Explorer (Outils -> Options Internet -> Connexions -> Paramètres réseau) : 26/50

27 En cliquant sur le bouton Avancé, les paramètres du proxy s'affichent : 27/50

28 Dans ce cas la configuration sera affichée dans le DMdt : 28/50

29 Le compte PGS dans le cas de l'utilisation d'un proxy SOCKS est un compte particulier utilisant une passerelle intermédiaire. La gestion des accusés dans ce cas est à valider avec PGS. Dans le cas où le proxy n'est pas démarré, l'erreur suivante est «loguée» : 29/50

30 30/50

31 6 - Utilisation à partir d'un client messagerie Ce chapitre décrit une suite d'exemples d'utilisation à partir d'un client messagerie (outlook) Configuration Création du connecteur SMS/Voice Créer un connecteur SMS/Voice, pour gérer les sorties SMS et VOICE. Ce connecteur génèrera ses fichiers.rtg dans le répertoire de dépose du DMAC : Le chemin du répertoire indique un répertoire en UNC pour la dépose des fichiers.rtg. 31/50

32 Création des connecteurs SMTP Deux connecteurs SMTP sont utilisés en entrée. Les domaines fax utilisés seront «sms.prologue.net» et «voice.prologue.net». Dans notre exemple, ils pointent sur le même serveur SMTP; on ne peut donc pas les utiliser simultanément; ces connecteurs sont soit utilisés en mode POP3 ou en mode Répertoire. Le premier connecteur SMTP, dédié aux messages SMS : A partir de la console d'administration du DM Server, vous devez afficher les propriétés du connecteur SMTP SMS afin de dédier ce connecteur aux messages SMS. Cliquez droit sur l'item SMTP/SMS, sélectionnez Propriétés, la fenêtre suivante apparaît : 32/50

33 Sélectionnez l'onglet Paramètres avancés, 33/50

34 Augmentez la scrutation des fichiers soumis pour accélérer les tests. Fixez la valeur 3 secondes dans la zone Périodicité d'interrogation des nouveaux messages. Affichez la liste déroulante Connecteur dédié à puis sélectionnez SMS. Le deuxième connecteur SMTP, dédié à Voice : Une fois le connecteur SMTP/VOICE créé à partir de la console d'administration, l'écran suivant apparait : 34/50

35 Sélectionnez l'onglet Paramètres avancés, 35/50

36 Augmentez la scrutation des fichiers soumis pour accélérer les tests. Fixez la valeur 3 secondes dans la zone Périodicité d'interrogation des nouveaux messages. Faîtes défilé la liste déroulante Connecteur dédié à puis sélectionnez VOICE. Création des connecteurs en mode serveur Répertoire Les deux connecteurs SMTP peuvent aussi, être en mode répertoire. Dans ce cas, la création des messages s'effectue par dépose dans leur répertoire de scrutation de fichiers.eml correctement formatés. Le paramétrage des connecteurs s'effectue à partir de la console d'administration du DM Server (cf. Guide Use It Messaging Server - chapitre création des connecteurs). 36/50

37 Si vous configurez les connecteurs SMTP en mode répertoire, vous devez compléter les zones prévues à cet effet de la manière suivante : Chemin : doit indiquer un répertoire contenant les fichiers.eml correspondant aux messages SMS ou Voice. Serveur : localhost (si le serveur est local, sinon son adresse IP ou DNS) Vous avez la possibilité de créer un seul connecteur SMTP non dédié, à partir de la console d'administration du DM Server avec les caractéristiques suivantes (les options de création non spécifiées prennent leur valeur par défaut) : Description : SMTP standard Mode : Répertoire Chemin d'accès : Indiquez un répertoire contenant les fichiers.eml correspondant à des messages SMS ou VOICE. Serveur : localhost (si le serveur est local, sinon son adresse IP ou DNS) Domaine de Fax : sms.voice Lorsque tous les paramètres sont saisis, il vous suffit de valider l'ensemble du paramétrage. A partir de la console d'administration, afficher les propriétés en cliquant droit sur le connecteur SMTP standard. Sélectionnez l'onglet Paramètres avancés, Augmentez la scrutation des fichiers soumis pour accélérer les tests. Fixez la valeur 3 secondes dans la zone Périodicité d'interrogation des nouveaux messages. Rajoutez directement //SMS ou //VOICE dans le sujet. Création de la règle de routage SMS/Voice Si la règle de routage a été créée ultérieurement, celle-ci doit apparaitre après avoir cliqué sur l'item Règles de routage-emission. Double-cliquez sur la règle souhaitée (Envoi SMS), la boîte des Propriétés de Envoi SMS apparaît : 37/50

38 Sélectionnez l'onglet Règle-conditions, la fenêtre suivante apparaît : 38/50

39 Si la règle de routage n'a pas été créée ultérieurement, référez vous à la documentation Use It Messaging Server - Règle de routage - Emission. Cliquez sur l'onglet Règle de routage - émission 39/50

40 L'envoi peut se faire avec les clients Mozilla Thunderbird, Outlook... avec les syntaxes suivantes : 40/50

41 Enfin, au niveau de l'item DM Data Transfer, configurez un compte pour le SMS : 41/50

42 Au niveau de l'item DM Data Transfer, utilisez un compte pour le Voice : 42/50

43 6.2 - Envoi d'un message SMS via le connecteur SMTP SMS Activez le connecteur SMTP dédié à SMS (le connecteur SMTP dédié à Voice est désactivé). Dans le cas où les connecteurs ne pointent pas sur le même serveur SMTP, on peut laisser les 2 connecteurs activés. Envoyez un message à partir de votre client messagerie (Exemple ci-dessous) 43/50

44 Les messages suivants doivent apparaître dans le Journal d'activité de l'item des Connecteurs. 44/50

45 Les messages suivants doivent apparaître dans le journal d'activité de l'item DM Data Transfer (DMdt). De plus, on peut vérifier sur le site PGS que la demande d'envoi a bien été prise en compte Envoi d'un message Voice via le connecteur SMTP Voice Activez le connecteur SMTP dédié à Voice (le connecteur SMTP dédié à SMS est désactivé). Dans le cas où les connecteurs ne pointent pas sur le même serveur SMTP, on peut laisser les 2 connecteurs activés. 45/50

46 Envoyez un message à partir de votre client messagerie Les messages suivants doivent apparaître dans le journal d'activité de l'item Connecteurs. 46/50

47 Les messages suivants doivent apparaître au niveau du journal d'activité de l'item DM Data Transfer (DMdt). On peut vérifier sur le site PGS que la demande d'envoi a bien été prise en compte (cf. exemple précédent) Accusés de transmissions Les accusés de transmission se configurent à partir du noeud DM Server -> Connecteurs Cliquez droit sur l'item SMS/VOICE, sélectionner Propriétés Cliquez sur l'onglet Rapport de transmission, l'écran suivant apparaît : 47/50

48 Redémarrez le contrôleur après avoir modifié la configuration, Au niveau des accusés vous pouvez configurer deux modes : Soit, au niveau de la dépose pour PGS (A l'envoi du message), Soit, au niveau de la réception effective du message (A la lecture du message). Dans ce dernier cas, l'utilisateur doit recevoir un rapport de transmission contenant des informations sur la réception. Ce rapport est paramétré au niveau du DMac -> Sorties, cliquez droit sur Sms messages vocal. Sélectionnez l'onglet Accusés : 48/50

49 Saisissez les informations nécessaires; la réception de celui-ci s'effectue dans un délai maximum de 10 minutes dans la zone Timeout. Attention : Il ne faut pas oublier de paramétrer le serveur de messagerie et la sortie mail au niveau du noeud principal du DMac (Cf. Configuration de Use It Messaging Application Connector «DMac»). Dans ce cas, un rapport de transmission sera envoyé à l'utilisateur (Exemple suivant) : 49/50

50 6.5 - Demande de rapport de transmission dans le sujet Un rapport de transmission explicite peut-être demandé dans le sujet du message sous la forme //NOTIF= . Dans ce cas, le mail est envoyé à l'adresse « » spécifié Envoi d'un message trop long Si vous envoyé un message SMS dont la longueur dépasse 160 caractères et que le connecteur est paramétré pour qu'il refuse les messages trop longs, alors, celui-ci ne sera pas être émis. Dans ce cas, le journal d'activité doit contenir les informations suivantes : Aucun destinataire n'a reçu ce message Format de message SMS invalide. Vérifier sa longueur. Note : Si vous vous envoyez un message Voice de plus de 160 caractères. Le message est accepté et envoyé intégralement au niveau de Use It Messaging Server (DMServer). 50/50