Nutzer identifizieren und Kontext übergeben

Für: Entwickler·Voraussetzung: Ein Widget·Screenshots zeigen Beispieldaten

Ein Assistent, der nicht weiß, wer fragt, beantwortet jede Frage wie die eines Fremden und kann nicht erkennen, welche Rechnung „diese hier“ ist. Das Widget übernimmt beim Start die Identität der angemeldeten Person von Ihrer Seite, und Ihre Seite kann ihm versteckten Kontext dazu geben, was die Person gerade ansieht. So gehören Chatverlauf, Erinnerungen und gespeicherte Zugangsdaten zur richtigen Person, und die Antworten passen zur Seite.

Was es bewirkt

Ihr Produkt weiß bereits, wer angemeldet ist und welcher Datensatz auf dem Bildschirm steht. Das Widget weiß es nicht, solange Ihre Seite es ihm nicht sagt. Ohne diese Angaben fragt der Assistent nach Details, die die Person vor sich sieht, und nichts, was eine Person im Chat tut, lässt sich in Ihrem CRM ihr zuordnen.

Ihre Seite übergibt Identitätsfelder im Aufruf von initStrikeUpChatWidget und Seitenkontext über window.StrikeUpChat. Damit:

• Ist jede Person ein Kunde in StrikeUp, verschlüsselt über Ihre userId, mit eigenem Verlauf, eigenen Erinnerungen und eigenen Toolkit-Zugangsdaten. Identitätsfelder.
• Werden Kunden über die übergebene Unternehmens-ID ihrem Unternehmen zugeordnet. userCompanyId und userCompanyName, das Unternehmen des Kunden.
• Weiß der Assistent, welche Seite, welchen Datensatz oder welchen Filter die Person ansieht, mit bis zu 8192 Zeichen Text. Live-Seitenkontext.
• Kann eine Schaltfläche dem Assistenten sagen, warum sie gedrückt wurde, nur für die erste Antwort. Kontext beim Öffnen.

Kontext erscheint nie im Chat. Ihr Team kann genau prüfen, was beim Assistenten ankam, unter Injizierter Kontext in den Details einer KI-Aktion.

Bevor Sie beginnen

Voraussetzung	Details
Ein in Ihr Produkt eingebautes Widget	Das Widget in Ihr Produkt einbauen
Eine dauerhafte ID für jede Ihrer Personen	Ihr eigener Datenbankschlüssel, keine E-Mail-Adresse, die sich ändern kann
Die Unternehmen Ihrer Kunden (optional)	Unter CRM › Unternehmen, jeweils mit einer Unternehmens-ID, die zur übergebenen ID passt
Tarif oder Kosten	Keine Tarifgrenze. Seitenkontext ist Text, den der Assistent in späteren Runden liest; großer oder häufig wechselnder Kontext verbraucht daher mehr KI-Tokens

Gut zu wissen

Identitätsfelder sagen dem Widget, wer die Person ist; sie beweisen es nicht. Wer ändern kann, was Ihre Seite übergibt, kann eine fremde ID angeben. Verlangen Sie für ein Widget, das mit personenbezogenen Daten arbeitet oder Ihre API mit den Zugangsdaten einer Person aufruft, zusätzlich eine Anmeldung, mit vorab angelegten Zugangsdaten oder Anmelde-Tickets aus Ihrem Backend. Siehe Anmeldung von Endkunden.

Identität und Kontext verstehen

Das Widget behandelt drei Arten von Angaben unterschiedlich.

Art	Wie Sie sie übergeben	Wer sie nutzt	Wie lange sie gilt
Identität: userId, Name, E-Mail, Unternehmen, Helpdesk-ID	initStrikeUpChatWidget({ … })	StrikeUp, um den Kunden und sein Unternehmen zu finden oder anzulegen	Angewendet beim Start eines Gesprächs; bleibt am Kundendatensatz
Kontext beim Öffnen	StrikeUpChat.open({ openContext })	Der Assistent, für seine erste Antwort	Nur die Eröffnungsrunde
Live-Seitenkontext	StrikeUpChat.context.set(…)	Der Assistent, ab der nächsten Nachricht der Person	Hängt an der nächsten Nachricht und bleibt dann im Gespräch, bis er aus dem jüngsten Verlauf des Assistenten herausfällt

Wie StrikeUp entscheidet

