Öffentliche Komponente

Ein Teil des Moduls "Chat" ist die öffentliche Komponente, die eine Verbindung zu externen Webseiten ermöglicht. Nach Installation der öffentlichen Komponente können Benutzer der Webseite mit Benutzern des TeamWox-Systems durch Chat kommunizieren.

Um das Modul "Chat" zu initialisieren, muss man auf der externen Webseite die Datei "support.html" mit dem folgenden Inhalt hinzufügen:

In selben Verzeichnis muss sich auch die Datei "support.swf" befinden. Download support.swf and support.html

Innerhalb der Attribute "Value" des Tag <param> und "Flashvars" im Tag <embed> kann man verschiedene Parameter des Chat-Fensters angeben:

• Information über Kunde: name, email, telefon, unternehmen, account
• digital_signature
• group
• topic
• cache
• language
• close
• filter
• group_id
• topic (für Autologin)
• config
• autologin
• verschiedene Outfit Parameter

Allgemeine Einstellungen

Information über den Kunden

Für die Information über den Kunden sind folgende Parameter einzugeben:

• name=[Name des Kunden]
• email=[Email des Kunden]
• phone=[Telephon des Kunden]
• company=[Unternehmen des Kunden]
• account=[Nummer des Accounts des Kunden]

Diese Parameter stellen die vorbestimmten Werte der Felder für Kunden dar. Namen, Emailadressen, Telefone und Namen des Unternehmens können automatisch aus den Informationen der in Ihrer Seite registrierten Kunden übernommen werden. Dabei werden diese Felder den Kunden für die Bearbeitung unzugänglich.

digital_signature=[MD5 der Verknüpfung der dargestellten Felder mit einem Schlüsselwort]

Damit der Austausch der Daten des Benutzer mit den auf der Webseite vorhandenen Informationen möglich ist (Name, Telefon, Name des Unternehmens usw.), müssen Sie der Datei "support.html" die Parameter der digitalen Signatur hinzufügen (digital_signature). Im Wert des Parameters "digital_signature" muss man mit hash MD5 die Verknüpfung der Werte der dargestellten Felder (name, company, phone usw.) und des Schlüsselwortes angeben. Dieses Schlüsselwort wird auch in den Einstellungen des Moduls "Chat" angegeben. Im folgenden wird die Prüfung der digitalen Signatur vom TeamWox-System durchgeführt, im Erfolgsfall werden die Felder für Benutzer automatisch ausgefüllt und für die Bearbeitung geschlossen.

group=[Name der Gruppe der Online Beratung]

Dieser Parameter ist für die Auswahl der Gruppe bestimmt, die standardmäßig im Chat-Fenster gewählt wird. Wenn die Benennung der Gruppe aus zwei Wörtern besteht, muss man statt eines Leerzeichens zwischen den Wörtern "%20" eingeben, z.B.: "technical%20support".

topic=[GANZE ODER TEILBENENNUNG DES THEMAS]

In jeder Gruppe können vorbestimmte Themen für Diskussion erstellt werden. Dieser Parameter ist für die Auswahl des Standard-Themas im Chat-Fenster bestimmt. Als Wert dieses Feldes kann auch nur ein Teil Themen-Namens angegeben werden. Das System wird die Suche des angegebenen Wortes oder der Phrase unter den erstellten Themen durchführen und das passende verwenden.

cache=[ERLAUBEN VON CACHE DER DATEN]

Im Standard werden die Daten, die vom Benutzer beim Eingang in "Chat" eingegeben wurden, gecacht. Um Cache abzuschalten, muss man  "cache" mit dem Wert "false" angeben.

language=[SPRACHE]

Im Standard wird die vom System verwendete Sprache gewählt. Um diese zu ändern, müssen Sie in diesem Parameter einen der folgenden Werte angeben:

