Sv translation

language	en

Introduction

The CHAT role is used for conducting chat sessions with agents from external websites.

...

In addition, the CHAT role can also be converted into a WhatsApp Connector with the provider TynTec. This allows clients to offer their customers the option to send requests through WhatsApp, instead of a Web-Based CHAT. Chat and WhatsApp Connectors can be used in parallel.

Requirements

The jtel Chat Module
The installation can either be done in parallel with an already existing web server or load balancer - with a corresponding RAM extension of about 4 GB per server - or

...

on a separate server

Configuration

Creating a new Chat Connector

A new Connector can be created via the web-interface. Logged in as a Client Administrator, navigate to "Menu → Chat → Chat Connectors" and press "new".

...

Requirements

The jtel Chat Module

Chat Connector Configuration

The following additional parameters are configured in the Chat Connector:

...

In the resulting popup, the assigned Client ID is shown, as well as the fields to provide a name and title for the Connector.

After clicking "Save", you can enter the configuration page by clicking "Edit" on the Connector.

Settings

Master Data

Field	Explanation
Client ID	ID of the client in which the Connector is created
Name	Name of the Connector
Title	Title of the Connector
WhatsApp	When inactive, the Connector is a Chat Connector When active, the Connector functions both as a Chat and a Whatsapp Connector

Distribution

Field	Explanation
ACD Group	The ACD-Group inside which the events are distributed
Max Chats all Agents	The maximum amount of simultaneous chat events that can be handled by the Connector amongst all agents in the configured ACD-Group
Priority	The priority of incoming chat events. Used primarily when more than one Connector is attached to the same ACD-Group
Maximum connect wait time (s)	The amount of time that can pass before an agent must have opened the incoming chat event by pressing on the indicator. If the configured value is exceeded, the event will be redistributed to another agent
Maximum agent answer time (s)	The amount of time that can pass before the agent has sent the first reply to the customer. If the configured value is exceeded, the event will be redistributed to another agent
Maximum free agent search time (s)	The maximum amount of time the system will search for an available agent. If the configured value is exceeded the event will be closed and the customer will be informed
Skill 1	The first skill which can be attached to incoming events.
Minimum Skill 1	The minimum value of skill 1 required by an agent to have the event distributed to him
Ignore skill 1 after timeout (s)	The amount of time that will pass until skill 1 is ignored and not considered in event distribution
Skill 2	The second skill which can be attached to incoming events.
Minimum Skill 2	The minimum value of skill 2 required by an agent to have the event distributed to him
Ignore skill 2 after timeout (s)	The amount of time that will pass until skill 2 is ignored and not considered in event distribution
Skill 3	The third skill which can be attached to incoming events.
Minimum Skill 3	The minimum value of skill 3 required by an agent to have the event distributed to him
Ignore skill 3 after timeout (s)	The amount of time that will pass until skill 3 is ignored and not considered in event distribution
Ignore Skills after timeout (s)	The amount of time that will pass until all configured skills are ignored and not considered in event distribution
Ignore skills if no agents with skills available	If checked, skill distribution will be inactive when no agents with the required skills are available in the ACD-Group

Code

Field

Example Configuration

Configuration

{
"noAgents":"Sorry, currently there are no agents available. Please try again later.",
"noAgents#de":"Es tut uns leid, aber derzeit sind keine Agenten verfügbar. Bitte probieren Sie etwas später nochmal.",
"outOfService":"Sorry, but the service is not available at the moment.",
"outOfService#de":"Es tut uns leid, aber der Service steht derzeit nicht zu Verfügung",
"agentTyping":"Agent $agent is typing...",
"agentTyping#de":"Agent $agent schreibt ...",
"bye":"Thank you for using our service. Goodbye.",
"bye#de":"Danke, dass Sie unseren Service genutzt haben. Auf Wiedersehen.",
"byeNoAgent": "Sorry, currently there are no agents available. Please try again later.",
"byeNoAgent#de":"Es tut uns leid, aber derzeit sind keine Agenten verfügbar. Bitte probieren Sie etwas später nochmal.",
"welcomeMessage":"Welcome!",
"welcomeMessage#de":"Herzlich willkommen!.",
"editorPlaceholder":"Enter your message here.",
"editorPlaceholder#de":"Geben Sie Ihre Nachricht hier ein."
}