• Der Kunde wird über die userId gefunden. Beim Start eines Gesprächs sucht StrikeUp den Kunden, dessen Kunden-ID Ihrer userId entspricht, und legt einen an, wenn es keinen gibt.
• Name und E-Mail füllen nur leere Felder. userDisplayName und userEmail werden nur geschrieben, wenn der Kunde noch keinen Namen bzw. keine E-Mail hat. Spätere Werte überschreiben nie einen früheren Wert oder eine Änderung Ihres Teams im CRM.
• Das Unternehmen wird einmal zugeordnet. userCompanyId wird mit der Unternehmens-ID eines Kundenunternehmens abgeglichen; passt keines, wird userCompanyName mit einem Unternehmensnamen abgeglichen, ohne Rücksicht auf Groß- und Kleinschreibung und überzählige Leerzeichen; scheitert auch das, entsteht ein neues Unternehmen. Der Kunde wird ihm nur zugeordnet, wenn er noch kein Unternehmen hat.
• Eine neue userId startet das Widget neu. Ein erneuter Aufruf von initStrikeUpChatWidget mit einer anderen userId entfernt das Widget und startet es für die neue Person. Dieselbe userId ändert nichts.
• Die Sitzung entscheidet, wer der Kunde ist. Sobald ein Gespräch läuft, nutzt jede weitere Aktion den Kunden dieser Sitzung, egal was Ihre Seite danach übergibt.

Was nicht verwendet wird

• Kontext, während ein menschlicher Agent das Gespräch führt: Seitenkontext wird während einer Übergabe nicht gespeichert.
• Bereitgestellter Kontext, wenn die Person einen neuen Chat beginnt oder zu einem anderen Gespräch wechselt: Er fällt bei diesem Senden weg, und die Kopie Ihrer Seite wird beim nächsten context.set() erneut gesendet.
• IDs, die mit anon- beginnen: Sie sind für anonyme Sitzungen reserviert und werden ignoriert.

In vier Schritten einrichten

1. Die Identität beim Start des Widgets übergeben. Füllen Sie im Aufruf von initStrikeUpChatWidget auf Ihrer Seite userId mit Ihrer dauerhaften ID der angemeldeten Person und ergänzen Sie Name, E-Mail und Unternehmen:

   window.initStrikeUpChatWidget({
     applicationToken: "<your widget's application token>",
     userId: "cus_48210",
     userDisplayName: "Rosie Kendall",
     userEmail: "rosie.kendall@example.com",
     userCompanyId: "SAP-5531",
     userCompanyName: "Sample & Partners Ltd"
   });

2. Die Seite bei jedem Routenwechsel beschreiben. Sobald die Person einen Datensatz öffnet oder einen Filter ändert, rufen Sie StrikeUpChat.context.set() mit wenigen kurzen Zeilen auf: wer die Person ist, wo sie ist, Name und ID des Datensatzes.

   window.StrikeUpChat.context.set(
     "User: Rosie Kendall (cus_48210), Sample & Partners Ltd\n" +
     "Page: Invoice details (/invoices/inv_2026_0418)\n" +
     "Invoice: INV-2026-0418, status Paid, VAT 19%"
   );

3. Auslöser-Schaltflächen einen Grund mitgeben (optional). Wenn Ihre eigene Schaltfläche das Widget öffnet, ergänzen Sie einen Satz dazu, warum sie gedrückt wurde:

   window.StrikeUpChat.open({
     message: "Warum wurde auf dieser Rechnung Umsatzsteuer berechnet?",
     openContext: "Geöffnet aus der Umsatzsteuerzeile der Rechnung INV-2026-0418."
   });

4. Prüfen, was beim Assistenten ankam. Senden Sie im Widget eine Nachricht und öffnen Sie dann die KI-Aktion des Chats unter Analysen › KI-Aktionen. Der Abschnitt Injizierter Kontext listet die Kontextzeilen, die der Assistent erhalten hat.

   

   Kontext, den Ihre Seite sendet, erscheint nie im Chat; Ihr Team prüft unter Injizierter Kontext, was die KI erhalten hat.

   Was dieser Screenshot zeigt

   Ansicht

   (/admin/ai-logs/:id)

   Hervorgehoben

   heading “Injizierter Kontext”, injected-context-card, 2 entries. none (read-only)

   Außerdem sichtbar

   Execution info OpenAI, HTTP 200; User message about invoice INV-2026-0418; Injected context: Customer: Rosie Kendall (Sample & Partners Ltd, cus_48210); Locale: en-GB; Start of Knowledge Base Context

   Zweck

   verifying what page context reached the assistant

Empfohlene Einführung

Beginnen Sie nur mit der Identität und prüfen Sie, ob neue Kunden unter CRM › Kunden mit Ihren IDs und ihren Unternehmen erscheinen. Ergänzen Sie danach Seitenkontext auf Ihren zwei oder drei meistbesuchten Seiten und lesen Sie Injizierter Kontext in den Details einiger protokollierter Aktionen, bevor Sie ihn überall einführen.

Jede Einstellung erklärt

Identitätsfelder sind Optionen von initStrikeUpChatWidget; Kontext setzen Sie über window.StrikeUpChat. Die Ansicht Embed enthält einen Hinweisblock, Gib der KI verborgenen Kontext zu deiner Seite, mit Snippets für beide Arten von Kontext.