• ru —für Russisch;
• en — für Englisch;
• cn — für Chinesisch;
• tr — für Türkisch;
• ar — für Arabisch;
• es — für Spanisch;
• it — für Italienisch;
• fr — für Französisch;
• de — für Deutsch;
• tat — für Tatarisch;
• az — für Aserbaidschanisch.

close=[Benennung der Funktion JAVASCRIPT, die das Fenster schließt]

Dieser Parameter schließt bei Klick auf die Schaltfläche "Beenden" automatisch das Chatfenster.

filter=[Schlüsselwort]

Dieser Parameter ermöglicht das Filtern von Gruppen nach den darin angegebenen Schlüsselwörtern. So kann man beim Aufruf des Chatfensters von verschiedenen Seiten nur bestimmte BGruppen zugänglich machen. Beispiel: Auf der englischen Seite gibt es keine Notwendigkeit für eine russischsprachige Gruppe. Bei Angabe "english" in diesem Parameter und in den Einstellungen der Gruppe wird für Kunden nur diese zugänglich. Im Parameter "filter" der HTML-Datei die für die Seite verwendet wird, kann man nur einen Wert angeben, wobei in den Einstellungen für die Gruppe mehrere Werte angegeben werden können. Auf diese Weise kann man in einer Gruppe Meldungen von verschiedenen Seiten erhalten.

Beispiel: Gibt es zwei Seiten, die für verschiedene Produkte erstellt wurden, aber nur eine Unterstützungsgruppe haben, geben Sie in der HTML-Datei der ersten Seite das Schlüsselwort  "product1" an:

Dieselben Parameter werden im Tag  "embed" angegeben. In der HTML-Datei der zweiten Seite geben Sie das Schlüsselwort  "product2" an:

Derselbe Wert wird im Tag "embed" angegeben. In den Einstellungen der Gruppe werden in "Schlüsselwörter" die zwei Parameter durch Komma getrennt angegeben: product1, product2:

Nun kommen die Anfragen von zwei Seiten zu einer Gruppe.

Noch ein Beispiel: Sie wollen den Zugang unterschiedlicher Gruppen zu verschiedenen Seiten einschränken. Es gibt drei Versionen der Seite in verschiedenen Sprachen: Englisch, Russisch und Chinesisch. Für die englische und russische Version gibt es eine selbstständige Gruppe "Support (en/ru)", und für die  chinesische Version "Support (cn)". Für die englische Version geben Sie in der HTML-Datei "en" ein:

Für die chinesische und russische Version geben Sie "cn" und "ru" an:

Danach geben Sie in den Einstellungen der Gruppe "Support (en/ru)" die Schlüsselwörter "en" und "ru" durch Komma getrennt an, und für die Gruppe "Support (cn)" - nur "cn".

In diesem Fall werden für die Kunden auf den Seiten nur die entsprechenden  Gruppen zugänglich.

Unten wird ein Beispiel für die korrekte Angabe der Parameter dargestellt:

Automatischer Zugang zum Chat

Es ist möglich, dass sich Benutzer für den Chat autorisieren müssen (Login) und dass Sie im Chat-Fenster die Information über sich selbst nicht sehen können z.B. wenn ein Benutzer vom Personal Cabinet auf der Seite kommt (dabei ist sie/er ein autorisierter Benutzer und die komplette Information über sie/ihn (Name, Email, Telefon usw.)) ist bekannt.

Ursache ist das Fehlen der Aufforderung der Einstellungen vom TeamWox-Server: Gruppen, Themen und Einstellungen des Moduls (Felder, die im Fenster des Einganges dargestellt werden) werden nicht angefordert.

Für Login in den Chat sind folgende Parameter vorgesehen:

group_id=[IDENTIFIKATOR DER GRUPPE]