Explanation:

noAgents

When no agent is available, the configured message is sent to the customer.

outOfService

When the service is not available at the moment.

agentTyping

When the agent enters a response to the customer, the customer is informed by a notification in the chat window.

In this resource the placeholder $agent can be used. It will be replaced with agent nick name and if the field is empty with UsersUID.

Note

icon	false
title	WhatsApp

This message is not displayed to customers who use WhatsApp

bye

When the chat event is closed, the configured message is sent to the customer.

byeNoAgent

When no agent is available, the configured message is sent to the customer.

welcomeMessage

After a customer has sent a message and opened a new event, the configured message is sent to the customer.

editorPlaceholder

This message is displayed to the customer after the window for chat is opened at the external website.

Note

icon	false
title	WhatsApp

This message is not displayed to customers who use WhatsApp

Code

Code Block

language	text

<script src='https://websiteurl.de:3003/gui//chat.js'></script>
<script type="text/javascript">
   JTEL.initChat({ 
       Hash: 'ZkGgUcDkLPEY',
       BaseWSURI: 'wss://chatserverurl.de:3003',
       BaseResourceURI: 'https://storageserverurl:3003/gui', //optional
       pdata: {name:'John Doe', email:'john.doe@example.com', sender:'John Doe', receiver:'My Chat Connector', userdata:'123456', userdata2:'userdata2', userdata3:'userdata3'},
       udata: {anyfield1:'Any Field 1', anyfield2:'Any Field 2'} });
</script>

Explanation:

To access the jtel server, the code is embedded into the external website. The code is generated with the settings from the parameters in the jtel portal, as well as the settings from the page Master Data in the chat Connector configuration.

REST

Token Post

Field

Example Configuration

Url

Code Block

language	text

https://myrestservice.example.com/service/GetToken

Header

Code Block

language	text

Cache-Control: no-cache
Content-Type: application/x-www-form-urlencoded;charset=UTF-8
Authorization: Basic XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Body

Code Block

language	text

grant_type=client_credentials&redirect_uri=https://myrestservice.example.com/service/api/v1/Customers/Contacts

Report Export Post

Field

Example Configuration

Url

Code Block

language	text

https://myrestservice.example.com/service/api/v1/Customers/Contacts

Header

Code Block

language	text

Cache-Control: no-cache
Content-Type: application/json
Authorization: Bearer $tokenResponse.body.JSON.access_token

Body

Code Block

language	text

{"CustomerNumber":"$chatConnector.id",
"XMLCodedData":"$xmlTemplate.encoded.base64"}

Xml Template

Code Block

language	text

<?xml version="1.0" encoding="utf-8"?>
<chatReport>
<Size>$report.bytes</Size>
<Content>$report.encoded.base64</Content>
</chatReport>

Portal Configuration

Additional configuration in the portal is necessary, regarding the distribution of Chat and WhatsApp events

Agent Status

Agent status for chat - or an existing status - must be configured to allow a chat event to be distributed to the agent:

Image Added

Max chats per agent

The maximum number of parallel chats per agent must be configured. This value is set to 0 by default for all agents. The checkmark at "Ticket via Web Interface" has to be checked.

Image Added

Additional configurations for WhatsApp

Additional parameters are required for WhatsApp connectors

Master Data

Field	Explanation
WhatsApp	When active, the Connector is changed to a WhatsApp Connector
Whatsapp ApiKey	The TynTec API Key is entered in this field
Whatsapp Number

...

	The phone number is entered in E.164 format

The additional configuration required on the server side is described here: Role CHAT

Sv translation

language	de

Einführung

Die Rolle CHAT wird für die Durchführung von Chat-Sitzungen mit Agenten von externen Websites verwendet. Darüber hinaus kann die Rolle CHAT mit dem Provider TynTec auch in einen WhatsApp Konnektor umgewandelt werden. Dies ermöglicht es Klienten, ihren Kunden die Möglichkeit anzubieten, anfragen über WhatsApp statt über einen webbasierten CHAT zu senden. Chat und WhatsApp Konnektoren können parallel verwendet werden.

Anforderungen

Das jtel Chat Modul
Die Installation kann entweder parallel zu einem bereits vorhandenen Webserver oder Loadbalancer - mit einer entsprechenden RAM-Erweiterung von etwa 4 GB pro Server - oder auf einem separaten Server erfolgen