Identitätsfelder beim Start

Die sechs Identitätsfelder sind optionale Zeichenketten im Aufruf von initStrikeUpChatWidget. Sie werden angewendet, wenn ein Gespräch entsteht. Das Anmeldefeld loginTicket erklärt Anmeldung von Endkunden.

Feld	Wird zu	Regel
userId	Die Kunden-ID des Kunden	Höchstens 255 Zeichen; eine Änderung startet das Widget neu
userDisplayName	Der Name des Kunden	Nur gefüllt, wenn leer
userEmail	Die E-Mail des Kunden	Nur gefüllt, wenn leer
userCompanyId	Die Verbindung zum Kundenunternehmen mit dieser Unternehmens-ID	Nur angewendet, wenn der Kunde noch kein Unternehmen hat
userCompanyName	Der Unternehmensname zum Abgleichen oder Anlegen	Abgeglichen ohne Rücksicht auf Groß- und Kleinschreibung und überzählige Leerzeichen
handoffUserId	Die ID der Person in Ihrem Helpdesk	Verwendet, wenn ein Chat an einen Menschen übergeben wird

userId, der Schlüssel zu allem

Wo

userId in Ihrem Aufruf von initStrikeUpChatWidget. Der erzeugte Code unter Konfigurieren › Embed hat hier den Platzhalter your_customer_id.

Was

Ihre ID für die Person, als Zeichenkette mit bis zu 255 Zeichen. Sie wird zur Kunden-ID des Kunden im CRM und ist der Schlüssel für Chatverlauf, Erinnerungen, gespeicherte Toolkit-Zugangsdaten und Anmeldung. Das Widget fragt die Person nie danach. Dieselbe ID auf jedem Gerät gibt der Person überall denselben Verlauf. Bleibt der Platzhalter stehen, werden alle Besucher zu einem gemeinsamen Kunden.

Warum

Eine dauerhafte ID lässt den Assistenten eine Person wiedererkennen und für sie handeln, und Ihr Team findet ihre Chats im CRM.

Die übergebene userId wird im CRM zur Kunden-ID; userCompanyId verknüpft den Kunden mit dem Unternehmen dieser Unternehmens-ID.

Was dieser Screenshot zeigt

Ansicht

Mitglieder (/admin/customer-companies/:id)

Hervorgehoben

cell “”, members-table-first-row, Rosie Kendall, Admin, Active. none (the customer identifier from userId)

Außerdem sichtbar

Company Sample & Partners Ltd, Company ID SAP-5531; Rows cus_48210 Rosie Kendall Admin Active and cus_48284 Edward Haywood Member Disabled

Zweck

where the identity passed at init shows up for your staff

Empfohlen	Vermeiden
Ihren Datenbankschlüssel für die Person verwenden, etwa cus_48210	Eine E-Mail-Adresse verwenden, die die Person ändern kann
Auf jeder Seite und jedem Gerät dieselbe ID übergeben	Eine Sitzungs-ID übergeben, die sich bei jeder Anmeldung ändert
Sie als öffentlichen Wert behandeln	Geheimnisse oder Tokens hineinschreiben: Sie ist in der Seite sichtbar

userDisplayName und userEmail, die Angaben des Kunden

Wo

userDisplayName und userEmail in Ihrem Aufruf von initStrikeUpChatWidget.

Was

Sie füllen Name und E-Mail des Kunden im CRM, aber nur, wenn diese Felder leer sind. Wer sich in Ihrem Produkt umbenennt, behält in StrikeUp den alten Namen, bis Ihr Team ihn im CRM ändert. Der Endkunde sieht beide auf der Profilseite des Kundenportals und kann sie dort bearbeiten; die Kunden-ID ist dort schreibgeschützt.

Warum

Ihr Team erkennt Menschen am Namen, nicht an der ID. Dass nur leere Felder gefüllt werden, schützt Korrekturen Ihres Teams.

Das Widget fragt nie, wer der Nutzer ist; es verwendet userId, Name und E-Mail, die Ihre Seite übergibt.

Was dieser Screenshot zeigt

Ansicht

Profil (host page › widget › Customer Portal › Profile)

Hervorgehoben

label “Kunden-ID”, profile-form-top, value cus_48210, read-only. none

Außerdem sichtbar

Customer Portal header with Sample & Partners Ltd; Name Rosie Kendall, Email rosie.kendall@example.com, Role Admin; Portal sidebar with Log out

Zweck

showing that identity comes from the host page, not from the visitor

userCompanyId und userCompanyName, das Unternehmen des Kunden

Wo

userCompanyId und userCompanyName in Ihrem Aufruf von initStrikeUpChatWidget. Unternehmen liegen unter CRM › Unternehmen.

