Configuration d'une activité Chat NCS v3.0 (FR)

Configuration d'une activité Chat NCS v3.0 (FR)

Introduction

L'objectif de cet article est de fournir un guide détaillé des étapes à suivre pour configurer une activité de chat.
Ci-après les étapes à suivre permettant de déployer un modèle (celui-ci pourra évidemment être adapté en fonction de vos besoins opérationnels).

1.    Fichiers de configuration

Vous trouverez rattaché à cet article, deux fichiers à télécharger :
  1. ncschat.zip : Ce fichier doit être extrait dans le répertoire CrAppServer ; généralement il se trouve sous C:\Nixxis\CrAppServer\ncschat
  2. public_website.zip : Vous pouvez extraire ce fichier n’importe où sur votre ordinateur ou un serveur web pouvant communiquer avec le serveur applicatif Nixis ; il représente le côté client du chat et il vous suffit de l’ouvrir dans votre navigateur.
Attention :
Dans les codes du fichier index.html du dossier public_website, à la ligne 56, vous trouverez un iframe pointant vers http://10.x.x.x:8088/chat/
L’IP doit être remplacée par l’IP ou FQDN de votre serveur applicatif Nixxis. Vous devrez toutefois garder le trailing slash de /chat/

2.    Activation du chat

Dans le fichier http.config il est nécessaire de faire les adaptations/modifications suivantes dans l'application Agent :
  1. Changer la valeur de la clé client_AllowWaitingForChat à True, quand nécessaire
<add key="client_AllowWaitingForChat" value="True" />
  1. Changer la valeur de la clé "concurrentChat" et "concurrentChatActive" à "1", (valeur à adapter en fonction des besoins)
<add key="concurrentChat" value="1"/>
<add key="concurrentChatActive" value="1"/>
Dans l'administration NCS, dans la rubrique Intégration, cliquer sur le plugin HTTP Chat
Adapter les paramètres en fonction de votre configuration.


  1. Le chemin de stockage "recording" correspond au répertoire où seront écrits les fichiers au format texte ; exemple C:\nixxis\chatrecording
Attention :
Le répertoire doit exister au préalable. Dans la négative le créer manuellement.
Messages à adapter en fonction de vos besoins  :



Sauvegarder et démarrer le plugin.
  1. Au niveau du Gestionnaire des Services Internet (IIS), suivre les étapes ci-dessous :
a. Créer un site web "ChatRecordings" et pointer le répertoire physique vers le répertoire des enregistrements ; exemple C:\Nixxis\ChatRecording
b. Choisir comme ‘pool d’application’ le "DefaultAppPool"
c. Dans la section <Binding> :
i. Type: http 
ii. IP address: <All Unassigned> 
iii. Port: 8082(port libre) 


d. Activer "Anonymous Authentication" pour le site <ChatRecordings>

e. Activer <Directory Browsing> pour le site <ChatRecordings>

f.  Valider le fonctionnement de l’URL

4.    Configuration CrConfigurator :

  1. Ouvrir l’utilitaire CrConfigurator ; généralement ce dernier est accessible dans C:\Nixxis\CrAppServer\Provisioning\Settings\CrConfigurator.exe
  2. Sous l’onglet <Transfer>, Onglet <Chat>, il est nécessaire d’effectuer les adaptation ci-dessous :
Host: <<IISserverIP>>:8082
Root: {0}/{1}.{2}
Requested timeout: 360
Type: StrictHttp
Extension: txt
  1. Cliquer sur le bouton Save pour valider le changement. Dorénavant, les conversations du type <Chat> peuvent être téléchargées.

Note : À partir de la version 3.1.2, il est possible de paramétrer le chat directement dans le module administration.
Voir les étapes ci-dessous.

5.    Configuration au niveau de l'Admin Nixxis

Rajout d'une activité chat

Rajouter une activité chat dans une campagne existante ou créer une nouvelle campagne et y rajouter une activité chat.
Information à insérer :

Description : Le nom de l'activité, ex : Chat Live
Plugin : HTTP Chat

Suivant




Renseigner « chat » comme destination et éventuellement un script agent si nécessaire.

Terminer et sauvegarder.

Vous pouvez désormais tester le chat. 

7.    Détails du fichier enregistrement :



  1. Le nom du fichier d’enregistrement (dans le répertoire indiqué par la clé de config) est sous le format conversationId.txt, ou conversationId est l’identifiant du contact.
  2. Le fichier est au format texte et contient une ligne par événement dans la conversation.  Chaque ligne est composée des éléments suivants, séparés par une virgule.
