Composant public

Une partie du module "Chat" c'est un composant public qui permet d'intégrer ce module à tout site web. Après l'installation d'un composant public, les visiteurs du site pourront communiquer avec les utilisateurs du système TeamWox par le chat.

Pour initialiser le module "Chat", il faut placer sur le site le fichier "support.html" qui contient:

<html style="height:100%;">
<head>
 <title></title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
 <body style="margin:0px;">
   <object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
 codebase="https://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,0,0"
 width="100%" height="100%" id="main" align="middle">
     <param name="allowScriptAccess" value="sameDomain" />
     <param name="allowFullScreen" value="false" />
     <param name="movie" value="support.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#FFFFFF" />
     <param name="flashvars" value="url=https://team.yourdomain.com" />
     <embed src="support.swf" flashvars="url=https://team.yourdomain.com" width="100%"
 height="100%" quality="high" bgcolor="#FFFFFF" name="main" align="middle"
 allowScriptAccess="sameDomain" allowFullScreen="false" type="application/x-shockwave-flash"
 pluginspage="http://www.macromedia.com/go/getflashplayer" />
   </object>
 </body>
</html>

Le fichier "support.swf" doit aussi être dans le même répertoire. Download support.swf and support.html

  • Pour configurer la connexion dans les paramètres des balises<param> et <embed>il est nécessaire de changer l'adresse dans le paramètre "url" sur l'adresse de votre serveur TeamWox.
  • Il est instamment recommandé de travailler avec le chat selon le protocole "https" pour la transmission securisé des données entre le site et le système TeamWox. Toutefois au travail par ce protocole il faut avoir le certificat SSL signé par l'un des compagnies confiées de la certification, dont l'installation se réalise par le module "Gestion" ou à l'installation du système TeamWox. A l'utilisation d'un certificat auto-signé qui est accordé avec le système TeamWox, la connexion peut être établie seulement selon le protocole HTTP, dans ce cas il faut écrire "http", et pas "https" avant l'adresse du domaine dans le fichier HTML.

Vous pouvez monter aussi de différents paramètres de la fenêtre du chat dans les attributs "Value" de la balise <param> et l'attribut "Flashvars" de la balise <embed>:

Vous trouverez des exemples détaillés de la réalisation du composant public du module "Chat" dans les langues PHP et .NET dans les paragraphes de ce chapitre.

Réglages générales

Information sur le client

Pour la réception de l'information sur le client sont prévus les paramètres suivants:

  • name=[NOM DU CLIENT]
  • email=[E-MAIL DU CLIENT]
  • phone=[TELEPHONE DU CLIENT]
  • company=[COMPAGNIE DU CLIENT]
  • account=[NUMERO DU COMPTE DU CLIENT]

Ce groupe de paramètres spécifié les valeurs des champ prédéfinies pour les clients. Les noms, les adresses électroniques, les numéros de téléphone et les noms des compagnies peuvent être automatiquement remplacés de l'information sur les utilisateurs enregistrés sur votre site. En cela les champs ne seront pas disponibles aux clients pour éditier.

Dans le système TeamWox fonctionne le rattachement automatique des dialogues aux organisations par l'adresse du courrier électronique.

digital_signature = [ les concaténations MD5 des champs affichés et du mot-clé]

Pour rendre possible le remplissage des valeurs des données de l'utilisateur (nom, numéro de téléphone, nom de la compagnie etc) à partir de l'information stockée sur votre site, il faut ajouter les paramètres de la signature numérique (digital_signature) dans le fichier "support.html". Dans la valeur du paramètre "digital_signature" il faut spécifier la cache MD5 de la concaténation des valeurs des champs utilisées (name, company, phone etc) et du mot clé. Ce mot clé sera aussi spécifié dans les paramètres du module "Chat". Il y aura par la suite la vérification de la signature numérique par le système TeamWox et, en cas du succès, les champs pour les utilisateurs seront automatiquement remplis et fermés pour l'édition.

Pour ce moment cette technologie est en développement. Pour l'activation du remplacement des données il est suffisant d'assigner une valeur au paramètre "digital_signature".

groupe = [NOM DU GROUPE DE LA CONSULTATION EN LIGNE]

Ce paramètre est destiné au choix du groupe du service qui sera sélectionné par défaut dans la fenêtre de l'entrée au chat. Si le nom du groupe du service comprend deux mots, au lieu de l'espace entre les mots il est nécessaire d'indiquer "%20", par exemple: "20support% technique".

topic=[LE NOM COMPLET OU PARTIEL DU SUJET]

Dans chaque groupe peuvent être créés les sujets prédéfinis de la discussion. Ce paramètre est destiné pour sélectionner le sujet par défaut dans la fenêtre de l'entrée au chat. Au titre de la valeur de ce champ peut être indiqué seulement la partie du nom du sujet. Le système va rechercher automatiquement un mot indiqué ou l'expression parmi les sujets créés et choisira celle qui convient.