Konfiguration

Erstellen eines neuen Chat-Connectors

Ein neuer Konnektor kann über das Portal erstellt werden. Melden Sie sich als Client Administrator an, navigieren Sie zu "Menü → Chat → Chat-Konnektoren" und drücken Sie "Neu". Im daraufhin erscheinenden Popup-Fenster werden die zugewiesene Client-ID sowie die Felder zur Angabe eines Namens und Titels für den Konnektor angezeigt.

Nachdem Sie auf "Speichern" geklickt haben, können Sie die Konfigurationsseite aufrufen, indem Sie auf "Bearbeiten" auf dem Konnektor klicken.

Einstellungen

Stammdaten

Feld	Erläuterung
Client ID	ID des Clients, in dem der Konnektor erstellt wird
Name	Name des Konnektors
Titel	Titel des Konnektors
WhatsApp	Wenn der Haken inaktiv ist, ist der Konnektor ein Chat-Konnektor Wenn der Haken aktiv ist, fungiert der Konnektor sowohl als Chat- als auch als Whatsapp-Konnektor

Verteilung

Feld	Erläuterung
ACD Gruppe	Die ACD-Gruppe, in der die Medienereignisse verteilt werden
Max Chats alle Agenten	Die maximale Anzahl gleichzeitiger Chat-Ereignisse, die vom Konnektor zwischen allen Agenten in der konfigurierten ACD-Gruppe bearbeitet werden können
Priorität	Die Priorität der eingehenden Chat-Ereignisse. Wird hauptsächlich verwendet, wenn mehr als ein Konnektor an dieselbe ACD-Gruppe angeschlossen ist.
Maximale Konnektwartezeit (s)	Die Zeitspanne, die vergehen kann, bis ein Agent das eingehende Chat-Ereignis durch Drücken auf den Indikator geöffnet haben muss. Wenn der konfigurierte Wert überschritten wird, wird das Ereignis auf einen anderen Agenten umverteilt.
Maximale Antwortwartezeit (s)	Die Zeitspanne, die vergehen kann, bis der Agent die erste Antwort an den Kunden gesendet hat. Wenn der konfigurierte Wert überschritten wird, wird das Ereignis an einen anderen Agenten neu verteilt.
Maximale Suchzeit nach freien Agenten (s)	Die maximale Zeitspanne, die das System für die Suche nach einem verfügbaren Agenten verwendet. Wenn der konfigurierte Wert überschritten wird, wird das Ereignis geschlossen und der Kunde informiert.
Skill 1	Der erste Skill, der mit eingehenden Ereignissen verknüpft werden kann.
Mindestwert Skill 1	Der Mindestwert von Skill 1, der von einem Agenten benötigt wird, um das Ereignis an ihn zu verteilen
Ignoriere Skill 1 nach Timeout (s) (s)	Die Zeitspanne, die vergeht, bis Skill 1 ignoriert und bei der Ereignisverteilung nicht berücksichtigt wird
Skill 2	Der zweite Skill, der mit eingehenden Ereignissen verknüpft werden kann.
Mindestwert Skill 2	Der Mindestwert von Skill 2, der von einem Agenten benötigt wird, um das Ereignis an ihn zu verteilen
Ignoriere Skill 2 nach Timeout (s) (s)	Die Zeitspanne, die vergeht, bis Skill 2 ignoriert und bei der Ereignisverteilung nicht berücksichtigt wird
Skill 3	Der dritte Skill, der mit eingehenden Ereignissen verbunden werden kann.
Mindestwert Skill 3	Der Mindestwert von Skill 3, den ein Agent benötigt, um das Ereignis an sich verteilen zu lassen
Ignoriere Skill 3 nach Timeout (s)	Die Zeitspanne, die vergeht, bis Skill 3 ignoriert und bei der Ereignisverteilung nicht berücksichtigt wird
Ignore Skills after timeout (s)	Die Zeitspanne, die vergeht, bis alle konfigurierten Skills ignoriert und bei der Ereignisverteilung nicht berücksichtigt werden
Ignoriere Skills, wenn keine Agenten mit den Skills verfügbar sind	Falls angekreuzt, ist die Kompetenzverteilung inaktiv, wenn keine Agenten mit den erforderlichen Fähigkeiten in der ACD-Gruppe verfügbar sind.

