| Sommaire | ||||
|---|---|---|---|---|
|
Paramétrage du type d'interface CTI Divalto
...
Soit par le menu 'Paramètres CTI' d'Harmony
...
Soit par le menu 'C.R.M. / Utilitaires / CTI / Choix de l'interface
...
| Astuce |
|---|
Le paramétrage se fait
|
| Info |
|---|
PréfixeLe bouton 'Configuration d'un préfixe pour sortir' est une fonction commune aux différentes interfaces pour ajouter un préfixe lors de la composition d'une numérotation téléphonique |
...
Le composant CTI Divalto permet plus facilement le dialogue avec les interfaces de 3 fournisseurs de services CTI
Alcatel
PhonePC
ISI-COM
Ces fournisseurs proposent des objets COM qui s’installent sur les postes clients, et qui fournissent une api pour dialoguer avec le PABX.
...
Certains fournisseurs de CTI proposent un logiciel spécifique qui s’interface lui-même avec les PABX ou la téléphonie. Ces Ces fournisseurs n’ont pas de SPI mais l'installation sur le poste client met en place un protocole CALLTO qui lance un lance un programme .exe en lui passant des paramètres.
Dans ce cas il faut utiliser le protocole CALLTO ou TEL, et paramétrer le format de la commande à générer pour faire une numérotation téléphonique
...
Certains fournisseurs de CTI proposent des services web CTI en mode API REST.
| Info |
|---|
Ce mode est plus complexe a paramétrer car il passe par l'envoi de commande web de type POST vers la plateforme CTI, mais il offre l'avantage de fonctionner sans aucune installation sur le poste client |
Dans ce cas il faut utiliser le protocole CLIC TO CALL, et paramétrer l'appel de services web.
...
L'interface COM Alsatel nécessite l'installation préalable installation préalable du composant AlsacallX sur votre ordinateur.
Cliquez sur le bouton "Configuration pour Alsatel" et paramétrez le numéro de ligne téléphonique 
...
PhonePC
L'interface COM PhonePC nécessite l'installation préalable installation préalable du composant PhonePC sur votre ordinateur.
L'installation de PhonePC installe également l'ocx utilisée par Harmony. Il n’y a d'ailleurs aucun paramétrage à faire dans Harmony (tout le paramétrage s'effectue dans PhonePC).
ISI-COM
L'interface COM ISI-COM nécessite l'installation préalable installation préalable du composant ISI-COM sur votre ordinateur
Après l'installation du produit de ISI-COM, installez le composant qu'utilise Harmony :
Copiez les fichiers qui se trouvent dans le répertoire ISI-COM Harmony dans c:\Divalto\Sys.
Lancez InstallPcb.bat et InstallPcb.dhop
En principe, il n’y a pas de paramétrage à faire dans le menu Harmony (tout le paramétrage s'effectue dans ISI-COM).
Toutefois une remarque remarque concernant la fonction de montée de fiche : ISI-COM sait faire du transfert de fiche. Lorsqu’on transfère un appel à un autre correspondant, un bouton dans la fiche tiers permet de demander que le poste distant reçoive l’identifiant de la fiche du tiers en cours au lieu du numéro de téléphone de l’appelant. Ce mode fonctionne généralement sans paramétrage.
S'il ne fonctionne pas avec votre Pabx, cochez la case ci-après (bouton "Configuration pour la montée de fiche") :
...
Paramétrage TAPI
...
Après l'installation, vérifiez que ce driver est visible par la couche logicielle Tapi de Windows. Pour cela, lancez le choix « Téléphone et modem» du Panneau de configuration, et vérifiez que votre driver TSP figure bien dans la liste des fournisseurs de téléphonie :
...
Attention :
Il faut installer un driver de téléphonie 32 bits. En général, les fournisseurs proposent un driver 32 bits pour les machines 32 bits et deux drivers (un en 32bits et un en 64bits) pour les machines 64 bits.
Attention aussi à la version de Windows du poste client, en particulier pour les systèmes Windows Vista et Windows 7. Le cas échéant, renseignez-vous auprès de votre fournisseur de téléphonie.
Sur les machines 64 bits, le choix « Téléphone et modem » du Panneau de configuration appelle Tapi 64 bits.
Or ce n’est pas la couche logicielle que Divalto utilise.
Pour appeler la couche 32 bits de Tapi, il faut lancer c:\Windows\SysWOPW64\telephon.cpl ou passer par un raccourci comme celui montré par l’image suivante :
...
Attention :
...
il faut quelques fois activer le serveur de téléphonie et la téléphonie, exemple après l’installation d’un driveur SPI pour TAPI2 , celui ci affiche ce message
ceci indique qu’il faut démarrer les services de téléphonie et les mettre en mode démarrage automatique
ce qui permet d’activer TAPI
Paramétrage Global et paramétrage Local
Le connecteur gère deux niveaux de paramétrage : un niveau général, qu'on utilisera lorsque les mêmes paramètres sont partagés par plusieurs postes de travail et un niveau local, prioritaire sur le niveau général, qu'on utilisera pour configurer un poste en particulier :
Paramétrage global. Les paramètres globaux sont recherchés dans le fichier x:\Divalto\Sys\tapi_param.txt. La première ligne du fichier spécifie le modèle du nom de la ligne téléphonique (par défaut, le connecteur prendra la dernière ligne de type téléphonie - voir paragraphe "Nom de la ligne téléphonique" ci-dessous). La deuxième ligne spécifie les paramètres à fournir à la dll Tapi (au format hmp) (pas de paramètres par défaut). La troisième ligne spécifie le nom de la dll Tapi à utiliser (par défaut, le module YCTI charge DhDivaltoTapi.dll).
Paramétrage local. Les paramètres locaux doivent être indiqués dans la boîte de dialogue "Configuration du numéro de ligne pour TAPI". Pour l'afficher, cliquez sur le bouton "Configuration pour TAPI". Les informations saisies ici sont locales à l'utilisateur (elles sont enregistrées dans le chapitre HKEY_CURRENT_USER de la base de registre) et sont prioritaires sur les informations contenues par le fichier tapi_param.txt.
Cas particulier des paramètres à destination de la dll Tapi : les paramètres globaux contenus par le fichier tapi_param.txt sont envoyés en premier, les paramètres locaux sont envoyés ensuite. On peut donc spécifier à la fois des paramètres globaux valables pour tous les utilisateurs et leur ajouter des paramètres spécifiques à un utilisateur particulier.
Nom de la ligne téléphonique
Pour préciser la ligne de téléphonie à utiliser sur le poste, sélectionnez la ligne voulue dans la liste puis cliquez sur le bouton "Prendre la ligne sélectionnée"
...
Vous pouvez aussi saisir un simple mot dans le champ « Nom de la ligne téléphonique ou du modèle » : un "Like *mot*" est alors effectué pour rechercher la ligne. Par exemple, en saisissant le mot "cisco", la recherche se fera sur "*cisco*" et renverra la ligne Cisco Line:[Paul] (1003) :
...
Remarque : Spécifier le nom de ligne n'est pas obligatoire car par défaut le connecteur prendra la dernière ligne de type téléphonie (chaque driver indique s'il est de type téléphonie ou de type modem).
...
Pour l'interface CALLTO ou TEL il s'agit principalement d'indiquer le format de la commande
...
Cas les plus courants de commande (en général sous la forme protocole : paramètres) :
callto : paramètre
tel : paramètre
skype : paramètre
sip : paramètre @ nom du serveur SIP
Pour cela il faut vous reporter à documentation du produit, car certains rares protocoles peuvent nécessiter d'autres paramètres.
...
Exemple : si l'ERP souhaite appeler le 0388202020 avec le paramétrage suivant
...
C'est la commande suivante qui sera envoyée : callto : 0388202020 org=1024
...
Pour l'interface CLIC TO CALL il y a deux paramétrages:
celui concernant le poste client pour identifier l'appelant
celui concernant le protocole d'échange et la construction de l'URL du service web CTI
Pour le paramétrage du protocole service web, il existe un fichier de paramétrage
...
Exemple de fichier avec explication des balises
clicktocall_param.txt
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
;==========================================================
;LISTE DES PARAMETRE GLOBAUX a partir de la balise <global>
<global>
;timeout1 : par défaut 1 seconde, permet de ralentie ycti en cas de saturant serveur
<timeout1>
;timeout2 : par défaut 1 seconde, time out lecture de la boucle des messages
<timeout2>
;timeout3 : par défaut 1 seconde, time out lecture de la boucle des messages
<timeout3>
;event_ring : nom de l'événement quand on lit le résultat json ou xml pour savoir s'il y a un appel entrant
<event_ring>RING
;event_popup : nom de l'événement quand on lit le résultat json ou xml pour savoir s'il y a une demande de montée de fiche
<event_popup>POPUP
;even_connect : nom de l'événement quand on lit le résultat json ou xml pour savoir s'il y a une demande de connexion
<even_connect>CONNECT
;noshowwindow : mettre 1 pour indiquer de ne pas afficher la fenêtre du cti Divalto, par exemple lorsqu'il y a déjà un afficheur comme PymPhonie
<noshowwindow>0
;debug : mettre 1 pour activer le mode debug de la gestion du cti. Le fichier de trace dns divaltolog sera DhDivaltoClickToCall.log
<debug>0
;==========================================================
;PARAMETRES POUR GENERER UN APPEL TELEPHONIQUE a partir de la balise <cliktocalldial>
<cliktocalldial>
;url : URL du serveur de téléphonie + commande pour appel téléphonique. Exemple : http://serveurcti:8080/commandeAppel
<url>http://localhost:8082/DhDivaltoServerCTI/api/cti/setevent?ident=$ident$&telorg=$telorg$&tel=$teldest$&cmdevent=$event$
;méthode : type de méthode pour appel téléphonique GET PUT ou POST, par défaut POST
<methode>POST
;data : texte de données a envoyer dans la webrequest pour un PUT ou POST. Ce texte est envoyé tel quel sans encodage
<data>
;dataencode : texte de données a envoyer dans la webrequest pour un PUT ou POST. Ce texte est encodé par urlencode
<dataencode>
;Exemple : <data>XML= <dataencode>xxxxxx => enverra XML=urlencod('xxxxxx')
;headers : liste des headers a générer a séparer par le caractère | (alt+124)
<headers>
;Exemple : Authentification=$auth$|Login=xxx
;contenttype : type de contenu de la webrequest. Par défaut : application/x-www-form-urlencoded
<contenttype>
;Exemples : application/json ou text/plain ou text/xml
;PARAMETRES POUR LIRE DES EVENEMENTS a partir de la balise <cliktocallevent>
<cliktocallevent>
;with_event : 1 indique que l'on active la lecture des évènements pour détecter un appel entrant
<with_event>1
;url : URL du serveur de téléphonie + commande pour lecture évènement . Exemple : http://serveurcti:8080/commandeLecture
<url>http://localhost:8082/DhDivaltoServerCTI/api/cti/getevent?ident=$ident$&telorg=$telorg$
;méthode : type de méthode pour lecture évènement GET PUT ou POST, par défaut GET
<methode>GET
;data, headers et contenttype : même fonctionnement que pour l'appel téléphonique
<data>
<headers>
<contenttype>
;type_return : format de la réponse evènement renvoyée par le cti web. Valeurs possibles : json ou xml ou text
<type_return>json
;CAS DE REPONSE JSON
;json_tel : si la réponse est de type json, indiquer le nom du champ json qui contient le numéro de téléphone de l'appel entrant
<json_tel>
;json_event : si la réponse est de type json, indiquer le nom du champ json qui contient le type d'évènement
<json_event>
;CAS DE REPONSE XML
;xml_tel : si la réponse est de type xml, indiquer le nom de la balise xml qui contient le numéro de téléphone de l'appel entrant
<xml_tel>
;xml_event: si la réponse est de type xml, indiquer le nom de la balise xml qui contient le type d'évènement
<xml_event>
;si la réponse est sous la forme <tel>0123456789</tel> les balises xml_result_tel_in_attrib et xml_tel_attrib doivent rester vides
;si la réponse est sous la forme<tel value=123456789/> les balises xml_result_tel_in_attrib et xml_tel_attrib doivent être utilisées
;xml_result_tel_in_attrib : si la réponse est de type xml et que la valeur est un attribut, mettre 1
<xml_result_tel_in_attrib>
;xml_tel_attrib: si la réponse est de type xml et que la valeur est un attribut, mettre le nom de l'attribut
<xml_tel_attrib>
;si la réponse est sous la forme <evt>0123456789</evt> les balises xml_result_event_in_attrib et xml_event_attrib doivent rester vides
;si la réponse est sous la forme<evt name='call'/> les balises xml_result_event_in_attrib et xml_event_attrib doivent être utilisées
;xml_result_event_in_attrib: si la réponse est de type xml et que la valeur est un attribut, mettre 1
<xml_result_event_in_attrib>
;xml_event_attrib: si la réponse est de type xml et que la valeur est un attribut, mettre le nom de l'attribut
<xml_event_attrib>
;==========================================================
;PARAMETRES POUR UNE AUTHENTIFICATION AVEC TOKEN a partir de la balise <cliktocalltoken>
<cliktocalltoken>
;with_token : 1 indique que le cti web requiert une authentification avec token, et qu'il faut donc avant appel de service web, faire une demande de token
<with_token>1
;url : URL du serveur de téléphonie + commande pour demande de token . Exemple : http://serveurcti:8080/commandeToken
<url>http://localhost:8082/DhDivaltoServerCTI/api/cti/gettoken
;méthode : type de méthode pour lecture évènement GET PUT ou POST, par défaut GET
<methode>GET
;data, headers et contenttype : même fonctionnement que pour l'appel téléphonique
<data>
<headers>
<contenttype>
;type_return : format de la réponse token renvoyée par le cti web. Valeurs possibles : json ou xml ou text
<type_return>json
;CAS DE REPONSE JSON
;json_token: si la réponse est de type json, indiquer le nom du champ json qui contient le token d'authentification
<json_token>
;CAS DE REPONSE XML
;xml_token: si la réponse est de type xml, indiquer le nom de la balise xml qui contient le token d'authentification
<xml_token>
;si la réponse est sous la forme <token>abcd</token> les balises xml_result_token_in_attrib et xml_token_attrib doivent rester vides
;si la réponse est sous la forme<token value='abcd'/> les balises xml_result_token_in_attrib et xml_token_attrib doivent être utilisées
;xml_result_token_in_attrib: si la réponse est de type xml et que la valeur est un attribut, mettre 1
<xml_result_token_in_attrib>
;xml_token_attrib: si la réponse est de type xml et que la valeur est un attribut, mettre le nom de l'attribut
<xml_token_attrib>
<callto>
cmd=callto:$teldest$
cmdshellexecute=OPEN
|
...
Dans tous les paramètres de ce fichier (url, data, dataencode, headers,...) on peut utiliser des mots clés afin de récupérer des valeurs paramétrées pour le poste dans l'écran du CTI Divalto, ou la valeur du token
Mot clé | Remplacé par | Provenant de |
|---|---|---|
$user$ | Nom de l'utilisateur | Paramétrage CTI du poste |
$mdp$ | Mode de passer utilisateur | Paramétrage CTI du poste |
$telorg$ | Numéro du poste utilisateur | Paramétrage CTI du poste |
$teldest$ | Numéro a appeler | Provient de l'ERP |
$token$ | Token d'authentification | Réponse de l'appel service web d'authentification |
$ident$ | Identifiant | Paramétrage CTI du poste |
$auth$ | Encodage de l'authentification | Calculé a partir de $user et $mdp pour obtenir une version encodée en base 64. Par exemple pour un header sous la forme : Authentification :$auth |