Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The CHAT role is used for conducting chat sessions with agents from external websites. The CHAT role is also required for WhatsApp integrations. The chat server is a Java application, which can be installed in parallel on the web servers with corresponding additional RAM of about 4 GB per server. Alternatively, the chat-server can be installed on a separate server, or on the load balancer. The following recommendations are made:
InstallationJava8Installation
OLD - Java 8 Installation
Installing and Configuring ClientMessengerClientMessenger InstallationFirst of all, the ClientMessenger directory is copied to /home/jtel
Hazelcast Cluster Configuration FileThe hazelcast.xml file is copied to the configuration directory of the chat server.
Client Messenger ConfigurationThe configuration or the start file jtel-clientmessenger may have to be adapted so that the database connection can be established. Here <password> must be replaced with the password for the root user of the database:
Install ClientMessenger with systemd
Create the Update ScriptAn update script is created for updating the chat server:
Configure the FirewallNext, the open ports for the chat service must be entered in the firewall and saved persistently. Here you can distinguish whether http (speak unsecure websocket) or https (secure websocket) is used. Since the load balancer usually decrypts the https, for https only port 3003 needs to be opened to the load balancer. Firewall configuration httpExecute the following commands, on the following machines:
Firewall configuration https
Load Balancer Configurationhaproxy.cfg AdjustmentsFor httpThe following adjustments are made on the haproxy, in case of a http connection for the chat to the outside:
For https
Reload HaproxyThen, reload the haproxy with the following command:
Chat ConfigurationParameters (as sysadmin)For https / wss
For http / ws
P.S: To enable the chat attachement, please configure the following parameters: ACD.Whatsapp.Server.Base.URL and ACD.Whatsapp.Whatsapp.Url. See Add Additional parameters below for more details StatusAn appropriate agent status for "Chat" - or an existing status - must be configured so that chat is distributed to the agent: Max chats per agentThe maximum number of parallel chats per agent must be configured. This value is set to 0 by default for all agents. Additional configurations for WhatsAppIn order for What's App to work, further configurations still need to be made. Note: setting up the WhatsApp business account or connecting to the provider (currently TynTec) is done directly with the provider.
Additional configuration in jtel-clientmessengerThe parameter DATADIR must be checked. This must point to either the /srv/jtel/shared/Data/Clients/ directory if it is hosted directly on the chat server, or /home/jtel/shared/Data/clients/ if the server has mouted the directory.
Additional configuration on the load balancerAdditional entries are required in the frontend area for the portal:
Additional parametersThe following system parameters must be checked in the portal:
Customize TynTec API endpointsIt may be necessary to adjust the API endpoints to which the messages are sent. Currently TynTec does not offer the possibility to do this via a web configuration, this must be done via a REST call. The easiest way to do this is to use Postman. The following parameters are required, both callback URLs are adjusted according to the end point of the system.
Chat Connector ConfigurationThe following additional parameters are configured in the Chat Connector:
|
...
Sv translation | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Le rôle de CHAT est utilisé pour mener des sessions de chat avec des agents de sites web externes. Le rôle CHAT est également requis pour les intégrations WhatsApp. Le serveur de chat est une application Java, qui peut être installée en parallèle sur les serveurs web avec une mémoire vive supplémentaire correspondante d'environ 4 Go par serveur. Alternativement, le serveur de chat peut être installé sur un serveur séparé, ou sur l'équilibreur de charge. Les recommandations suivantes sont formulées :
InstallationInstallation de Java 8
Installation et configuration de ClientMessengerInstallation ClientMessengerTout d'abord, le répertoire ClientMessenger est copié dans /home/jtel
Fichier de configuration du « Hazelcast Cluster »Le fichier hazelcast.xml est copié dans le répertoire de configuration du serveur de chat.
Configuration de la messagerie clientIl se peut que la configuration ou le fichier de démarrage jtel-clientmessenger doive être adapté pour que la connexion à la base de données puisse être établie. Ici, <password> doit être remplacé par le mot de passe de l'utilisateur root de la base de données :
Installer ClientMessenger avec systemd
Créer le script de mise à jourUn script de mise à jour est créé pour mettre à jour le serveur de chat :
Configurer le pare-feuEnsuite, les ports open pour le service de chat doivent être saisis dans le pare-feu et enregistrés de manière persistante. Ici, vous pouvez distinguer si http (speak unsecure websocket) ou https (secure websocket) est utilisé. Comme l'équilibreur de charge décrypte généralement le https, pour le https, seul le port 3003 doit être ouvert à l'équilibreur de charge. Configuration http du Pare-feuExécutez les commandes suivantes, sur les machines suivantes :
Configuration https du Pare-feu
Configuration de l'équilibreur de chargeréglages du haproxy.cfgFor httpLes ajustements suivants sont effectués sur l'haproxy, en cas de connexion http pour le chat vers l'extérieur :
For https
Recharger l'haproxieEnsuite, rechargez l'haproxy avec la commande suivante :
Configuration ChatParamètres (en tant que sysadmin)Pour https / wss
For http / ws
N.B: Pour activer l'attachement du chat, veuillez configurer les paramètres suivants : ACD.Whatsapp.Server.Base.URL et ACD.Whatsapp.Whatsapp.Url. Voir Paramètres Supplémentaires ci-dessous pour plus de détails. StatutUn statut d'agent approprié pour le "Chat" - ou un statut existant - doit être configuré de manière à ce que le chat soit distribué à l'agent : Nombre maximum de chats par agentLe nombre maximal de chats parallèles par agent doit être configuré. Cette valeur est fixée à 0 par défaut pour tous les agents. Configurations supplémentaires pour WhatsAppPour que What's App fonctionne, d'autres configurations doivent encore être effectuées. Remarque : la création du compte professionnel WhatsApp ou la connexion au fournisseur (actuellement TynTec) se fait directement avec le fournisseur.
Configuration supplémentaire dans jtel-clientmessengerLe paramètre DATADIR doit être vérifié. Celui-ci doit pointer soit vers le répertoire /srv/jtel/shared/Data/Clients/ s'il est hébergé directement sur le serveur de chat, soit vers /home/jtel/shared/Data/clients/ si le serveur a mooté le répertoire.
Configurations supplémentaires sur l'équilibreur de chargeDes entrées supplémentaires sont nécessaires dans la zone frontale du portail :
Paramètres supplémentairesLes paramètres suivants du système doivent être vérifiés dans le portail :
Personnaliser les points d'extrémité de l'API TynTecIl peut être nécessaire d'ajuster les points terminaux de l'API vers lesquels les messages sont envoyés. Actuellement, TynTec n'offre pas la possibilité de le faire via une configuration web, cela doit être fait via un appel REST. Le moyen le plus simple est de faire appel au facteur. Les paramètres suivants sont requis, les deux URL de rappel sont ajustés en fonction du point final du système.
Configuration du connecteur de chatLes paramètres supplémentaires suivants sont configurés dans le Chat Connector :
|