Code

Feld

Beispiel-Konfiguration

Konfiguration

{
"noAgents":"Sorry, currently there are no agents available. Please try again later.",
"noAgents#de":"Es tut uns leid, aber derzeit sind keine Agenten verfügbar. Bitte probieren Sie etwas später nochmal.",
"outOfService":"Sorry, but the service is not available at the moment.",
"outOfService#de":"Es tut uns leid, aber der Service steht derzeit nicht zu Verfügung.",
"agentTyping":"Agent $agent is typing...",
"agentTyping#de":"Agent $agent schreibt ...",
"bye":"Thank you for using our service. Goodbye.",
"bye#de":"Danke, dass Sie unseren Service genutzt haben. Auf Wiedersehen.",
"byeNoAgent": "Sorry, currently there are no agents available. Please try again later.",
"byeNoAgent#de":"Es tut uns leid, aber derzeit sind keine Agenten verfügbar. Bitte probieren Sie etwas später nochmal.",
"welcomeMessage":"Welcome!",
"welcomeMessage#de":"Herzlich willkommen!.",
"editorPlaceholder":"Enter your message here.",
"editorPlaceholder#de":"Geben Sie Ihre Nachricht hier ein."
}

Erläuterung:

noAgents

Wenn kein Agent verfügbar ist, wird die konfigurierte Nachricht an den Kunden gesendet.

outOfService

Wenn der Service steht derzeit nicht zu Verfügung.

agentTyping

Wenn der Agent eine Antwort an den Kunden eingibt, wird dem Kunden angezeigt, dass der Agent in diesem Augenblick eine Nachricht schreibt.

Note

icon	false
title	WhatsApp

Diese Meldung wird Kunden, die WhatsApp verwenden, nicht angezeigt.

bye

Wenn das Medienereignis geschlossen ist, wird die konfigurierte Nachricht an den Kunden gesendet

byeNoAgent

Wenn kein Agent verfügbar ist, wird die konfigurierte Nachricht an den Kunden gesendet

welcomeMessage

Nachdem ein Kunde eine Nachricht gesendet und eine neues Medienereignis eröffnet wurde, wird die konfigurierte Nachricht an den Kunden gesendet

editorPlaceholder

Diese Nachricht wird dem Kunden angezeigt, nachdem das Fenster für den Chat auf der externen Website geöffnet wurde.

Note

icon	false
title	WhatsApp

Diese Meldung wird Kunden, die WhatsApp verwenden, nicht angezeigt.

Code

Code Block

language	text

<script src='https://websiteurl.de:3003/gui//chat.js'></script>
<script type="text/javascript">
   JTEL.initChat({ 
       Hash: 'ZkGgUcDkLPEY',
       BaseWSURI: 'wss://chatserverurl.de:3003',
       BaseResourceURI: 'https://storageserverurl:3003/gui', //optional
       pdata: {name:'John Doe', email:'john.doe@example.com', sender:'John Doe', receiver:'My Chat Connector', userdata:'123456', userdata2:'userdata2', userdata3:'userdata3'},
       udata: {anyFeld1:'Any Feld 1', anyFeld2:'Any Feld 2'} });
</script>

Erläuterung:

Um auf den Jtel-Server zuzugreifen, wird der Code in die externe Website eingebettet. Der Code wird mit den Einstellungen aus den Parametern im Jtel-Portal sowie den Einstellungen aus der Seite Stammdaten im Chat Konnektor Konfiguration generiert.

REST

Token Post

Feld

Beispiel-Konfiguration

Url

Code Block

language	text

https://myrestservice.example.com/service/GetToken

Header

Code Block

language	text

Cache-Control: no-cache
Content-Type: application/x-www-form-urlencoded;charset=UTF-8
Authorization: Basic XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Body

Code Block

language	text

grant_type=client_credentials&redirect_uri=https://myrestservice.example.com/service/api/v1/Customers/Contacts

Report Export Post

Feld

Beispiel-Konfiguration

Url

Code Block

language	text

https://myrestservice.example.com/service/api/v1/Customers/Contacts

Header

Code Block

language	text

Cache-Control: no-cache
Content-Type: application/json
Authorization: Bearer $tokenResponse.body.JSON.access_token

