Lancer des applications externes lors d'un appel téléphonique entrant v2

Cet article a été traduit automatiquement. Consulter la version de référence en anglais.

Rainbow vous permet de reprendre des informations sur les appels téléphoniques entrants. Vous pouvez utiliser ces informations en les transférant vers une autre application.
Avec cette "Computer Telephony Integration" vous pouvez bénéficier d'informations Rainbow combinées avec une autre base de données.

Une configuration spécifique est requise pour chaque application externe que vous souhaitez utiliser pour ce type d'intégration, reportez-vous à leur documentation pour connaître la syntaxe correcte pour la transmission des variables.
A la fin de cet article, vous trouverez quelques exemples d' intégration entre Rainbow et l'outil de test "MicroCRM".

Configurer le fichier custo-manifest.json

Avec cette nouvelle version, vous pouvez directement, depuis l'application desktop, exporter (1) un modèle du nouveau fichier custo-manifest.json incluant une aide à la syntaxe. Une fois le fichier modifié, vous pouvez importer (2) la configuration sur la même page de paramétrage.

Ce fichier contient une liste d'actions à effectuer sur un événement prédéfini.

Événements pour les appels entrants :

Il y a 4 événements disponibles :

• on-incoming-pbx-call-actions (application externe lancée lorsqu'un nouvel appel entrant est présenté)
• on-incoming-pbx-call-display-actions (utilisation CPaaS - afficher plus d'informations lorsqu'un nouvel appel entrant est présenté, soit à partir d'un fichier, en utilisant l'API REST ou en lançant un Bot Rainbow )
• on-answering-incoming-pbx-call-actions (application externe lancée lorsqu'un appel entrant est pris)
• on-releasing-incoming-pbx-call-actions (application externe lancée lorsqu'un appel entrant est libéré)
• on-incoming-pbx-call-button-actions (application externe lancée uniquement en cas de clic sur un bouton ajouté dans la fenêtre contextuelle de l'appel entrant).

Pour l'événement sélectionné, vous devrez configurer au moins la section "command" composée d'un "url" et d'un "params". Le champ "name" ne doit être rempli que pour l'événement on-incoming-pbx-call-button-actions, il s'agira du nom affiché sur le bouton dans la fenêtre contextuelle de l'appel entrant.

"url" - Emplacement de l'application externe

dans le champ URL, vous fournirez soit l'url, soit le chemin d'accès de l'application externe

"params" - Variable à transmettre à l'application externe.

Différentes variables sont disponibles :

Appelé ("Rainbow user currently connect to the desktop app ") :

• ${localUser.firstName}
• ${localUser.lastName} ${localUser.email}
• ${localUser.email}
• ${localUser.canonicalNumber} ${localUser.phone}
• ${localUser.phoneNumber}
• ${localUser.internalNumber}

Appelant

• ${caller.firstName}
• ${caller.lastName} ${caller.lastName}
• Numéro de téléphone de l'appelant ${caller.phoneNumber}

Numéro de téléphone de l'appelé (lorsque l'appel est redirigé ou lorsque Rainbow obtient le numéro du groupe)

• ${called.phoneNumber} (numéro de téléphone de l'appelant)

Contexte de l'appel (uniquement pour OXE)

• ${call.callId}
• ${call.globalCallId}

Options spécifiques pour les actions on-answering-incoming-pbx-call-actions

"RaiseChangeCall": false | true | only

Cette option permet de configurer le comportement lors de la réception d'un appel transféré :

• false = seuls les appels directs à l'utilisateur déclenchent l'événement.
• true = l'événement est déclenché pour les appels directs à l'utilisateur ainsi que pour les appels qui ont été transférés à cet utilisateur.
• only = seuls les appels transférés vers l'utilisateur déclenchent l'événement.

Fichier de modèle

{ "version" : "2", "extension-points" : {"on-incoming-pbx-call-actions" : [ { "name" : " ", "command" : { "url" : " ", "params" : " "
			} } ],
 " on-incoming-pbx-call-display-actions" : [
 {
 "name" : " ",
 "command" : {
 "commandType" : ",
 "url" : " ",
 "method" : " ",
 "params" : " ",
 "header" : [
 " "
 ],
 "Jid" : ""
                       },
 "responseType" : " ",
 "jsonField" : " "
 }
       ],
	"on-answering-incoming-pbx-call-actions" : [ { "name" : " ", "command" : { "url" : " ", "params" : " },
 " RaiseChangeCall" : false } ],"on-releasing-incoming-pbx-call-actions" : [ { "name" : " ", "command" : { "url" : " ", "params" : " "
			} } ],"on-incoming-pbx-call-button-actions" : [ { "name" : " ", "command" : { "url" : " ", "params" : " "
			}, "AnswerOnClick" : false } ]},
"help" : [" Ce fichier Json contient la personnalisation des événements pour l'application Rainbow Desktop ",
 " Sources d'événements : ",
 " - on-incoming-pbx-call-actions : lorsqu'un nouvel appel entrant est présenté. ",
 " - on-incoming-pbx-call-display-actions : lorsqu'un nouvel appel entrant est présenté. ",
 " - on-answering-incoming-pbx-call-actions : lorsqu'un appel entrant est pris. ",
 " - on-releasing-incoming-pbx-call-actions : lorsqu'un appel entrant est libéré. ",
 " - on-incoming-pbx-call-button-actions : lors d'un clic sur un bouton ajouté dans la fenêtre contextuelle des appels entrants",
 " ",
 " name : est utilisé uniquement pour le bouton d'action en tant qu'étiquette du bouton. ",
 " filter : set with value NoShortNumber will no invoke command if caller number is an internal. ",
 " AnswerOnClick : uniquement pour `on-incoming-pbx-call-button-actions` lorsqu'il est réglé sur `true`, le clic ",
 " sur le bouton répondra à l'appel et invoquera la commande ",
 " RaiseChangeCall : uniquement pour `on-answering-incoming-pbx-call-actions` lorsqu'il est réglé sur `true` ou `only` ",
 " lèvera l'événement lors d'un transfert/d'un changement d'appel. ",
 " responseType : uniquement pour `on-incoming-pbx-call-display-actions` avec commandType `file` ou `rest`",
 " et peut être `markdown` ou `json`. ",
 " jsonField : uniquement pour `on-incoming-pbx-call-display-actions` avec responseType `json` ",
 " ",
 " Clés de commande disponibles : ",
 " url : is the path of the executable or an URL ",
 " params : is string with variable ${xx} which will be replaced by value when command invoked ",
 " commandType : uniquement pour `on-incoming-pbx-call-display-actions` et peut être `file` ou `rest` ou `rainbowBot` ",
 " method : uniquement pour `on-incoming-pbx-call-display-actions` avec commandType `rest` et peut être `GET` ou `POST` ",
 " header : uniquement pour `on-incoming-pbx-call-display-actions` with commandType `rest` est optionnel ",
 " et sera inséré comme ligne d'en-tête dans la requête REST ",
 " Jid : uniquement pour `on-incoming-pbx-call-display-actions` with commandType `rainbowBot` ",
 " ",
 " Variable pour Rainbow user (ME) ",
 " ${localUser.firstName} ${localUser.lastName} ${localUser.email} ",
 " ${localUser.canonicalNumber} ${localUser.phoneNumber} ${localUser.internalNumber} ${localUser.phonePbx}",
 " ",
 " Variable pour l'utilisateur appelant ",
 " ${caller.firstName} ${caller.lastName} ${caller.phoneNumber} ",
 " ",
 " Variable pour le numéro appelé - lorsque l'appel est redirigé ou lorsque Rainbow reçoit le numéro du groupe ",
 " ${called.phoneNumber} ",
 " ",
 " Variable pour le contexte de l'appel ",
 " ${call.callId} ",
 " ${call.globalCallId} (OXE uniquement) ",
 " ${call.correlatorData} ",
 " ${call.hexCorrelatorData} " 
 ] }

Exemples de configuration avec l'outil MicroCRM

Pour ouvrir ou créer un enregistrement dans la base de données MicroCRM, afin de transmettre le numéro de téléphone, l'outil doit être exécuté avec le paramètre -number:

MicroCRM.exe -number numéro de téléphone

• Pour les exemples ci-dessous, nous utiliserons le numéro de téléphone de l'appelant, qui est la variable ${caller.phoneNumber}.
• MicroCRM est installé sur le PC à l'emplacement suivant : C:\MicroCRM\MicroCRM.exe

Exemple 1 - Ouvrir MicroCRM lors d'un appel entrant

Il suffit de modifier la partie suivante du fichier :

"on-answering-incoming-pbx-call-actions" : [ { "name" : " ", "command" : { "url" : " C:\NMicroCRM\NMicroCRM.exe", "params" : " -number${caller.phoneNumber}" } } ],

Note: N'oubliez pas d'utiliser le double \\N pour le chemin C :\\MicroCRM\\MicroCRM.exe

Exemple 2 - Ouvrir MicroCRM lorsque vous répondez à un appel en utilisant le bouton dédié dans la notification d'appel entrant

Il suffit de modifier la partie suivante du fichier :

"on-incoming-pbx-call-button-actions" : [ { "name" : "Open MicroCRM", "command" : { "url" : " C:\NMicroCRM\NMicroCRM.exe", "params" : " -number${caller.phoneNumber}" }, "AnswerOnClick" : true} ]

Remarque: pour ouvrir l'application externe et répondre à l'appel simultanément, vous devez définir le paramètre "AnswerOnClick" sur true.

Exemple 3 - Ouverture d'une page web de l'annuaire inversé français lors d'un appel entrant

Dans cet exemple, nous n'utilisons pas d'application installée sur le PC mais nous ouvrons une page web et la variable est directement fournie dans l'"url".

"on-incoming-pbx-call-actions" : [ { "name" : " ", "command" : { "url" : "https://www.pagesjaunes.fr/annuaireinverse/recherche", "params" : "quoiqui=${caller.phoneNumber}&proximite=0" } } ],

Options d'installation pour déployer le fichier custo-manifest.json à l'aide d'un outil de distribution de logiciels

Le fichier manifeste doit d'abord être déployé sur le PC, par exemple, le fichier peut être copié dans un dossier utilisateur C:\NUtilisateurs\NRainbow_custom_manifest\N.

Ensuite, l'installation de l'application Rainbow Desktop doit être lancée avec le paramètre /Custom afin d'appliquer le fichier custom-manifest pour l'utilisateur.

Utilisation de configurations MSI :

msiexec /i "Rainbow_installer_user.msi" WRAPPED_ARGUMENTS="/Custom=C:\Users\username\\Rainbow_custom_manifest\\custo-manifest.json"

Utilisation d'une configuration exe :

Rainbow_Installer.exe /Custom=C:\NUsers\NNusername\NRainbow_custom_manifest\Ncusto-manifest.json

Désactiver la fonctionnalité

Pour une installation via un outil de distribution de logiciels

Pour désactiver l'utilisation du fichier de manifeste personnalisé, exécutez l'installation avec /Custom sans aucune valeur
, par exemple Rainbow_Installer .exe /Custom ou désinstallez et installez à nouveau l'application de bureau Rainbow.

Pour l'installation manuelle/par l'utilisateur (importation du fichier custo-manifest)

Accédez au dossier C:ÚsersäusernameAppData\Roaming\Alcatel-Lucent Enterprise\N-.Rainbow

Supprimez le fichier custo-manifest.json

Migration Lancer des applications externes v1 à v2

Un utilisateur qui utilise déjà la version 1 peut continuer à l'utiliser sans aucun changement

L'importation/exportation ne sera pas présentée.

Pour migrer de la version 1 à la version 2, vous devez

1. Sauvegarder le fichier manifeste personnalisé v1.
2. Modifier le fichier Rainbow Settings et définir la ligne "customizationDirectory" : true
   • l'emplacement du fichier C:\NUsersonnesernameAppAppData\NRoaming\NAlcatel-Lucent Enterprise\NL'emplacement du fichier C:\NUsersonnesernameAppAppData\NRoaming\NAlcatel-LucentRainbow
   • note : vous devrez quitter Rainbow avant de modifier le fichier.
3. La section Paramètres->Téléphonie->Personnalisation devient visible.
4. Exportez le modèle, ajoutez dans ce fichier les commandes personnalisées de votre fichier sauvegardé à l'étape 1, puis importez-le à nouveau.