cache=[PERMETTRE DE FAIRE LA CACHE DES DONNEES]

Par défaut, les données spécifiés par l'utilisateur à l'entrée au "Chat", sont cachées. Pour désactiver la cache, il faut spécifier "cache" avec la valeur "false".

language = [LANGUAGE]

On choisit par défaut la langue indiquée dans le système. Pour le remplacement forcé de la langue dans ce paramètre il est nécessaire d'indiquer l'une des valeurs suivantes:

  • ru — pour la langue russe;
  • en — pour la langue anglaise;
  • cn — pour la langue chinoise;
  • tr — pour la langue turque;
  • ar — pour la langue arabe;
  • es — pour la langue espagnole;
  • it — pour la langue italienne;
  • fr — pour la langue française;
  • de — pour la langue allemande;
  • tat — pour la langue tatare;
  • az — pour la langue azerbaïdjanaise.

close=[NOM DE LA FONCTION JAVASCRIPT, QUI FERME LA FENETRE]

Ce paramètre ferme automatiquement la fenêtre du chat lorsque vous cliquez sur le bouton "Terminer".

filter=[MOT- CLE]

Ce paramètre permet de filtrer seulement les groupes nécessaires du service selon les mots-clés y indiqués. Ainsi, en appelant la fenêtre du chat de divers sites, on peut faire disponible seulement les groupes définis du service. Vous pouvez examiner à titre d'exemple la page du site anglophone, où il n'y a pas de nécessité du groupe russe. Si vous spécifiez "english" dans ce paramètre et aux réglages du groupe du service, les clients pourront voir seulement ce groupe. Vous pouvez spécifier seulement une valeur dans le paramètre "filter" du fichier HTML utilisé sur le site, pendant que dans les réglages du groupe peuvent être spécifiées quelques valeurs à la fois. Ainsi, vous pouvez recevoir les messages de différents sites dans un groupe.

Examinerons l'exemple, quand il y a deux sites consacrés aux divers produits, mais le groupe qui s'occupe de leur soutien est unique. Dans ce cas spécifions le mot-clé "product1" au fichier HTML du premier site:

<param name="flashvars" value="filter=product1&url=https://team.yourdomain.com" />

Les mêmes paramètres sont spécifiés pour la balise "embed". Spécifions le mot-clé "product2" au fichier HTML du deuxième site:

<param name="flashvars" value="filter=product2&url=https://team.yourdomain.com" />

La même valeur est spécifiée dans la balise "embed". Dans les réglages du groupe du service au champ "Mots- clés" il faut indiquer les deux paramètres par la virgule: product1, product2:

Groupe général

Maintenant les demandes des deux sites entreront à un groupe du service.

Maintenant nous considérons un autre exemple, quand il est nécessaire de limiter l'accessibilité de différents groupes du service aux sites divers. Il existe trois versions en différentes langues: anglais, russe et chinois. Pour la version anglophone et russe il y a un groupe séparé "Support (en/ru)", pour la version chinoise - "Support (cn)". Nous indiquons le mot clé "en" dans la version anglaise au fichier HTML:

<param name="flashvars" value="filter=en&url=https://team.yourdomain.com" />

Pour les versions chinoises et russes indiquons "cn" et "ru" respectivement:

<param name="flashvars" value="filter=cn&url=https://team.yourdomain.com" />
<param name="flashvars" value="filter=ru&url=https://team.yourdomain.com" />

Après cela dans les réglages du groupe "Support (en/ru)" indiquons les mots clés "en" et "ru" par la virgule, et pour le groupe "Support (cn)" indiquons seulement "cn".

Un groupe pour le site anglaise et russe

Un groupe pour le site chinois

Dans ce cas seulement les groupes du service correspondants seront disponibles aux clients sur les sites.

Chaque paramètre doit être séparé par le signe &.

Un exemple de la spécification correcte des paramètres est donné ci-dessous:

<param name="flashvars" value="name=Name&style_head=chatlogo.gif&url=https://team.yourdomain.com" />

Cependant, vous devriez spécifier les valeurs qui sont ramassées sur votre site (les données spécifiées par les clients quand ils s'inscrivent sur votre site Internet).

Entrée automatique au chat

Probablement les situations, quand un utilisateur devrait être autorisé dans le chat (réaliser son entrée) sans montrer la fenêtre de l'entrée pour spécifier des détails personnels. Par exemple, si un utilisateur s'adresse au chat de son compte personnel sur le site (étant un utilisateur autorisé), alors toute l'information nécessaire qui lui concerne (nom, e-mail, téléphone, etc) est connue.

La différence principale technique d'une telle entrée au chat c'est l'absence de la demande des réglages du serveur TeamWox: on ne demande pas les groupes du service, les sujets là-bas, ainsi que les réglages du module (les champs affichés dans la fenêtre de l'entrée).