Body

Code Block

language	text

{"CustomerNumber":"$chatConnector.id",
"XMLCodedData":"$xmlTemplate.encoded.base64"}

Xml Template

Code Block

language	text

<?xml version="1.0" encoding="utf-8"?>
<chatReport>
<Size>$report.bytes</Size>
<Content>$report.encoded.base64</Content>
</chatReport>

Siehe auch: Chat Report Export

Portal Konfiguration

Für die Verteilung von Chat- und WhatsApp-Veranstaltungen ist eine zusätzliche Konfiguration im Portal erforderlich.

Agentenstatus

Der Agentenstatus für den Chat - oder ein vorhandener Status - muss so konfiguriert werden, dass ein Chat-Ereignis an den Agenten verteilt werden kann:

Image Added

Max chats pro agent

Die maximale Anzahl paralleler Chats pro Agent muss konfiguriert werden. Dieser Wert ist standardmäßig für alle Agenten auf 0 gesetzt. Das Häkchen bei "Ticket über Web-Schnittstelle" muss gesetzt werden.

Image Added

Zusätzliche Konfigurationen für WhatsApp

Für WhatsApp Konnektoren sind zusätzliche Parameter erforderlich

Stammdaten

Feld	Erläuterung
WhatsApp	Wenn er aktiv ist, wird der Konnektor in einen WhatsApp Konnektor geändert.
Whatsapp ApiKey	Der TynTec API-Schlüssel wird in dieses Feld eingegeben
Whatsapp Nummer	Die Telefonnummer wird im E.164-Format eingegeben

Die zusätzlich erforderliche Konfiguration auf der Serverseite wird hier beschrieben: Role CHAT

Sv translation

language	fr

Introduction

Le rôle de CHAT est utilisé pour mener des sessions de chat

...

Chat Connector

Example configuration

WhatsApp Connector

Example configuration

Using Chat Connectors

Test Case

Using WhatsApp Connectors

avec des agents de sites web externes. En outre, le rôle de CHAT peut également être converti en connecteur WhatsApp avec le fournisseur TynTec. Cela permet aux clients d'offrir à leurs clients la possibilité d'envoyer des demandes via WhatsApp, au lieu d'un CHAT basé sur le Web. Les connecteurs de chat et WhatsApp peuvent être utilisés en parallèle.

Conditions

Le module de chat de jtel
L'installation peut se faire soit en parallèle avec un serveur web ou un équilibreur de charge déjà existant - avec une extension de RAM correspondante d'environ 4 Go par serveur - soit sur un serveur séparé

Configuration

Créer un nouveau connecteur de chat

Un nouveau connecteur peut être créé via l'interface Web. Connecté en tant qu'administrateur client, accédez à "Menu → Chat → Connecteurs de chat" et appuyez sur "Nouveau". Dans la fenêtre contextuelle qui en résulte, l'ID client attribué est affiché, ainsi que les champs pour fournir un nom et un titre pour le connecteur.

Après avoir cliqué sur "Sauvegarder", vous pouvez entrer dans la page de configuration en cliquant sur "Modifier" sur le Connecteur.

Paramètres

Données de base

Champ	Explication
ID Client	ID du client dans lequel le Connecteur est créé
Nom	Nom du connecteur
Titre	Le Titre du connecteur
Whatsapp	Lorsqu'il est inactif, le Connecteur est un Connecteur de Chat Lorsqu'il est actif, le Connecteur fonctionne à la fois comme un Connecteur de Chat et un Connecteur Whatsapp

Distribution