Was

StrikeUp sucht zuerst ein Kundenunternehmen, dessen Unternehmens-ID gleich userCompanyId ist. Gibt es keines, sucht es ein Unternehmen, dessen Name zu userCompanyName passt, ohne Rücksicht auf Groß- und Kleinschreibung, Leerzeichen am Anfang und Ende sowie doppelte Leerzeichen. Passt keines, legt es ein Unternehmen an. Der Kunde tritt diesem Unternehmen nur bei, wenn er noch keinem angehört; ein späterer Wert verschiebt ihn nie.

Unternehmen des Kunden heute	userCompanyId passt zu	Ergebnis
Keines	Der Unternehmens-ID eines Unternehmens	Tritt diesem Unternehmen bei
Keines	Nichts, aber userCompanyName passt zu einem Namen	Tritt dem Unternehmen mit diesem Namen bei
Keines	Nichts	Ein neues Unternehmen entsteht, und der Kunde tritt bei
Bereits in einem Unternehmen	Beliebig	Bleibt im bisherigen Unternehmen

Warum

Kunden desselben Unternehmens teilen im Kundenportal Wissen, Workflows und Mitglieder, und Ihr Team sieht sie im CRM zusammen.

Bei Widgets mit Anmeldung behalten selbst registrierte Kunden ihr eigenes Unternehmen

Verlangt ein Widget eine Anmeldung, wird eine Person, die ihre eigene PIN oder ihr eigenes Passwort einrichtet, in diesem Moment angelegt, mit einem eigenen Ein-Personen-Unternehmen und der Rolle Admin, noch bevor Ihre Unternehmensfelder ankommen. Weil ein Kunde mit Unternehmen nie verschoben wird, wird userCompanyId dann ignoriert. Um solche Personen zu gruppieren, importieren Sie sie vorher mit ihrem Unternehmen unter CRM › Kunden.

handoffUserId, die ID in Ihrem Helpdesk

Wo

handoffUserId in Ihrem Aufruf von initStrikeUpChatWidget. Löschen Sie die Zeile, wenn Sie Chats nicht an einen Helpdesk übergeben.

Was

Wird ein Chat an einen Menschen übergeben, identifiziert diese ID die Person in Ihrem Helpdesk: Sie ist der Kontaktschlüssel in Intercom und Teil des Kontexts, der an Help Scout geht. Ohne sie wird userId verwendet.

Warum

Ihr Supportteam sieht das Gespräch beim richtigen Kontakt, mit dessen früheren Tickets.

StrikeUpChat.context.set(), Live-Seitenkontext

Wo

Der Code Ihrer Seite, nachdem das Widget-Skript gelaufen ist: window.StrikeUpChat.context.set(value), add(value), clear() und get(). Snippets stehen unter Konfigurieren › Embed bei Gib der KI verborgenen Kontext zu deiner Seite.

Was

set() ersetzt den bereitgestellten Kontext; add() hängt ihn in einer neuen Zeile an; clear() leert ihn; get() liefert, was bereitsteht, oder null. Objekte werden in JSON umgewandelt. Die Grenze liegt bei 8192 Zeichen, gezählt als Länge der JavaScript-Zeichenkette: set() und add() liefern false, stellen nichts bereit und schreiben [StrikeUpChat] context.set rejected: N chars exceeds the 8192-char limit. in die Konsole, wenn das Ergebnis länger würde.

Länge des bereitgestellten Texts	set() liefert	Bereitgestellt
8191 Zeichen	true	Ja
8192 Zeichen	true	Ja
8193 Zeichen	false	Nein, der vorige Wert bleibt

Der bereitgestellte Kontext reist mit der nächsten Nachricht der Person und wird danach auf der Seite geleert. StrikeUp behält ihn im Gespräch als versteckten Eintrag direkt vor dieser Nachricht, und der Assistent liest ihn in dieser und den folgenden Runden, bis er aus dem jüngsten Verlauf, den der Assistent liest, herausfällt. Ein vollständiges Neuladen der Seite verwirft noch nicht gesendeten Kontext.

Warum

„Stimmt diese Rechnung?“ braucht keine Rückfrage, wenn der Assistent schon weiß, welche Rechnung offen ist.

Empfohlen	Vermeiden
Ein Fakt pro Zeile, Bezeichnung zuerst: Invoice: INV-2026-0418 (id inv_2026_0418)	Ein Absatz Fließtext
set() bei jedem Routenwechsel und bei jeder Änderung von Datensatz oder Filter aufrufen	Die Zeilen der vorigen Seite stehen lassen
Während eine Seite lädt, nur Sicheres senden	„Details werden noch geladen“, was dann im Gespräch steht
Zähler, Zeitstempel, Seitenzahlen und Sortierung weglassen	Werte, die sich von selbst ändern: Jeder geänderte Wert wird erneut gespeichert und in jeder späteren Runde gelesen
Query-Strings entfernen und leere Werte weglassen	Tokens oder E-Mail-Adressen aus der URL