Pour l'entrée automatique au chat il faut que toutes les données sur l'utilisateur soient remplies (nom, téléphone, e-mail, etc.) Aussi la condition nécessaire c'est la présence du paramètre group_id, décrit plus bas.

Pour l'entrée automatique au chat sont prévus les paramètres suivants spéciaux:

group_id=[IDENTIFICATEUR DU GROUPE DU SERVICE]

Il est nécessaire de spécifier l'identificateur du groupe du service comme la valeur du paramètre donné. Il est affiché dans le titre de la fenêtre Editer les réglages du groupe (est spécifié entre les parenthèses après le symbole #). Seulement un identificateur peut être spécifié.

topic = [NOM COMPLET DU SUJET]

A l'autorisation automatique la stratégie de ce paramètre se diffère de l'autorisation par la fenêtre de l'entrée. Dans ce cas-là la valeur entière du paramètre sera attribuée au sujet du dialogue du chat. Par exemple, dans le cas si l'appel est fait du chat du cabinet personnel d'un utilisateur, vous pouvez spécifier topic=Question%20du%20profil%20de l'utilisateur.

config=[MASQUE DE BIT COMME UN ENTIER]

Ce paramètre est nécessaire pour l'activation/désactivation des champs supplémentaires de la forme de l'entrée:

  • E-mail — 8
  • Facture — 4
  • Compagnie — 2
  • Téléphone — 1

Par défaut, ces champs sont désactivés et leur taux de l'occupation ne sera pas vérifié pendant l'entrée au chat. Pour ajouter ces champs dans le paramètre "config" il faut spécifier la somme de leurs valeurs. Par exemple, pour afficher les champs "Compagnie" et "Facture" il faut spécifier 6 (4 + 2) dans la valeur du paramètre.