a. La date et heure de l’évènement indique en nombre absolu de millisecondes écoulées depuis le 1/1/1970 à minuit. Vous pouvez utiliser un convertisseur en ligne pour l’avoir sous un autre format.
  1. Exemple de lien de convertisseur : https://www.timecalculator.net/milliseconds-to-date
b. Le type d’évènement exprimé en valeur numérique dans la liste suivante :
0.   Enter
1.   Leave
2.   Say
3.   Whisper
4.   Activate
5.   Wait
6.   Hold
7.   Retrieve
c. L'identifiant de l’agent si l’agent est à l’origine de l’événement.
d. Le pseudo du membre à l’origine de l’événement, encodé au format « escape javascript »
e. Le message associé à l’événement, encodé au format « escape javascript »
f. Des variables qui peuvent être changées :
agentNickName
{0}: Agent Account
{1}: Agent First Name
{2}: Agent Last Name
{3}: Agent Description
{4}: Agent Display Text
{5}: Activity.Description

8.    Modification du comportement <ENTER > Send Key :

  1. Ajouter les clés ci-dessous dans l'application agent du fichier http.config
  2. La première permet d’envoyer un message en utilisant la touche Enter et la deuxième permet d’utiliser la touche CTRL+ Enter afin d’insérer une ligne. 
<add key="client_ChatEnterKeyBehavior" value="send"/>  
<add key="client_ChatEnterKeyBehavior" value="newline"/>

9. Rajout d'activité supplémentaire  

Pour chaque activité supplémentaire, il est nécessaire de rajouter une application "chat" dans http.config. Le redémarrage du service n'est pas nécessaire.
L'id doit être unique et la baseURL correspond généralement à l'id, voir exemple plus bas.

La nouvelle application est appelée comme suit : http://appserver:8088/chat2/

<application id="chat2" name="Chat" type="NixxisChatApp" debug="true" sessionKey="agentScript">
<add key="baseUrl" value="/chat2" />
<add key="initialMessage" value="Hello, my name is {0} how can I help you ?" />
<add key="agentNickName" value="{0} {1} {2}" />
<add key="waitMessage" value="Please wait, we will connect you to a support agent" />
<add key="errorMessage" value="We are sorry, but we cannot answer your request immediately due to a technical problem" />
<add key="holdMessage" value="Just a moment please, I'll be right back..." />
<add key="retrieveMessage" value="Thank you for waiting" />
<add key="byeMessage" value="Thank you {1}, have a good day." />
<add key="leaveMessage" value="{0} left the conversation" />
<add key="filesPath" value="ncschat2" />
<add key="filesSettings" value="specificExt='.txt.html.htm.js.vbs.css';cacheControl='private';cacheDuration='10'" />
<add key="defaultFile" value="mychatfr.html" />
<add key="loginFile" value="mychatfr.html" />
<add key="recording" value="C:\Nixxis\ChatRecording" />
<add key="agentFile" value="/chat/crAgentChat.htm" />
</application>

    • Related Articles

    • Configuration d'une activité Chat (FR) NCS v2.x

      Introduction Cet article vise à fournir les détails pour la configuration de l'activité de chat. Ci-après les étapes à suivre permettant de déployer un modèle (celui-ci pourra évidemment être adapté en fonction de vos besoins opérationnels). Fichiers ...

    • Configuration of a Chat activity NCS v3.0 (EN)

      Introduction The objective of this article is to provide a detailed guide on the steps to follow to configure a chat activity. Below are the steps to follow for deploying a model (which can, of course, be adapted based on your operational needs). 1. ...

    • NCS v3.x - Procédure d'installation et de configuration (FR)

      Introduction Le but de ce document est de vous guider à travers le processus d'installation et de configuration du serveur d'application Nixxis Contact Suite V3.x. 1. Prérequis Prérequis généraux : Il est essentiel de vous assurer que les prérequis ...

    • Module d'outil d'écoute des enregistrements v3.0

      Introduction Cet article a pour but de décrire le fonctionnement et les paramètres disponibles pour le module d'outil d'écoute des enregistrements. Accès à l'interface Une fois l’application démarrée, choisissez via le sélecteur de module, ...

    • NCS v2.x - Installation and configuration procedure

      Introduction The purpose of this document is to guide you through the installation and the configuration process of Nixxis Contact Suite V2.x Application Server. 1. Prerequisites General prerequisites: The related documentation is available online ...