open(options), openContext, Kontext beim Öffnen

Wo

Die Option openContext von window.StrikeUpChat.open(), meist an Ihrer eigenen Auslöser-Schaltfläche. Die Ansicht Embed erzeugt sie in Custom Trigger Button Snippets.

Was

Ein versteckter Text nur für die Eröffnungsrunde des Assistenten. Er wird nicht angezeigt und nicht als Nachricht behalten. StrikeUp kürzt ihn auf 8192 Zeichen und hängt „[…truncated]“ an. Er erreicht den Chat auch dann, wenn die Schaltfläche benutzt wird, bevor der Chat fertig geladen ist. Der ältere Name developerContext funktioniert weiter und schreibt [StrikeUpChat] open({ developerContext }) is deprecated — use open({ openContext }). in die Konsole.

Warum

Eine Schaltfläche weiß, warum sie gedrückt wurde. Ein Satz wie „Geöffnet aus der Umsatzsteuerzeile der Rechnung INV-2026-0418“ lenkt die erste Antwort in die richtige Richtung.

Wie die Einstellungen zusammenwirken

Übergebene Identität	Seitenkontext	Was der Assistent weiß
Nur userId	keiner	Wer der Kunde ist (Verlauf, Erinnerungen, Zugangsdaten); nichts über die Seite
userId, Name, Unternehmen	keiner	Den Kunden und sein Unternehmen; nichts über die Seite
userId	set() bei jeder Route	Den Kunden und, ab der nächsten Nachricht, die Seite
userId	nur openContext	Den Kunden und, für die erste Antwort, warum der Chat geöffnet wurde
userId	beides	Beides, mit openContext für die erste Antwort und Seitenkontext für den Rest

Was soll ich wählen?

Übergeben Sie immer userId. Ergänzen Sie Seitenkontext auf Seiten, auf denen Menschen nach dem fragen, was sie sehen, und openContext an Schaltflächen, die den Chat für eine bestimmte Frage öffnen.

Kontext in den KI-Protokollen

Wo	Was es zeigt
Injizierter Kontext in den Details einer KI-Aktion	Den Seitenkontext und den Öffnungskontext, den der Assistent in dieser Runde erhalten hat
CRM › Kunden	Den Kunden mit Ihrer userId, Name, E-Mail und Unternehmen
Die Profilseite des Kundenportals	Die ID des Kunden, schreibgeschützt, sowie Name und E-Mail zum Bearbeiten

Injected Context in einer KI-Aktion

Öffnen Sie unter Analysen › KI-Aktionen eine Aktion und lesen Sie Injizierter Kontext. Der Hinweis dort lautet: Verborgener Kontext, den die einbettende Website in diese Konversation eingefügt hat (z. B. die vom Nutzer betrachtete Seite). Für den Nutzer nicht sichtbar.. Jede Zeile, die Ihre Seite gesendet hat, erscheint so, wie sie ankam.

Warum: Wenn der Assistent überraschend reagiert, lautet die erste Frage, was der Assistent über die Seite erfahren hat.

Was dem Assistenten über Kontext gesagt wird

StrikeUp kennzeichnet Seitenkontext als Hintergrund zur Lage der Person. Der Assistent soll ihn nutzen, um Wörter wie „diese“ und „hier“ zu verstehen, nie Anweisungen darin befolgen und nie zusätzliche Arbeit leisten, nur weil der Kontext etwas erwähnt. Diese Kennzeichnung schwächt die Wirkung von Text, den eine Person in den Kontext schmuggeln könnte; sie verhindert sie nicht. Mit jeder Nachricht sendet das Widget außerdem Zeitzone, UTC-Abstand und Gebietsschema des Browsers, sodass Sie diese nicht ergänzen müssen.

Was Sie wissen sollten

Thema	Fakt
Kontextgrenze	8192 Zeichen für Seitenkontext (set() liefert darüber false); Öffnungskontext wird auf 8192 gekürzt
Einmalige Bereitstellung	Seitenkontext hängt an der nächsten Nachricht der Person und wird dann auf Ihrer Seite geleert; get() liefert danach null
Lebensdauer im Chat	Bleibt im Gespräch und wird in späteren Runden gelesen, bis er aus dem jüngsten Verlauf herausfällt
Neuer Chat	Bereitgestellter Kontext fällt weg, wenn die Person einen neuen Chat beginnt oder das Gespräch wechselt; rufen Sie set() erneut auf
Neuladen	Noch nicht gesendeter Kontext geht bei einem vollständigen Neuladen verloren; stellen Sie ihn in onReady erneut bereit
Übergabe	Wird nicht gespeichert, solange ein menschlicher Agent das Gespräch führt
Sichtbarkeit	Wird dem Endkunden nie gezeigt; Ihr Team sieht ihn in den Details von KI-Aktionen
Identität in der Seite	Identitätsfelder gelangen über seine Adresse in den Chat-Frame und sind daher in der Seite und in den Anfrageprotokollen des Widget-Hosts sichtbar. Schreiben Sie nie Geheimnisse hinein
Aktualisierungen	Name und E-Mail füllen nur leere Felder; das Unternehmen wird einmal gesetzt