Champ	Explication
Groupe ACD	Le groupe ACD au sein duquel les événements sont distribués
Max Chats tous les agents	Le nombre maximum d'événements de chat simultanés pouvant être traités par le connecteur parmi tous les agents du groupe ACD configuré
Priorité	La priorité des événements de chat entrants. Utilisé principalement lorsque plus d'un connecteur est attaché au même groupe ACD
Temps d'attente maximum pour la connexion (s)	Le temps qui peut s'écouler avant qu'un agent n'ait ouvert le chat entrant en appuyant sur l'indicateur. Si la valeur configurée est dépassée, l'événement sera redistribué à un autre agent
Temps de réponse maximum de l'agent (s)	Le temps qui peut s'écouler avant que l'agent n'ait envoyé la première réponse au client. Si la valeur configurée est dépassée, l'événement sera redistribué à un autre agent
Durée maximale de recherche d'un agent libre (s)	La durée maximale pendant laquelle le système recherchera un agent disponible. Si la valeur configurée est dépassée, l'événement sera clôturé et le client sera informé
Compétence 1	La première compétence qui peut être attachée aux événements entrants.
Compétence minimale 1	La valeur minimale de la compétence 1 requise par un agent pour que l'événement lui soit distribué
Ignorer la compétence 1 après temps mort(s)	Le temps qui s'écoulera jusqu'à ce que la compétence 1 soit ignorée et ne soit pas prise en compte dans la distribution des événements
Compétence 2	La deuxième compétence qui peut être attachée aux événements entrants.
Compétence minimale 2	La valeur minimale de la compétence 2 requise par un agent pour que l'événement lui soit distribué
Ignorer la compétence 2 après temps mort(s)	Le temps qui s'écoulera jusqu'à ce que la compétence 2 soit ignorée et ne soit pas prise en compte dans la distribution des événements
Compétence 3	La troisième compétence qui peut être attachée aux événements entrants.
Compétence minimale 3	La valeur minimale de la compétence 3 requise par un agent pour que l'événement lui soit distribué
Ignorer la compétence 3 après temps mort(s)	Le temps qui s'écoulera jusqu'à ce que la compétence 3 soit ignorée et ne soit pas prise en compte dans la distribution des événements
Ignorer Compétences après temps mort (s)	Le temps qui s'écoulera avant que toutes les compétences configurées soient ignorées et ne soient pas prises en compte dans la distribution des événements
Ignorer les compétences si aucun agent n'est disponible	Si elle est vérifiée, la répartition des compétences sera inactive lorsqu'aucun agent possédant les compétences requises n'est disponible dans le groupe ACD

Code

Champ

Exemple de Configuration:

Configuration

{
"noAgents":"Désolé, il n'y a actuellement aucun agent disponible. Veuillez réessayer plus tard. ",
" noAgents # fr ":" Nous sommes désolés, mais aucun agent n'est disponible pour le moment. Veuillez réessayer un peu plus tard",
"outOfService":"Désolé, mais nous sommes actuellement fermés. Veuillez réessayer pendant les heures de bureau",
"outOfService#fr":"Veuillez réessayer pendant les heures de travail", Veuillez réessayer pendant nos heures d'ouverture.",
"agentTyping" : "Agent $agent is typing...",
"agentTyping#fr" : "Agent $agent is typing...",
"bye" : "Merci d'utiliser notre service. Au revoir.",
"bye#fr":"Merci d'utiliser notre service. Goodbye.",
"byeNoAgent" : "Désolé, il n'y a actuellement aucun agent disponible. Please try again later",
"byeNoAgent#en" : "Nous sommes désolés, mais il n'y a actuellement aucun agent disponible. Veuillez réessayer un peu plus tard.",
"welcomeMessage" : "Welcome !",
"welcomeMessage#en" : "Welcome !",
"editorPlaceholder" : "Enter your message here.",
"editorPlaceholder#en" : "Enter your message here."
}

Explication :

noAgents

Lorsqu'aucun agent n'est disponible, le message configuré est envoyé au client.

outOfService

Lorsqu'aucun agent n'est disponible, le message configuré est envoyé au client

agentTyping

Lorsque l'agent entre une réponse au client, celui-ci est informé par une notification dans la fenêtre de chat.

Note

icon	false
title	Whatsapp

Ce message n'est pas affiché aux clients qui utilisent WhatsApp

bye

Lorsque la session de chat est terminée, le message configuré est envoyé au client.

byeNoAgent

Lorsqu'aucun agent n'est disponible, le message configuré est envoyé au client.

welcomeMessage

Après qu'un client a envoyé un message et ouvert un nouvel événement, le message configuré est envoyé au client.

editorPlaceholder

Ce message est affiché au client après l'ouverture de la fenêtre de chat sur le site web externe.

Note

icon	false
title	Whatsapp

Ce message n'est pas affiché aux clients qui utilisent WhatsApp

Code

Code Block

language	text

