Was du konfigurieren kannst
- Erscheinungsbild des Widgets
- Willkommensnachricht
- Sprache
- KI-Agent
- Eskalationsverhalten
- kanalspezifische Einstellungen
Empfohlene Einrichtung
1
Web-Kanal erstellen
Geh zu Kanäle -> Web-Widget und erstelle ein neues Widget.
2
Widget anpassen
Passe Farben, Texte und Begrüßung an deine Marke an.
3
KI-Agenten wählen
Wähle den KI-Agenten, der Antworten für Widget-Tickets entwerfen oder senden soll.
4
Übergabe konfigurieren
Lege fest, wann Besucher an einen menschlichen Agenten übergeben werden.
5
Widget installieren
Füge das bereitgestellte Script auf deiner Website ein und teste eine Konversation.
Besucher mit Kontaktdaten deiner Website erkennen
Zeige deinem Support-Team die Kontaktdaten, die deine Website bereits kennt, zum Beispiel Name und E-Mail eines angemeldeten Kunden. Übergib dafür einuser-Objekt beim ersten Aufruf von window.cx_armin.init().
Ersetze dein bisheriges Widget-Installationssnippet durch das folgende Beispiel vor dem schließenden </body>-Tag. Ersetze YOUR_WIDGET_ID durch die ID aus deinem Widget-Installationssnippet und die Beispieldaten durch die Besucherdaten deiner Website. Lass unbekannte Angaben weg. Für anonyme Besucher kannst du user ganz weglassen.
init() aufrufst. Füge kein zweites Installationssnippet hinzu. Verlass dich nicht darauf, den Besucher nach dem Laden des Widgets durch einen erneuten init()-Aufruf zu aktualisieren.
Unterstützte Angaben und Speicherung
Alle drei Eigenschaften sind optionale Strings. Sie werden mit der Chat-Nachricht des Besuchers gesendet. Das Laden oder Öffnen des Widgets allein speichert sie nicht.
Chatarmin CX sucht zuerst den Kontakt, der zur Browser-Sitzung des Widgets in deinem Workspace gehört. Gibt es keinen, wird ein Kontakt erstellt oder ein bestehender Kontakt mit passender E-Mail im selben Workspace wiederverwendet. Eine E-Mail ist keine bestätigte Identität. Bereits gefüllte Werte für E-Mail, Vorname und Firma werden nicht überschrieben. Dies ist keine allgemeine API zum Aktualisieren von Kontakten.
Das Live-Widget unterstützt in
user nur email, name und company. Telefonnummern, Tags und beliebige benutzerdefinierte Kontaktfelder kannst du damit nicht setzen. Nutze für diese Einbindung init({ widgetId, user }), keinen separaten identify()-Aufruf.
Einrichtung testen
Nutze ein Test-Widget und eine neue Browser-Sitzung mit fiktiven Kontaktdaten. Wähle eine gültige Test-E-Mail, die noch bei keinem Kontakt in deinem Test-Workspace hinterlegt ist. Lade die Seite und sende eine Chat-Nachricht. Öffne das entstandene Ticket in Chatarmin CX und prüfe den Kontakt: Das Beispiel sollte die E-Mailalex@example.com, den Vornamen Alex, den Nachnamen Morgan und die Firma Example Shop ergeben. Das Laden oder Öffnen des Widgets allein speichert diese Angaben nicht. Bleibt ein bestehender Wert unverändert, prüfe, ob das Kontaktfeld bereits gefüllt war.
Widget-Ereignisse in Google Analytics messen
Das Widget meldet deiner Website, was Besucher im Chat tun: den Chat öffnen, eine Nachricht senden, einen Vorschlag wählen, einen Link anklicken, eine E-Mail-Adresse hinterlassen und eine Unterhaltung abschließen. So siehst du in Google Analytics 4, wie der Chat Besuchern zum Abschluss hilft. Die Ereignisse beschreiben nur Aktionen. Sie enthalten nie Nachrichtentexte, E-Mail-Adressen oder Telefonnummern, und Chatarmin CX selbst sendet nichts an Google.Ereignisse an den Google Tag Manager senden
Ergänzeanalytics: { dataLayer: true } im cx_armin.init()-Aufruf deines Widgets. Dann schreibt das Widget jedes Ereignis in den window.dataLayer deiner Website, benannt mit cx_armin_ und dem Ereignisnamen, zum Beispiel cx_armin_message_sent. Die Details des Ereignisses stehen in cx_armin.
user oder andere Optionen übergibt, ergänze analytics im selben init()-Aufruf.
Eine gesendete Nachricht kommt so im dataLayer an:
cx_armin, damit kein Detail aus einem früheren Ereignis hängen bleibt. Im Vorschaumodus erscheint das Leeren als Nachricht ohne Ereignisnamen.
Um die Ereignisse an Google Analytics 4 zu senden, richte den Google Tag Manager ein:
1
Variablen anlegen
Öffne Variablen → Benutzerdefinierte Variablen → Neu → Datenschichtvariable.
Lege für jedes Detail, das du in Google Analytics brauchst, eine Variable an, zum Beispiel
cx_armin.source, cx_armin.kind, cx_armin.url, cx_armin.type und cx_armin.reason.2
Trigger anlegen
Öffne Trigger → Neu → Benutzerdefiniertes Ereignis. Trage
cx_armin_.* als
Ereignisnamen ein und wähle Übereinstimmung mit regulärem Ausdruck verwenden.3
Google-Analytics-Tag anlegen
Öffne Tags → Neu → Google Analytics: GA4-Ereignis. Trage deine Mess-ID ein, nutze
die integrierte Variable Event als Ereignisnamen, füge deine Variablen als Ereignisparameter
hinzu und wähle den Trigger aus dem vorigen Schritt.
4
Im Vorschaumodus testen
Klicke auf Vorschau, öffne deine Website, öffne den Chat und sende eine Nachricht. Tag
Assistant zeigt
cx_armin_open und cx_armin_message_sent mit ihren Details. Veröffentliche
danach den Container.Mit JavaScript zuhören
Rufewindow.cx_armin.on() mit einem Ereignisnamen und einer Funktion auf. Die Funktion bekommt die Details des Ereignisses. Füge deine Listener direkt nach init() in derselben onload-Funktion hinzu.
on() gibt eine Funktion zurück, die das Zuhören beendet. Das klappt nur für Listener, die du nach dem Laden des Widgets hinzufügst. Listener ohne Parameter funktionieren weiter. Ein Fehler in deinem Listener stört den Chat nicht; er erscheint trotzdem in der Konsole deines Browsers.
Widget-Ereignisse
Jedes Ereignis enthältwidgetId und ts, die Zeit in Millisekunden. Ereignisse einer Unterhaltung enthalten außerdem ticketId, sobald die Unterhaltung ein Ticket in Chatarmin CX hat.
Was die Ereignisse weglassen
- Ein Link in einer Antwort oder ein Link-Vorschlag meldet nur
kind, keineurl: Diese Links schreiben dein Team, dein KI-Agent oder du, jeder Teil der Adresse könnte also persönlich sein, etwa ein Link zum Zurücksetzen oder zu einer Einladung oder ein Name in der Domain. Bei einer Produktkarte isturldie Adresse der Produktseite ohne Query-String und Fragment. Teile ihres Pfads, die eine Person erkennbar machen könnten, etwa eine E-Mail-Adresse (auch mehrfach kodiert), eine lange Nummer oder ein Zugangstoken, stehen als:idda, ebenso jeder Teil mit 16 oder mehr Zeichen, der kein Slug aus kurzen Wörtern ist, etwa ein langes Einzelwort wielagerraumvermietung. labelwird nur bei den Start-Vorschlägen gesendet, die du eingerichtet hast. Smart-Vorschläge werden für die Seite des Besuchers erzeugt, und ein Vorschlag in einer Antwort kann von der KI stammen. Beide können Angaben aus der Seite oder dem Gespräch wiederholen, deshalb melden sie nur ihreid. Ein Label mit einem@oder einer langen Nummer fehlt immer.lead_submittedmeldet, dass eine E-Mail-Adresse angegeben wurde, nie die Adresse selbst.
Gut zu wissen
- Ereignisse werden nur ausgelöst, solange der Besucher auf deiner Seite ist. Schließt dein Team eine Unterhaltung, nachdem der Besucher gegangen ist, wird das nicht gemeldet.
- Eine im Chat getippte E-Mail zählt als Lead, wenn sie die einzige Adresse in der Nachricht ist und Chatarmin CX sie für den Kontakt übernimmt: nicht bei einer Nachricht mit mehreren Adressen (auch wenn eine davon deine Support-Adresse ist) oder einem Platzhalter wie
test@example.comund nicht, wenn der Kontakt schon vorher eine E-Mail von anderswo hatte. Auch deine eigene Support-Adresse allein zählt, damit das Widget nie verrät, welche Adressen dir gehören; sie wird nicht am Kontakt gespeichert. - Telefonnummern, die in den Chat getippt werden, erkennt das Widget nicht, weil sie sich nicht zuverlässig von Bestellnummern oder Daten unterscheiden lassen.
typeist vorerst immeremail. - Diese Ereignisse gehören zum aktuellen Web-Widget. Wenn auf deiner Website keines davon ausgelöst wird, kontaktiere den Support, damit wir prüfen, welche Widget-Version dein Workspace nutzt.