Häufige Fragen

Allgemein

Was soll ich als userId verwenden?

Verwenden Sie Ihre eigene dauerhafte ID für die Person, etwa ihren Datenbankschlüssel, zum Beispiel cus_48210. Vermeiden Sie E-Mail-Adressen, die sich ändern können, und Sitzungs-IDs, die sich bei jeder Anmeldung ändern. Die userId ist in StrikeUp der Schlüssel für Chatverlauf, Erinnerungen, gespeicherte Toolkit-Zugangsdaten und Anmeldung des Kunden.

Kann eine besuchende Person die userId ändern, die meine Seite übergibt?

Die userId setzt Ihre Seite; wer den Code Ihrer Seite oder das Übergebene ändern kann, kann also eine andere ID angeben. Behandeln Sie sie als Bezeichnung, nicht als Identitätsnachweis. Verlangen Sie für Widgets, die mit personenbezogenen Daten arbeiten, eine Anmeldung mit vorab angelegten Zugangsdaten oder Anmelde-Tickets aus Ihrem Backend.

Hat dieselbe Person auf Telefon und Laptop denselben Verlauf?

Ja, wenn Ihre Seite auf beiden Geräten dieselbe userId übergibt. Die ID ist der Schlüssel für Chats und Erinnerungen des Kunden, daher zeigt das Widget überall, wo diese ID verwendet wird, denselben Verlauf. Bei Widgets mit Anmeldung gibt die Person in jedem neuen Browser außerdem ihre PIN oder ihr Passwort ein.

Wird die userId dem Endkunden angezeigt?

Der Endkunde sieht seine ID als schreibgeschütztes Feld auf der Profilseite des Kundenportals, zusammen mit Name und E-Mail. Sie ist außerdem Teil der Adresse des Chat-Frames in Ihrer Seite; verwenden Sie daher keine ID, die Sie für vertraulich halten.

Einrichtung

Wo füge ich die Identitätsfelder ein?

Fügen Sie sie in den Aufruf von initStrikeUpChatWidget auf Ihrer Seite ein, neben applicationToken. Der unter Konfigurieren › Embed erzeugte Code enthält bereits jedes Feld mit einem Platzhalter your_…; ersetzen Sie jeden Platzhalter durch den Wert Ihrer Person oder löschen Sie die Zeile vor der Veröffentlichung.

Wie wechsle ich ohne Neuladen der Seite zu einer anderen Person?

Rufen Sie initStrikeUpChatWidget erneut mit der userId der neuen Person auf, und mit einem frischen loginTicket, wenn Ihr Widget Anmelde-Tickets nutzt. Eine andere userId lässt das Widget sich entfernen und für die neue Person neu starten; ein Aufruf mit derselben userId ändert nichts.

Braucht das Widget die E-Mail meiner Nutzer?

Nein. userEmail ist optional und füllt nur die E-Mail des Kunden im CRM, wenn sie leer ist. Der Assistent funktioniert mit userId allein. Übergeben Sie die E-Mail, wenn Ihr Team Kunden im CRM erkennen oder kontaktieren möchte.

Identität und Unternehmen

Ich habe den Namen einer Person in meiner App geändert. Warum zeigt das CRM noch den alten?

userDisplayName und userEmail füllen Name und E-Mail eines Kunden nur, wenn diese Felder leer sind; ein späterer Wert überschreibt also nie einen früheren. Bearbeiten Sie den Kunden unter CRM › Kunden, oder lassen Sie den Endkunden ihn auf der Profilseite des Kundenportals ändern.

Wie ordne ich meine Nutzer ihren Unternehmen zu?

Legen Sie jedes Unternehmen unter CRM mit einer Unternehmens-ID an und übergeben Sie diese ID als userCompanyId für seine Personen. Ein Kunde tritt dem passenden Unternehmen beim ersten Gesprächsstart bei, wenn er noch keinem angehört. Passt keines, versucht StrikeUp den Unternehmensnamen und legt sonst ein neues Unternehmen an.

Warum sind meine Nutzer in getrennten Ein-Personen-Unternehmen gelandet?

