In diesem Beitrag erklären wir, wie der Digitale Serviceberater auf Ihrer Homepage eingebunden wird. Die Einbindung besteht aus einer einzigen Code-Zeile. Diesen Beitrag können Sie direkt an Ihre Webagentur weitergeben.
Voraussetzungen
- Der Digitale Serviceberater ist in der S2 eingerichtet: Wie richte ich den Digitalen Serviceberater in der S2 ein?
- Ihre Homepage ist über HTTPS erreichbar (Adresse beginnt mit https://).
- Die Adresse Ihrer Homepage ist in der S2 unter Chatagent Einstellungen > Verbindung > "Website-Origins (Soll)" eingetragen, genau so, wie sie im Browser erscheint, z. B. https://www.meine-werkstatt.de.
Die Einbindung können Sie selbst vornehmen oder von Ihrer Webagentur durchführen lassen. Die Einbindung nimmt in der Regel Ihre Webagentur vor. Haben Sie keine Webagentur, sprechen Sie uns gern an. Wir vermitteln Ihnen die Einbindung über unseren Partner oder nehmen diese in seltenen Fällen selbst vor.
1. Zugangsdaten aus der S2 kopieren
Öffnen Sie in der S2 den Programmpunkt 2 - Sonstiges und dort 1 - Einstellungen, anschließend "Chatagent Einstellungen" und den Reiter "Verbindung". Kopieren Sie im Bereich Website-Integration die Werte "Chat-API-URL" und "Browser-API-Key".
Sind die beiden Felder leer, ist die S2 noch nicht registriert. Klicken Sie in diesem Fall im selben Reiter auf "Jetzt registrieren", siehe: Wie richte ich den Digitalen Serviceberater in der S2 ein?
Der Browser-API-Key ist später im Quelltext Ihrer Homepage sichtbar. Das ist so vorgesehen: Er funktioniert nur zusammen mit der in der S2 freigegebenen Homepage-Adresse.
2. Code-Zeile einfügen
Fügen Sie die folgende Code-Zeile auf allen Seiten Ihrer Homepage kurz vor dem schließenden </body>-Tag ein und ersetzen Sie die beiden Platzhalter durch die Werte aus Schritt 1:
<script src="https://d37vmijvlg2jpk.cloudfront.net/widget.js"
data-api-url="CHAT-API-URL"
data-api-key="BROWSER-API-KEY"></script>Das ist alles. Sie müssen keine Dateien hochladen. Der Chat wird zentral bereitgestellt, Verbesserungen und Updates kommen automatisch auf Ihrer Homepage an. Name, Begrüßung und Anrede übernimmt der Chat aus den Einstellungen in der S2.
Optional für Webagenturen: Widget selbst hosten
Statt der zentralen Bereitstellung kann das Widget auch auf dem eigenen Webserver liegen. Dafür stellen wir auf Anfrage das Paket "ai-advisor-widget" bereit. Es enthält die Dateien widget.js, snippet.html, ai-advisor-widget.css (optional) und eine README.
Laden Sie widget.js (und optional ai-advisor-widget.css) auf Ihren Webserver und setzen Sie in der Code-Zeile src="widget.js" statt der zentralen Adresse. Die Werte für data-api-url und data-api-key nehmen Sie aus der S2 (Schritt 1), nicht aus dem Paket.
Bitte beachten Sie: Updates und Verbesserungen kommen dann nicht automatisch an, sondern müssen von Hand eingespielt werden. Wir empfehlen deshalb die zentrale Bereitstellung.
Möchten Sie den Chat darüber hinaus weiter anpassen oder ein eigenes Chatfenster umsetzen, stellen wir Ihrer Webagentur auf Anfrage auch den vollständigen Einbindungscode und eine technische Beschreibung der Schnittstelle zur Verfügung.
So geht es bei Content-Management-Systemen und Homepage-Baukästen
- Content-Management-Systeme (z. B. WordPress): Die meisten Systeme bieten eine Funktion oder Erweiterung, um eigenen Code im Footer bzw. vor </body> auf allen Seiten einzufügen. Alternativ kann der Code direkt im Theme ergänzt werden – das sollte Ihre Webagentur übernehmen, da Theme-Updates die Änderung sonst überschreiben können.
- Homepage-Baukästen: Eigener Code lässt sich meist in den Einstellungen unter einem Punkt wie “Eigener Code” oder “Code-Snippets” einfügen. Wählen Sie dort den Footer bzw. das Ende der Seite und die Anzeige auf allen Seiten. In manchen Tarifen ist das nicht möglich – fragen Sie dann bei Ihrem Anbieter nach.
- Betreut ein Dienstleister Ihre Homepage (z. B. bei einem OneBoxShop): Geben Sie ihm die beiden Werte aus Schritt 1 und diesen Beitrag weiter, er übernimmt die Einbindung.
Cookie-Banner: Muss der Chat dort eingetragen werden?
Der Digitale Serviceberater setzt keine Cookies und speichert den Chatverlauf nur für die Dauer des Besuchs im Browser. Eine Einwilligung über den Cookie-Banner ist dafür in der Regel nicht nötig. Achten Sie aber darauf, dass Ihr Cookie-Tool (z. B. Borlabs Cookie, Usercentrics) das Skript nicht automatisch blockiert. Erscheint der Chat-Button erst nach Zustimmung im Banner oder gar nicht, muss das Skript dort freigegeben werden.
3. Aussehen anpassen (optional)
Ohne weitere Einstellungen erscheint der Chat unten rechts in Blau. Farbe, Position und Schrift lassen sich an Ihre Homepage anpassen, indem Ihre Webagentur folgende Angaben in das Stylesheet (CSS) Ihrer Homepage aufnimmt:
#csb-widget-root {
--csb-primary: #0a7d5e; /* Hauptfarbe: Chat-Button, Kopfzeile, eigene Nachrichten */
--csb-primary-hover: #086b50; /* Hauptfarbe beim Darüberfahren */
--csb-position: left; /* right (Standard) oder left */
--csb-font: 15px/1.4 "Open Sans", sans-serif;
}Alle Einstellmöglichkeiten für Webagenturen
| Variable | Bedeutung | Standard |
--csb-primary |
Hauptfarbe (Chat-Button, Kopfzeile, eigene Nachrichten) | #2563eb |
--csb-primary-hover |
Hauptfarbe beim Darüberfahren | #1d4ed8 |
--csb-bg |
Hintergrund des Chatfensters | #ffffff |
--csb-panel-bg |
Hintergrund des Nachrichtenbereichs | #f9fafb |
--csb-text |
Schriftfarbe | #111111 |
--csb-radius |
Eckenradius des Chatfensters | 12px |
--csb-font |
Schriftgröße, Zeilenhöhe und Schriftart | 14px/1.4 system-ui |
--csb-position |
Seite des Chats: right oder left
|
right |
--csb-offset |
Abstand vom Bildschirmrand | 20px |
--csb-z |
Ebene über anderen Elementen (z-index) | 999999 |
Die Beschriftung des Chat-Buttons lässt sich in der Code-Zeile mit data-launcher="Termin anfragen" ändern. Den Namen im Chatfenster pflegen Sie in der S2.
Content-Security-Policy: Verwendet Ihre Homepage eine Content-Security-Policy, müssen https://d37vmijvlg2jpk.cloudfront.net unter script-src und die Chat-API-URL unter connect-src erlaubt sein.
Version festhalten: Wer Updates nicht automatisch übernehmen möchte, kann statt /widget.js eine feste Version laden, z. B. /v/1.2.0/widget.js. Das empfehlen wir nur in Ausnahmefällen.
4. Datenschutzerklärung ergänzen
Ergänzen Sie Ihre Datenschutzerklärung um einen Abschnitt zum Digitalen Serviceberater. Als Betreiber Ihrer Homepage sind Sie für die Datenschutzerklärung und die datenschutzkonforme Einbindung verantwortlich.
Als Hilfestellung finden Sie unten einen unverbindlichen Formulierungsvorschlag in der Sie- und in der Du-Form. Ersetzen Sie die Angaben in eckigen Klammern durch Ihre eigenen Daten. Der Vorschlag stellt keine Rechtsberatung dar. Bitte prüfen Sie ihn bzw. lassen Sie ihn von Ihrem Datenschutzbeauftragten prüfen und passen Sie ihn an Ihre Datenschutzerklärung an.
Formulierungsvorschlag anzeigen (Sie-Form)
Digitaler Serviceberater / Online-Terminanfrage
Auf unserer Website bieten wir einen digitalen Serviceberater an, über den Sie Werkstatttermine anfragen können. Es handelt sich um einen KI-gestützten Assistenten. Er strukturiert Ihr Anliegen (z. B. Art der Arbeit, voraussichtliche Dauer) und schlägt freie Termine vor. Jeder Termin wird von unseren Mitarbeitenden geprüft und bestätigt; es findet keine ausschließlich automatisierte Entscheidung im Sinne von Art. 22 DSGVO statt.
Welche Daten verarbeiten wir?
- Angaben, die Sie im Chat machen: Name, Kontaktdaten (E-Mail, Telefonnummer), Angaben zum Fahrzeug (z. B. Marke, Modell, Kennzeichen, Kilometerstand), Beschreibung Ihres Anliegens, Wunschtermin
- Technische Verbindungsdaten, die beim Laden und bei der Nutzung des Serviceberaters anfallen (z. B. IP-Adresse, Zeitpunkt des Zugriffs, Browser-Informationen)
Bitte geben Sie im Chat keine sensiblen Angaben ein, die für die Terminanfrage nicht nötig sind – zum Beispiel Gesundheitsdaten, Bank- oder Zahlungsdaten oder Ausweisnummern.
Zweck und Rechtsgrundlage
- Bearbeitung Ihrer Terminanfrage und Vorbereitung des Werkstattauftrags: Art. 6 Abs. 1 lit. b DSGVO (Vertrag bzw. vorvertragliche Maßnahmen auf Ihre Anfrage)
- Sicherer und stabiler Betrieb des Dienstes, Missbrauchsschutz: Art. 6 Abs. 1 lit. f DSGVO (berechtigtes Interesse)
- Soweit Sie bereits Kunde bei uns sind, gleichen wir Ihre Angaben mit unserem Kundenbestand ab, um den Auftrag korrekt zuzuordnen: Art. 6 Abs. 1 lit. b DSGVO
Empfänger / Dienstleister
Den digitalen Serviceberater betreibt für uns die CSB – Bruns & Börjes GmbH, Poststraße 12, 26689 Augustfehn, als Auftragsverarbeiter gemäß Art. 28 DSGVO. CSB setzt als Unterauftragsverarbeiter die Amazon Web Services EMEA SARL (38 Avenue John F. Kennedy, L-1855 Luxemburg) ein – für das Hosting und die Verarbeitung Ihrer Texteingaben durch KI-Sprachmodelle, die über den Dienst Amazon Bedrock bereitgestellt werden. Derzeit ist das Claude von Anthropic; behelfsweise (z. B. bei einer Störung) kann ein anderes über Amazon Bedrock bereitgestelltes Sprachmodell eingesetzt werden.
Die Verarbeitung Ihrer Eingaben erfolgt in Rechenzentren in der EU. Vertragspartner ist die Amazon Web Services EMEA SARL mit Sitz in Luxemburg. Für den Fall eines Zugriffs aus den USA gelten die im AWS Data Processing Addendum vereinbarten EU-Standardvertragsklauseln. Das Programm des Serviceberaters wird über das Auslieferungsnetz Amazon CloudFront geladen; dabei werden am jeweils nächstgelegenen Standort lediglich die technischen Verbindungsdaten verarbeitet, nicht Ihre Eingaben im Chat.
Speicherdauer
Der Chatverlauf wird nicht dauerhaft auf unseren Servern oder denen unserer Dienstleister gespeichert, sondern nur für die Dauer Ihres Besuchs in Ihrem Browser (siehe unten). Die aus dem Chat entstandene Terminanfrage wird übermittelt und gespeichert. Sobald wir die Anfrage in unsere Warenwirtschaft übernommen haben, wird sie bei unseren Dienstleistern gelöscht. Nicht abgerufene Terminanfragen werden nach 7 Tagen automatisch gelöscht. Die Termin- und Auftragsdaten in unserer Warenwirtschaft speichern wir, solange dies für die Durchführung des Auftrags erforderlich ist, und im Übrigen gemäß den gesetzlichen Aufbewahrungsfristen. Technische Protokolldaten werden nach spätestens 30 Tagen gelöscht.
Speicherung im Browser
Damit der Chatverlauf während Ihres Besuchs erhalten bleibt (z. B. beim Wechsel auf eine andere Unterseite), speichert der Serviceberater ihn im Sitzungsspeicher Ihres Browsers (SessionStorage). Diese Speicherung ist für den von Ihnen gewünschten Dienst technisch erforderlich (§ 25 Abs. 2 Nr. 2 TDDDG). Der Verlauf wird automatisch gelöscht, sobald Ihre Terminanfrage abgeschickt ist oder Sie das Browserfenster bzw. den Tab schließen. Es werden keine Cookies gesetzt.
Freiwilligkeit
Die Nutzung ist freiwillig. Sie können Termine auch weiterhin telefonisch oder per E-Mail anfragen: [Ihre Telefonnummer], [Ihre E-Mail-Adresse].
Ihre Rechte
Es gelten die in dieser Datenschutzerklärung beschriebenen Rechte (Auskunft, Berichtigung, Löschung, Einschränkung, Datenübertragbarkeit, Widerspruch, Beschwerde bei einer Aufsichtsbehörde). Ansprechpartner ist [Firmenname, Kontakt bzw. Datenschutzbeauftragter].
Formulierungsvorschlag anzeigen (Du-Form)
Digitaler Serviceberater / Online-Terminanfrage
Auf unserer Website bieten wir einen digitalen Serviceberater an, über den du Werkstatttermine anfragen kannst. Es handelt sich um einen KI-gestützten Assistenten. Er strukturiert dein Anliegen (z. B. Art der Arbeit, voraussichtliche Dauer) und schlägt freie Termine vor. Jeder Termin wird von unseren Mitarbeitenden geprüft und bestätigt; es findet keine ausschließlich automatisierte Entscheidung im Sinne von Art. 22 DSGVO statt.
Welche Daten verarbeiten wir?
- Angaben, die du im Chat machst: Name, Kontaktdaten (E-Mail, Telefonnummer), Angaben zum Fahrzeug (z. B. Marke, Modell, Kennzeichen, Kilometerstand), Beschreibung deines Anliegens, Wunschtermin
- Technische Verbindungsdaten, die beim Laden und bei der Nutzung des Serviceberaters anfallen (z. B. IP-Adresse, Zeitpunkt des Zugriffs, Browser-Informationen)
Bitte gib im Chat keine sensiblen Angaben ein, die für die Terminanfrage nicht nötig sind – zum Beispiel Gesundheitsdaten, Bank- oder Zahlungsdaten oder Ausweisnummern.
Zweck und Rechtsgrundlage
- Bearbeitung deiner Terminanfrage und Vorbereitung des Werkstattauftrags: Art. 6 Abs. 1 lit. b DSGVO (Vertrag bzw. vorvertragliche Maßnahmen auf deine Anfrage)
- Sicherer und stabiler Betrieb des Dienstes, Missbrauchsschutz: Art. 6 Abs. 1 lit. f DSGVO (berechtigtes Interesse)
- Soweit du bereits Kunde bei uns bist, gleichen wir deine Angaben mit unserem Kundenbestand ab, um den Auftrag korrekt zuzuordnen: Art. 6 Abs. 1 lit. b DSGVO
Empfänger / Dienstleister
Den digitalen Serviceberater betreibt für uns die CSB – Bruns & Börjes GmbH, Poststraße 12, 26689 Augustfehn, als Auftragsverarbeiter gemäß Art. 28 DSGVO. CSB setzt als Unterauftragsverarbeiter die Amazon Web Services EMEA SARL (38 Avenue John F. Kennedy, L-1855 Luxemburg) ein – für das Hosting und die Verarbeitung deiner Texteingaben durch KI-Sprachmodelle, die über den Dienst Amazon Bedrock bereitgestellt werden. Derzeit ist das Claude von Anthropic; behelfsweise (z. B. bei einer Störung) kann ein anderes über Amazon Bedrock bereitgestelltes Sprachmodell eingesetzt werden.
Die Verarbeitung deiner Eingaben erfolgt in Rechenzentren in der EU. Vertragspartner ist die Amazon Web Services EMEA SARL mit Sitz in Luxemburg. Für den Fall eines Zugriffs aus den USA gelten die im AWS Data Processing Addendum vereinbarten EU-Standardvertragsklauseln. Das Programm des Serviceberaters wird über das Auslieferungsnetz Amazon CloudFront geladen; dabei werden am jeweils nächstgelegenen Standort lediglich die technischen Verbindungsdaten verarbeitet, nicht deine Eingaben im Chat.
Speicherdauer
Der Chatverlauf wird nicht dauerhaft auf unseren Servern oder denen unserer Dienstleister gespeichert, sondern nur für die Dauer deines Besuchs in deinem Browser (siehe unten). Die aus dem Chat entstandene Terminanfrage wird übermittelt und gespeichert. Sobald wir die Anfrage in unsere Warenwirtschaft übernommen haben, wird sie bei unseren Dienstleistern gelöscht. Nicht abgerufene Terminanfragen werden nach 7 Tagen automatisch gelöscht. Die Termin- und Auftragsdaten in unserer Warenwirtschaft speichern wir, solange dies für die Durchführung des Auftrags erforderlich ist, und im Übrigen gemäß den gesetzlichen Aufbewahrungsfristen. Technische Protokolldaten werden nach spätestens 30 Tagen gelöscht.
Speicherung im Browser
Damit der Chatverlauf während deines Besuchs erhalten bleibt (z. B. beim Wechsel auf eine andere Unterseite), speichert der Serviceberater ihn im Sitzungsspeicher deines Browsers (SessionStorage). Diese Speicherung ist für den von dir gewünschten Dienst technisch erforderlich (§ 25 Abs. 2 Nr. 2 TDDDG). Der Verlauf wird automatisch gelöscht, sobald deine Terminanfrage abgeschickt ist oder du das Browserfenster bzw. den Tab schließt. Es werden keine Cookies gesetzt.
Freiwilligkeit
Die Nutzung ist freiwillig. Du kannst Termine auch weiterhin telefonisch oder per E-Mail anfragen: [Ihre Telefonnummer], [Ihre E-Mail-Adresse].
Deine Rechte
Es gelten die in dieser Datenschutzerklärung beschriebenen Rechte (Auskunft, Berichtigung, Löschung, Einschränkung, Datenübertragbarkeit, Widerspruch, Beschwerde bei einer Aufsichtsbehörde). Ansprechpartner ist [Firmenname, Kontakt bzw. Datenschutzbeauftragter].
5. Testen
- Öffnen Sie Ihre Homepage. Unten rechts (bzw. links) erscheint der Chat-Button.
- Stellen Sie eine Testanfrage im Chatfenster. Nach dem Absenden erscheint im Chat die Bestätigung "✓ Terminanfrage an die Werkstatt übermittelt".
- Stellen Sie eine Testanfrage im Chatfenster. Prüfen Sie, ob die Anfrage im S2-Werkstattkalender ankommt, und lehnen Sie die Testanfrage anschließend ab: Wie bearbeite ich Online-Terminanfragen im S2-Werkstattkalender?
Über "Neuer Chat" starten Sie eine neue Unterhaltung. Schließen Sie den Browser-Tab, ist das Gespräch beendet.
Funktioniert etwas nicht?
| Was Sie sehen | Was Sie tun können |
| Der Chat-Button erscheint nicht | Prüfen Sie, ob die Code-Zeile auf der Seite eingefügt und gespeichert ist. Blockiert ein Cookie-Tool das Skript? Bei Homepage-Baukästen hilft manchmal ein Neuladen ohne Zwischenspeicher (Strg + F5). |
| Der Chat öffnet sich, antwortet aber nicht oder meldet "nicht verfügbar" | Meist stimmt die Adresse der Homepage in der S2 nicht genau: mit https://, mit bzw. ohne www, ohne Schrägstrich am Ende. Prüfen Sie auch, ob API-URL und Key vollständig kopiert sind. |
| "Der Chat ist gerade nicht erreichbar" | Kurze Störung oder viele gleichzeitige Anfragen. Nach einigen Minuten erneut versuchen, bei Häufung unseren Support kontaktieren. |
| Die Testanfrage kommt nicht in der S2 an | Prüfen Sie in der S2 im Reiter "Verbindung", ob "Verbunden mit AWS IoT Core" angezeigt wird. Der Server mit der S2 muss eingeschaltet sein. |
Weitere Hinweise finden Sie im Beitrag Was kann ich tun, wenn der Digitale Serviceberater nicht funktioniert?. Kommen Sie nicht weiter, reichen Sie gern eine Anfrage bei unserem Support ein.
Kommentare
0 Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.