<script src='https://websiteurl.de:3003/gui//chat.js'></script> <script type="text/javascript">    JTEL.initChat({         Hash: 'ZkGgUcDkLPEY',        BaseWSURI: 'wss://chatserverurl.de:3003',        BaseResourceURI: 'https://storageserverurl:3003/gui', //optional        pdata: {name:'John Doe', email:'john.doe@example.com', sender:'John Doe', receiver:'My Chat Connector', userdata:'123456', userdata2:'userdata2', userdata3:'userdata3'},        udata: {anyfield1:'Any Field 1', anyfield2:'Any Field 2'} }); </script>

Explication :

Pour accéder au serveur jtel, le code est intégré au site web externe. Le code est généré avec les paramètres du portail jtel, ainsi qu'avec les paramètres de la page Master Data dans la configuration du connecteur de chat.

REST

Jeton Post

Champ

Exemple de Configuration:

Url

Code Block

language	text

https://myrestservice.example.com/service/GetToken

Entête

Code Block

language	text

Cache-Control: no-cache Content-Type: application/x-www-form-urlencoded;charset=UTF-8 Authorization: Basic XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Corps

Code Block

language	text

grant_type=client_credentials&redirect_uri=https://myrestservice.example.com/service/api/v1/Customers/Contacts

Reporter le poste exporté

Champ

Exemple de Configuration:

Url

Code Block

language	text

https://myrestservice.example.com/service/api/v1/Customers/Contacts

Entête

Code Block

language	text

Cache-Control: no-cache Content-Type: application/json Authorization: Bearer $tokenResponse.body.JSON.access_token

Corps

Code Block

language	text

{"CustomerNumber":"$chatConnector.id", "XMLCodedData":"$xmlTemplate.encoded.base64"}

Template Xml

Code Block

language	text

<?xml version="1.0" encoding="utf-8"?> <chatReport> <Size>$report.bytes</Size> <Content>$report.encoded.base64</Content> </chatReport>

Voir aussi: Chat Report Export.

Configuration du portail

Une configuration supplémentaire dans le portail est nécessaire, concernant la distribution des événements Chat et WhatsApp

Statut Agent

Le statut d'agent pour le chat - ou un statut existant - doit être configuré pour permettre à un événement de chat d'être distribué à l'agent :

Image Added

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. Il faut cocher la case "Ticket via l'interface Web".

Image Added

Configurations supplémentaires pour WhatsApp

Des paramètres supplémentaires sont nécessaires pour les connecteurs WhatsApp

Données de base

Champ	Explication
Whatsapp	Lorsqu'il est actif, le Connecteur est remplacé par un Connecteur WhatsApp
ApiKey Whatsapp	La clé API TynTec est saisie dans ce champ
Numéro Whatsapp	Le numéro de téléphone est saisi au format E.164

La configuration supplémentaire requise du côté serveur est décrite ici : Role CHAT

...

Page tree

Page History

Versions Compared

Old Version 3

New Version Current

Key

Introduction

Requirements

Configuration

Creating a new Chat Connector

Requirements

Chat Connector Configuration

Settings

Master Data

Distribution

Code

Explanation:

Explanation:

REST

Token Post

Report Export Post

Portal Configuration

Agent Status

Max chats per agent

Additional configurations for WhatsApp

Master Data

The additional configuration required on the server side is described here: Role CHAT

Einführung

Anforderungen

Konfiguration

Erstellen eines neuen Chat-Connectors

Einstellungen

Stammdaten

Verteilung

Code

Erläuterung:

Erläuterung:

REST

Token Post

Report Export Post

Portal Konfiguration

Agentenstatus

Max chats pro agent

Zusätzliche Konfigurationen für WhatsApp

Stammdaten

Die zusätzlich erforderliche Konfiguration auf der Serverseite wird hier beschrieben: Role CHAT

Introduction

Chat Connector

WhatsApp Connector

Using Chat Connectors

Using WhatsApp Connectors

Conditions

Configuration

Créer un nouveau connecteur de chat

Paramètres

Données de base

Distribution

Code

Explication :

Explication :

REST

Jeton Post

Reporter le poste exporté

Configuration du portail

Statut Agent

Nombre maximum de chats par agent

Configurations supplémentaires pour WhatsApp

Données de base

La configuration supplémentaire requise du côté serveur est décrite ici : Role CHAT