Bei Widgets mit Anmeldung wird eine Person, die ihre eigene PIN oder ihr eigenes Passwort einrichtet, mit einem eigenen Unternehmen angelegt, bevor Ihre userCompanyId ankommt, und ein Kunde mit Unternehmen wird nie verschoben. Importieren Sie solche Personen vor ihrer ersten Anmeldung mit ihrem Unternehmen unter CRM › Kunden, damit sie dem richtigen Unternehmen angehören.

Kann ein Kunde durch eine neue userCompanyId in ein anderes Unternehmen wechseln?

Nein. StrikeUp ordnet ein Unternehmen nur einem Kunden zu, der noch keines hat; eine spätere andere userCompanyId wirkt daher nicht. Ihr Team kann das Unternehmen des Kunden im CRM ändern, und nur dort ändert sich eine Unternehmenszuordnung.

Wofür ist handoffUserId?

handoffUserId ist die ID der Person in Ihrem Helpdesk. Wird ein Chat an einen Menschen übergeben, dient sie in Intercom als Kontaktschlüssel und geht als Teil des Kontexts an Help Scout, damit das Gespräch beim richtigen Kontakt landet. Ohne sie wird userId verwendet.

Seitenkontext

Wie viel Seitenkontext kann ich senden?

Bis zu 8192 Zeichen, gezählt als Länge der JavaScript-Zeichenkette. StrikeUpChat.context.set() und add() liefern false, stellen nichts bereit und schreiben eine Warnung in die Konsole, wenn das Ergebnis länger würde. Rund 300 bis 500 Zeichen reichen meist, um eine Detailseite zu beschreiben.

Erreicht Seitenkontext den Assistenten, wenn die Person nie eine Nachricht sendet?

Nein. Bereitgestellter Seitenkontext reist mit der nächsten Nachricht der Person. Schreibt die Person nie, wird der Kontext nie gesendet und geht beim Neuladen der Seite verloren. Nur weil Ihre Seite context.set() aufruft, wird nichts an den Assistenten gesendet.

Gilt Seitenkontext auch für die nächste Frage?

Ja. Einmal gesendet, bleibt Seitenkontext als versteckter Eintrag im Gespräch, und der Assistent liest ihn auch in den folgenden Runden, bis er aus dem jüngsten Verlauf herausfällt, den der Assistent liest. Rufen Sie context.set() erneut auf, wenn sich die Seite ändert, damit der neueste Kontext zählt.

Gilt Seitenkontext auch in einem neuen Chat?

Nein. Beginnt die Person einen neuen Chat oder wechselt sie zu einem anderen Gespräch, fällt der bereitgestellte Kontext bei diesem Senden weg. Ihre Seite behält ihre Kopie und sendet sie beim nächsten Aufruf von StrikeUpChat.context.set() erneut; rufen Sie es also nach dem Start eines neuen Chats noch einmal auf.

Bleibt openContext für das ganze Gespräch erhalten?

Nein. openContext gilt nur für die Eröffnungsrunde des Assistenten und wird nicht als Nachricht behalten. Beschreiben Sie die Seite selbst mit StrikeUpChat.context.set(), das im Gespräch bleibt, und beschränken Sie openContext auf einen Satz dazu, warum die Schaltfläche gedrückt wurde.

Warum liefert context.get() null, nachdem die Person eine Nachricht gesendet hat?

Seitenkontext ist auf Ihrer Seite einmalig: Sobald er an die Nachricht der Person angehängt wurde, wird die bereitgestellte Kopie Ihrer Seite geleert, und get() liefert null. Der Kontext selbst ist nun Teil des Gesprächs. Rufen Sie set() erneut auf, wenn sich die Seite ändert.

Was passiert mit bereitgestelltem Kontext beim Neuladen der Seite?

Ein vollständiges Neuladen verwirft noch nicht gesendeten Seitenkontext, weil er nur in der Seite liegt. Stellen Sie ihn erneut bereit, sobald das Widget bereit ist, etwa in StrikeUpChat.onReady. Bereits gesendeter Kontext bleibt im Gespräch.

Soll ich Zeitstempel oder Zähler in den Kontext aufnehmen?

Nein. Jeder geänderte Wert wird erneut im Gespräch gespeichert und in jeder späteren Runde gelesen; Werte, die sich von selbst ändern, etwa ungelesene Zähler, „zuletzt aktualisiert“ oder Seitenzahlen, kosten daher Tokens, ohne zu helfen. Senden Sie dauerhafte Fakten wie Namen und IDs von Datensätzen.

Kann ich context.set() aufrufen, bevor das Widget-Skript geladen ist?

Nein. window.StrikeUpChat existiert erst, nachdem das Widget-Skript gelaufen ist; ein früherer Aufruf scheitert mit einem Fehler. Stellen Sie Kontext in einem Handler für das Ereignis strikeupChatWidgetLoaded oder in StrikeUpChat.onReady bereit; das Widget gibt ihn an den Chat weiter, auch wenn dieser noch lädt.