Als Wert dieses Parameters muss die ID der Gruppe angegeben werden. Diese wird neben dem Titel des Fensters Editieren der Einstellungen der Gruppe dargestellt (angegeben in Klammern nach dem Symbol #). Man kann nur einen Identifikator angeben.

topic=[VOLLSTÄNDIGER NAME DES THEMAS]

Bei der automatischen Autorisierung unterscheidet sich das Verhalten dieses Parameters von der Autorisierung durch Eingangsfenster. In diesem Fall wird der Parameterwert dem Thema des Chatdialogs zugeordnet. Bei Aufruf des Chats aus dem Personal Cabinet des Benutzers können Sie beispielsweise "topic=Frage%20aus%20Profil%20" eingeben.

config=[BITMASKE ALS EINE GANZZAHL]

Dieser Parameter ist für Ein-bzw.Ausschaltung der zusätzlichen Felder des Zugangsfensters bestimmt :

• E-mail — 8
• Rechnung — 4
• Gesellschaft — 2
• Telefon — 1

Standardmäßig sind diese Felder ausgeschaltet und ihr Ausfüllen wird beim Eingang in den Chat nicht geprüft. Zum Hinzufügen dieser Felder müssen Sie im Wert des Parameters "config" die Summe ihrer Werte angeben, z.B. für die Darstellung der Felder "Gesellschaft" und "Rechnung" muss man im Wert des Parameters 6 (4 + 2) angeben.

autologin=[ERLAUBNIS ZUR AUTOMATISCHEN AUTORISIERUNG]

Um die Möglichkeit der automatischen Autorisierung einzuschalten, muss man den Parameter "autologin" mit dem Wert "true" angeben. Wenn dieser Parameter nicht angegeben wird oder sein Wert  "false" ist, ist die automatische Autorisierung unmöglich.

Outfit Einstellungen

Parameter der Eingabefelder:

• style_input_out_border_color=[FARBE DER FELDERGRENZEN IM NORMALEN ZUSTAND]
• style_input_over_border_color=[FARBE DER FELDERGRENZEN BEIM STELLEN DES MAUSZEIGERS]
• style_input_press_border_color=[FARBE DER FELDERGRENZEN BEIM KLICKEN MIT DER MAUS]
• style_input_error_background_color=[HINTERGRUNDFARBE DER FELDER BEI ANGABE EINES NICHT KORREKTES WERTES]

Parameter der Tasten:

• style_button_out_first_color=[FARBE DES OBEREN TEILS DER TASTE IM NORMALEN ZUSTAND ]
• style_button_out_second_color=[FARBE DES UNTEREN TEILS DER TASTE IM NORMALEN ZUSTAND]
• style_button_out_border_color=[FARBE DER TASTENGRENZE IM NORMALEN ZUSTAND]
• style_button_over_first_color=[FARBE DES OBEREN TEILS DER TASTE BEIM STELLEN DES MAUSZEIGERS]
• style_button_over_second_color=[FARBE DES UNTEREN TEILS DER TASTE BEIM STELLEN DES MAUSZEIGERS]
• style_button_over_border_color=[FARBE DER TASTENGRENZE BEIM STELLEN DES MAUSZEIGERS]
• style_button_press_first_color=[FARBE DES OBEREN TEILS DER TASTE BEIM DRÜCKEN]
• style_button_press_second_color=[FARBE DES UNTEREN TEILS DER TASTE BEIM DRÜCKEN]
• style_button_press_border_color=[FARBE DER TASTENGRENZE BEIM DRÜCKEN]

Parameter des Logos auf der Eingangsseite:

• style_head=[PFAD ZUR DATEI DES LOGOBILDES]
• style_head_x=[EINRÜCKUNG DES LOGOS VON DER LINKEN GRENZE DES FENSTERS IN PIXEL]
• style_head_y=[EINRÜCKUNG DES LOGOS VON DER OBEREN GRENZE DES FENSTERS IN PIXEL]

Parameter des Logos auf der Dialogseite:

• style_logo=[PFAD ZUR DATEI DES LOGOBILDES]
• style_logo_x=[EINRÜCKUNG DES LOGOS VON DER LINKEN GRENZE DES FENSTERS IN PIXEL]
• style_logo_y=[EINRÜCKUNG DES LOGOS VON DER OBEREN GRENZE DES FENSTERS IN PIXEL]

Parameter des Fensters der Einschätzung und des Ausgangs

• style_form_background_color=[HINTERGRUNDFARBE DES FENSTERS]
• style_form_head_color=[FARBE DES FENSTERKOPFES]
• style_form_head_text_color=[FARBE DES FENSTERTITELS]
• style_form_title=[TEXT DES FENSTERTITELS]

Andere Parameter:

• style_scroll_icon_color=[FARBE DES DREIECKS AUF DER TASTE DER ÖFFNUNG DER AUFKLAPPLISTE]
• style_line_select_color=[FARBE DER GEWÄHLTEN ZEILE IN DER AUFKLAPPLISTE]
• style_frame=[ZEIGEN/VERDECKEN INTERNE FENSTERGRENZE]
  Es sind die Werte "true" oder "false" für Zeigen oder Verdecken der Grenze möglich.

Aufruf des Chatfensters

Um den Chat zu beginnen, müssen Sie diese HTML-Seite in einem selbstständigen Fenster aufrufen. Hierzu dient der folgende Abschnitt:

Login Fenster

Vor dem Beginn des Dialogs muß der Kunde folgendes Formular ausfüllen :

• Name — Name
• Email — Emailadresse
• Telefon — Telefonnummer
• Gesellschaft — Name des Unternehmens.
• Konto — Kontonummer
• Gruppe — Auswahl des Namens einer Gruppe, die vorläufig im Modul  "Chat" erstellt wurde. Für die Auswahl der Gruppe muss man mit der linken Maustaste in das Feld klicken und in der sich öffnenden Liste die gewünschte Gruppe anklicken.
• Thema — Auswahl des Dialogthemas. Für die Auswahl eines Themas müssen Sie mit der linken Maustaste in das Feld klicken und in der sich öffnenden Liste das gewünschte Thema anklicken. Themen der Dialoge müssen auch vorläufig in der Gruppe erstellt werden.

Zum Start des Dialogs müssen Sie auf die Schaltfläche "Anfangen" im Fenster unten rechts klicken.

Dialogfenster

Das Dialogfenster des Kunden sieht so aus:

Im oberen Teil des Fensters finden Sie die Informationen über den Dialog, im unteren Teil ein Feld zur Texteingabe. Um eine Nachricht zu senden, müssen Sie die Schaltfläche "Senden" anklicken oder die Tastenkombination "Ctrl+Enter" drücken.

Im Chat-Fenster finden Sie auch folgende 'Verwaltungselemente':

• Mit Klick auf die Schaltfläche "vollständig" können Sie einen Dialog beenden und das Dialogfenster schließen. Wenn ein Kunde den Dialog beendet, erscheint im Dialogfenster des Mitarbeiters der Hinweis, dass der Kunde den Dialog geschlossen hat.
• Durch Klick auf das Symbol kann man den Sound bei Eingang einer neuen Meldungen ein-bzw.ausschalten.
• Mit Klick auf die Schaltfläche "In die Zwischenablage kopieren" wird der Text in die Zwischenablage kopiert, von wo aus sie diesen an anderer Stelle einfügen können.

Bewertung des Dialogs

Im oberen Teil des Dialogfensters kann der Kunde für die Hilfe, die ein Mitarbeiter des Unternehmens während des Chat geleistet hat, eine Note geben. Beim Anklicken des Sternchens wird das folgende Fenster geöffnet:

Für die Bewertung des Dialogs klicken Sie mit der linken Maustaste auf das erste Sternchen, halten die Maustaste fest und ziehen mit der Maus bis zu dem gewünschten Sternchen. Die Bewertung wird nach einer Skala von 1 bis 5 vorgenommen, fünf Sternchen sind die Bestnote. Die Bewertung wird in der Liste der Dialoge in der einzelnen Spalte dargestellt. Im Modul sind auch Berichte über Noten der Dialoge zugänglich.