autologin=[PERMISSION DE L'AUTORISATION AUTOMATIQUE]

Pour activer la possibilité de l'autorisation automatique, il faut spécifier le paramètre "autologin" avec la valeur "true". Si ce paramètre n'est pas spécifié, ou sa valeur est "false", l'autorisation automatique est impossible.

Réglages de l'apparence

Paramètres des champs d'entrée:

  • style_input_out_border_color=[COULEUR DES FRONTIÈRES DES CHAMPS DANS L'ÉTAT NORMAL]
  • style_input_over_border_color=[COULEUR DES FRONTIÈRES DES CHAMPS QUAND ON PASSE LA SOURIS]
  • style_input_press_border_color=[COULEUR DES FRONTIÈRES DES CHAMPS AU CLIC PAR LA SOURIS]
  • style_input_error_background_color=[COULEUR DU FOND DES CHAMPS A L'ENTREE DE LA VALEUR INCORRECTE]

Paramètres des boutons:

  • style_button_out_first_color=[COULEUR DE LA PARTIE SUPÉRIEURE DU BOUTON DANS L'ÉTAT NORMAL]
  • style_button_out_second_color=[COULEUR DE LA PARTIE INFÉRIEURE DU BOUTON DANS L'ÉTAT NORMAL]
  • style_button_out_border_color=[COULEUR DE LA FRONTIÈRE DU BOUTON DANS L'ÉTAT NORMAL]
  • style_button_over_first_color=[COULEUR DE LA PARTIE SUPÉRIEURE DU BOUTON QUAND ON PASSEE LA SOURIS]
  • style_button_over_second_color=[COULEUR DE LA PARTIE INFÉRIEURE DU BOUTON QUAND ON PASSE LA SOURIS]
  • style_button_over_border_color=[COULEUR DE LA FRONTIÈRE DU BOUTON QUAND ON PASSE LA SOURIS]
  • style_button_press_first_color=[COULEUR DE LA PARTIE SUPÉRIEURE DU BOUTON AU CLIC]
  • style_button_press_second_color=[COULEUR DE LA PARTIE INFÉRIEURE DU BOUTON AU CLIC]
  • style_button_press_border_color=[COULEUR DE LA FRONTIÈRE DU BOUTON AU CLIC]

Paramètres du logotype sur la page de l'entrée:

  • style_head=[VOIE VERS LE FICHIER DE LA REPRÉSENTATION DU LOGOTYPE]
  • style_head_x=[ALINÉA DU LOGOTYPE D'UNE FRONTIÈRE GAUCHE DE LA FENÊTRE EN PIXELS]
  • style_head_y=[ALINÉA DU LOGOTYPE D'UNE FRONTIÈRE SUPÉRIEURE DE LA FENÊTRE EN PIXELS]

Les formats suivants des fichiers des logotypes peuvent être utilisés : *.jpg, *.gif, *.png, *.swf. Si ces exigences ne seront pas respectées, un logotype standard TeamWox sera affiché.

Paramètres du logotype sur la page de dialogue:

  • style_logo=[VOIE VERS LE FICHIER DE LA REPRÉSENTATION DU LOGOTYPE]
  • style_logo_x=[ALINÉA DU LOGOTYPE D'UNE FRONTIÈRE GAUCHE DE LA FENÊTRE EN PIXELS]
  • style_logo_y=[ALINÉA DU LOGOTYPE D'UNE FRONTIÈRE SUPÉRIEURE DE LA FENÊTRE EN PIXELS]

Les formats suivants des fichiers des logotypes peuvent être utilisés : *.jpg, *.gif, *.png, *.swf. Si ces exigences ne seront pas respectées, un logotype standard TeamWox sera affiché.

Paramètres de la fenêtre de l'estimation et la sortie

  • style_form_background_color=[COULEUR DE FOND DE LA FENETRE]
  • style_form_head_color=[COULEUR DE LA TETE DE LA FENÊTRE]
  • style_form_head_text_color=[COULEUR DU TITRE DE LA FENÊTRE]
  • style_form_title=[TEXTE DU TITRE DE LA FENÊTRE]

D'autres paramètres:

  • style_scroll_icon_color=[COULEUR DU TRIANGLE SUR LE BOUTON DE L'OUVERTURE DE LA LISTE DÉROULANTE]
  • style_line_select_color=[COULEUR DE LA LIGNE SELECTIONNEE DANS LA LISTE DÉROULANTE]
  • style_frame=[MONTRER/CACHER LE CADRE INTÉRIEUR DE LA FENÊTRE]
    Sont possibles les valeurs "true" ou "false" pour montrer ou cacher le cadre respectivement.

Toutes les couleurs doivent être spécifiées au format hexadécimal par exemple "#000000".

Appel de la fenêtre de chat

Pour commencer le travail il faut appeler cette page HTML dans une fenêtre séparée, en utilisant la structure suivante:

<a href="javascript:void(0)" onclick="window.open('support.html','support','toolbar=no,resizable=yes,
status=no,menubar=no,location=no,width=600,height=500');">Online Assistance</a>

Fenêtre de l'entrée

Avant de commencer un dialogue le client doit remplir la forme suivante:

Forme

  • Nom — le nom du client.
  • E-mail — l'adresse du courrier électronique du client.
  • Téléphone - le numéro de téléphone du client.
  • Compagnie - le nom de la compagnie du client.
  • Compte -le numéro du compte du client.
  • Groupe - le choix du nom du groupe du service auparavant créé dans le module "Chat". Pour sélectionner un groupe il faut appuyer sur le bouton gauche de la souris dans ce champ et spécifier un groupe nécessaire dans la liste apparue.
  • Sujet — le choix d'un sujet du dialogue de la liste qui s'ouvre en appuyant par le bouton gauche de la souris sur ce champ. Les sujets des dialogues doivent être créés d'avance dans le groupe.

Pour commencer un dialogue il est nécessaire d'appuyer sur le bouton "Commencer" disposé au-dessous de la forme.

Fenêtre du dialogue

Voici l'exemple de la fenêtre du dialogue de client:

Fenêtre du dialogue

La partie supérieure de la fenêtre contient le dialogue lui-même, la partie inférieure est destinée pour écrire des messages. Pour envoyer un message il faut appuyer sur le bouton "Envoyer" ou sur le raccourci clavier "Ctrl + Enter".

Cette fenêtre contient aussi les commandes suivantes:

  • A l'aide du bouton "Terminer", vous pouvez terminer le dialogue, la fenêtre du dialogue sera fermée. Quand le client a appuyé ce bouton dans la fenêtre du dialogue d'un employé apparaît un enregistrement que le client a fermé le dialogue.
  • A l'aide du bouton Son vous pouvez activer/désactiver le son de la notification que les nouveaux messages sont reçus.
  • Le bouton "Copier au tampon de l'échange" est destinée au copiage du texte du dialogue dans le presse-papiers pour l'utilisation ultérieure.

Estimation du dialogue

Dans la partie supérieure du dialogue le client peut estimer l'aide fournie par les employés de la compagnie par le chat. La fenêtre suivante est ouverte si vous appuyez sur les étoiles:

Estimation du dialogue

Pour estimer le dialogue, il faut appuyer par le bouton gauche de la souris à la première étoile et déplacez le curseur à l'une des étoiles suivantes en tenant le bouton. L'estimation est faite selon l'échelle de 1 jusqu'à 5, s'il y a plus d'étoiles tant mieux est estimé le dialogue. Les estimations sont affichées dans la liste des dialogues dans une colonne séparée. Les rapports sur les estimations des dialogues sont aussi disponibles dans le module.