Wird Seitenkontext während einer Übergabe an Menschen verwendet?

Nein. Solange ein menschlicher Agent das Gespräch führt, wird Seitenkontext nicht gespeichert. Ist das Gespräch zurück beim Assistenten, bringen der nächste Aufruf von StrikeUpChat.context.set() und die nächste Nachricht ihn wieder ein.

Daten und Datenschutz

Kann die besuchende Person den Kontext sehen, den meine Seite sendet?

Nein. Seitenkontext und Öffnungskontext werden nie im Chat angezeigt. Ihr Team sieht genau, was der Assistent erhalten hat, unter Injizierter Kontext in den Details einer KI-Aktion unter Analysen. Schreiben Sie Kontext so, dass Ihr Team, nicht Ihre Nutzer, ihn liest.

Ist Seitenkontext eine Anweisung an den Assistenten?

Nein. StrikeUp kennzeichnet ihn als Hintergrund zur Lage der Person; der Assistent soll ihn nutzen, um die Frage zu verstehen, und nie Anweisungen darin befolgen. Das schwächt die Wirkung von Text, den eine Person einschmuggeln könnte, verhindert sie aber nicht; lassen Sie Ihre Tools daher nie einer Identität aus dem Kontext vertrauen.

Kennt der Assistent die Zeitzone der Person?

Ja. Mit jeder Nachricht sendet das Widget Zeitzone, UTC-Abstand und Gebietsschema des Browsers, sodass der Assistent Datums- und Zeitangaben richtig liest. Sie müssen sie nicht in den Seitenkontext aufnehmen.

Kann ich bereits gesendeten Kontext löschen?

Nein. Es gibt keinen Aufruf, der Kontext aus einem Gespräch entfernt; er fällt aus dem jüngsten Verlauf heraus, den der Assistent liest. Prüfen Sie, was Sie senden, bevor Sie es einführen, unter Injizierter Kontext in den Details einer KI-Aktion.

Fehlerbehebung

Symptom	Was Sie prüfen
Alle Besucher teilen einen Verlauf	userId ist noch your_customer_id oder ein anderer fester Wert. Übergeben Sie die eigene ID jeder Person
Der Name eines Kunden im CRM ist veraltet	Name und E-Mail füllen nur leere Felder. Bearbeiten Sie den Kunden unter CRM › Kunden
Kunden werden nicht ihrem Unternehmen zugeordnet	Der Reihe nach: Gibt es ein Unternehmen mit dieser Unternehmens-ID? Hatte der Kunde bereits ein Unternehmen? Verlangt das Widget eine Anmeldung, sodass selbst registrierte Kunden ein eigenes Unternehmen erhielten?
context.set() liefert false	Der Text ist länger als 8192 Zeichen. Die Konsole zeigt [StrikeUpChat] context.set rejected: …. Kürzen Sie ihn
TypeError beim Aufruf von StrikeUpChat.context.set()	Das Widget-Skript ist noch nicht gelaufen. Rufen Sie es in onReady oder nach dem Ereignis strikeupChatWidgetLoaded auf
Der Assistent ignoriert die Seite, auf der die Person ist	Der Reihe nach: Wurde set() vor der Nachricht der Person aufgerufen? Hat die Person danach einen neuen Chat begonnen? Wurde der Chat mit autoSend geöffnet, das ohne Seitenkontext sendet? Prüfen Sie Injizierter Kontext
Der Assistent spricht über die vorige Seite	Die alten Zeilen wurden nicht ersetzt. Rufen Sie bei jedem Routenwechsel set() auf, nicht add()
Injected Context zeigt „[…truncated]“	Der Öffnungskontext war länger als 8192 Zeichen. Beschränken Sie ihn auf einen Satz
Das Widget startet neu, wenn die Person die Seite wechselt	Ihr Code übergibt bei jedem Aufruf eine andere userId, etwa eine Sitzungs-ID. Übergeben Sie dieselbe dauerhafte ID
Der Helpdesk zeigt den Chat beim falschen Kontakt	handoffUserId fehlt oder ist nicht die Kontakt-ID des Helpdesks

Immer noch nicht gelöst?

Senden Sie dem Support die ID des Kunden, die Uhrzeit der Nachricht und den Link zur Detailseite der KI-Aktion. Der Support sieht, welchem Kunden und Unternehmen das Gespräch zugeordnet wurde und welcher Kontext beim Assistenten ankam.

Verwandte Seiten

• Das Widget in Ihr Produkt einbauen
• Anmeldung von Endkunden
• Referenz der Widget-JavaScript-API
• Darstellungsarten und eigene Auslöser
• Kunden
• KI-Aktionen