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 :

Installation

Installation de Java 8

Tout d'abord, Java 8 est installé :

wget https://cdn.jtel.de/downloads/java/jdk-8u202-linux-x64.rpm dnf -y install ./jdk-8u202-linux-x64.rpm rm -f jdk-8u202-linux-x64.rpm

Installation et configuration de ClientMessenger

Installation ClientMessenger

Tout d'abord, le répertoire ClientMessenger est copié dans /home/jtel

cp -R /home/jtel/shared/JTELCarrierPortal/Utils/Install/ClientMessenger/ /home/jtel/ClientMessenger chown -R jtel:jtel /home/jtel/ClientMessenger

Fichier de configuration du  « Hazelcast Cluster »

Le fichier hazelcast.xml est copié dans le répertoire de configuration du serveur de chat. 

rm -f /home/jtel/ClientMessenger/conf/hazelcast.xml cp /home/jtel/shared/hazelcast.xml /home/jtel/ClientMessenger/conf/hazelcast.xml chown jtel:jtel /home/jtel/ClientMessenger/conf/hazelcast.xml

Configuration de la messagerie client

La configuration ou le fichier de démarrage jtel-clientmessenger peut devoir être adapté afin 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 :

# Editez ce fichier: vi /home/jtel/ClientMessenger/systemd/jtel-clientmessenger.service#service
# Vérifiez ce paramètre 
...
- Dde.jtel.platform.clientmessenger.connection = jdbc: mysql: // acd-dbm / JTELWeb? utilisateur = root & mot de passe = Fe1er3B0rl & characterEncoding = utf8 \ ...user=root&password=Fe1er3B0rl&characterEncoding=utf8 \
...
# Pour versions jtel portal >= 3.25
-Dde.jtel.platform.clientmessenger.connection=jdbc:mysql://acd-dbm/JTELWeb?user=root&password=Fe1er3B0rl&characterEncoding=utf8&serverTimezone=Europe/Berlin \

Installer ClientMessenger avec systemd

cp /home/jtel/ClientMessenger/systemd/jtel-clientmessenger.service /etc/systemd/system/jtel-clientmessenger.service systemctl daemon-reload systemctl enable jtel-clientmessenger.service

Créer le script de mise à jour

Un script de mise à jour est créé pour mettre à jour le serveur de chat :

cat <<EOFF>/usr/local/bin/updatesc.sh #!/bin/bash systemctl stop jtel-clientmessenger.service cp /home/jtel/shared/JTELCarrierPortal/Utils/Install/ClientMessenger/bin/* /home/jtel/ClientMessenger/bin chown -R jtel:jtel /home/jtel/ClientMessenger systemctl start jtel-clientmessenger.service EOFF chmod +x /usr/local/bin/updatesc.sh

Configurer le pare-feu

Ensuite, les Ouvrir ports du service de chat doivent être saisis dans le pare-feu et sauvegardés de façon permanente. Vous pouvez distinguer ici 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-feu

Exécutez les commandes suivantes, sur les machines suivantes :

• Sur le serveur CHAT (ici le port de chat et les ports de Hazelcast Cluster)
  
  

firewall-cmd --zone=public --add-port=5701-5801/tcp --permanent firewall-cmd --zone=public --add-port=3000/tcp --permanent firewall-cmd --reload

• Sur tous les LB - avec connexion http vers l'extérieur
  
  

firewall-cmd --zone=public --add-port=3000/tcp --permanent firewall-cmd --reload

Configuration https du Pare-feu

• Sur tous les LB - avec connexion https vers l'extérieur
  
  

firewall-cmd --zone=public --add-port=3003/tcp --permanent firewall-cmd --reload

Configuration de l'équilibreur de charge

réglages du haproxy.cfg

For http

Les ajustements suivants sont effectués sur l'haproxy, en cas de connexion http pour le chat vers l'extérieur :

frontend acdportal_chat_ws mode http bind :3000 timeout client 1d default_backend backend_chat_ws backend backend_chat_ws mode http balance leastconn # roundrobin server chatserver1 <ip_addresse_oder_name>:3000 weight 1 check inter 1m server chatserver2 <ip_addresse_oder_name>:3000 weight 1 check inter 1m

For https

frontend acdportal_chat_wss mode http bind :3003 ssl crt /etc/haproxy/haproxy.pem timeout client 1d default_backend backend_chat_ws backend backend_chat_ws mode http balance leastconn # roundrobin server chatserver1 <ip_addresse_oder_name>:3000 weight 1 check inter 1m server chatserver2 <ip_addresse_oder_name>:3000 weight 1 check inter 1m

Recharger l'haproxie

Ensuite, rechargez l'haproxy avec la commande suivante :

service haproxy reload

Configuration Chat

Paramètres (en tant que sysadmin)

Pour https / wss

For http / ws

Statut

Un 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 agent

Le nombre maximum 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 WhatsApp

Pour 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-clientmessenger

Le paramètre DATADIR doit être vérifié. Il doit indiquer soit le/srv/jtel/shared/Data/Clients/ s'il est hébergé directement sur le serveur de chat, ou /home/jtel/shared/Data/clients/ si le serveur a mis en sourdine le répertoire.

Environment=DATADIR=/home/jtel/shared/Data/clients/

Configurations supplémentaires sur l'équilibreur de charge

Des entrées supplémentaires sont nécessaires dans la zone frontale du portail :

frontend acdportal_https ... acl whatsapp_req path /incoming acl whatsapp_req path /delivery ... use_backend backend_chat_ws if whatsapp_req

Paramètres supplémentaires

Les paramètres suivants du système doivent être vérifiés dans le portail :

Personnaliser les points d'extrémité de l'API TynTec

Il 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.

{ "webhooks": [ { "events": [ "MoMessage" ], "callbackUrl": "https://jtel-portal/incoming" }, { "events": [ "MessageStatus::accepted", "MessageStatus::delivered", "MessageStatus::seen", "MessageStatus::failed", "MessageStatus::channelFailed", "MessageStatus::deleted", "WhatsAppGroupEvent::userJoined", "WhatsAppGroupEvent::userLeft", "WhatsAppGroupEvent::subjectChanged", "WhatsAppGroupEvent::descriptionChanged" ], "callbackUrl": "https://jtel-portal/delivery" } ] }

Configuration du connecteur de chat

Les paramètres supplémentaires suivants sont configurés dans le Chat Connector :

• La case à cocher "Whatsapp" est activée.
• La clé API TynTec est saisie.
• Le numéro de service entrant pour WhatsApp est configuré et en E.164 et associé au connecteur