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 | ws://<load-balancer>:3000 |
Warning | ||
---|---|---|
| ||
The load balancer must be operated with https and a valid certificate. |
Additional configuration in jtel-clientmessenger
The 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.
Translations Ignore | ||
---|---|---|
|
Additional configuration on the load balancer
Additional entries are required in the frontend area for the portal:
Translations Ignore | ||
---|---|---|
|
Additional parameters
The following system parameters must be checked in the portal:
Parameter | Value | Comment |
---|---|---|
ACD.Whatsapp.Server.Base.URL | The URL used by the agent client to allow the agent to reply to messages. This must be resolved from all agent workstations to a valid URL via DNS, and is directed to the chat server via the haproxy. | |
ACD.Whatsapp.Whatsapp.Url | https://jtel-portal:3003 | The URL used by the outside world (WhatsApp users) to download the attachments of the messages. This must be resolved from the Internet to a valid URL via DNS, and is directed to the chat server via the haproxy. |
ACD.Whatsapp.Tyntec.Url | https://api.tyntec.com/chat-api/v2/messages | The URL of the TynTec API for WhatsApp. |
Customize TynTec API endpoints
It 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.
Setting | Value | ||||
---|---|---|---|---|---|
URL | https://api.tyntec.com/chat-api/v2/applications/default | ||||
Request Type | PATCH | ||||
Authorization | apikey Value = the generated API Key from Tyntec | ||||
Additional Headers | Accept application/problem+json | ||||
Additional Headers | Content-Type application/json | ||||
Body |
|
Chat Connector Configuration
The following additional parameters are configured in the Chat Connector:
- The check mark Whatsapp is set.
- The TynTec API Key is entered.
- The incoming service number for WhatsApp is configured and in E.164 and associated with the 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 :
|