> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/websites-und-funnels/sprach-ki-widget-auf-der-website-testen.md).

# Sprach-KI-Widget auf der Website testen

Richte ein Sprach-KI-Widget auf einer veröffentlichten Seite ein, teste es kontrolliert und ordne die automatische Sicherheitsprüfung richtig ein.

## Das Ergebnis

Ein Sprach-KI-Widget ermöglicht Besucherinnen und Besuchern, direkt im Browser mit einem Sprachassistenten zu sprechen. Dafür verwenden sie Mikrofon und Lautsprecher ihres Geräts; ein Telefonanruf oder eine zusätzliche App ist nicht erforderlich.

Zum Schutz vor wiederholten Verbindungsversuchen enthält dieser Widget-Typ eine automatische Sicherheitsprüfung. Sie muss nicht separat eingerichtet werden und betrifft keine üblichen textbasierten Chat-Widgets.

## Widget vorbereiten

1. Öffne **Websites und Leadgewinnung** > **Chat-Widgets**.
2. Erstelle ein neues Widget oder öffne ein vorhandenes.
3. Wähle im Bereich für den Assistenten den Sprach-KI-Assistenten aus.
4. Prüfe Name des Assistenten und Widget-Einstellungen.
5. Speichere das Widget.
6. Füge den Widget-Code auf einer Website- oder Funnel-Seite ein.
7. Veröffentliche die Seite und teste das Widget auf der Live-Seite.

Teste nicht nur in der Vorschau. Mikrofonfreigaben und Browser-Verhalten können sich auf einer veröffentlichten Seite anders verhalten.

### Ein vorhandenes Widget direkt verbinden

Du kannst ein Chat-Widget auch direkt beim vorbereiteten Sprachassistenten zuordnen. Das ist praktisch, wenn zuerst der Assistent eingerichtet wurde und das Widget danach folgen soll.

1. Öffne den gewünschten Sprach-KI-Assistenten und wechsle in seinen Bereich zum Bereitstellen.
2. Suche dort den Abschnitt für Chat-Widgets.
3. Wähle ein vorhandenes Widget aus, um es mit diesem Assistenten zu verbinden.
4. Wenn noch keines vorhanden ist, erstelle dort ein neues Widget. Es wird anschließend direkt mit dem Assistenten verknüpft.
5. Über die Widget-Verwaltung öffnest du vorhandene Widgets; beim Bearbeiten bleibt die Assistentenansicht geöffnet und das Widget erscheint in einem neuen Browser-Tab.
6. Speichere die Bereitstellung.

Löse eine Verbindung wieder, wenn ein Widget künftig einen anderen Assistenten verwenden soll. Prüfe danach immer auf der veröffentlichten Seite, ob die richtige Begrüßung und der erwartete Assistent sichtbar sind.

### Einbindungscode passend einsetzen

Über **Code abrufen** steht der Einbindungscode zur Verfügung. Je nach sichtbarer Auswahl kannst du ihn direkt in den Kopf- oder Fußbereich der Seite einsetzen oder über euren Tag-Manager hinterlegen. Verwende nur einen dieser Wege pro Widget und veröffentliche die Seite anschließend erneut. Mehrfach eingefügter Code kann dazu führen, dass das Widget doppelt erscheint.

## So funktioniert die automatische Sicherheitsprüfung

Die Sicherheitsprüfung wird aktiv, wenn dieselbe Besucherin oder derselbe Besucher innerhalb von 60 Sekunden zehnmal schnell eine Sprachverbindung beginnt und wieder beendet. Dann erscheint eine Prüfung, mit der bestätigt wird, dass ein Mensch das Widget verwendet. Nach erfolgreichem Abschluss kann das Sprach-KI-Widget weiter genutzt werden.

Der Grenzwert ist fest eingestellt und kann nicht angepasst werden. Die Sicherheitsprüfung ist erwartetes Verhalten und kein Hinweis auf einen Defekt.

## Test planvoll durchführen

Bei schnellen Wiederholungen kann ein Funktionstest wie missbräuchliches Verhalten aussehen. Prüfe deshalb in ruhigen Schritten:

1. Öffne die veröffentlichte Seite in einem aktuellen Browser.
2. Erlaube den Zugriff auf das Mikrofon.
3. Starte eine kurze Unterhaltung und prüfe Ton, Antwort und Ende der Verbindung.
4. Warte zwischen weiteren Tests etwas, statt die Verbindung wiederholt sofort zu öffnen und zu schließen.
5. Teste bei Bedarf einen zweiten Browser oder ein zweites Gerät.
6. Erscheint die Sicherheitsprüfung, schließe sie ab und setze den Test danach normal fort.

Prüfe auch, ob eine verständliche Alternative vorhanden ist, falls eine Besucherin kein Mikrofon freigibt oder keine Sprachfunktion nutzen möchte.

## Was der Schutz betrifft – und was nicht

Die automatische Prüfung gilt nur für das Sprach-KI-Widget. Sie ändert die Nutzung eines normalen textbasierten Chat-Widgets nicht. Sie schützt vor schnellen, wiederholten Verbindungsversuchen, ersetzt aber keine sorgfältige Einrichtung des Assistenten und keine Prüfung seiner Antworten.

## Praxisbeispiel

Eine Praxis veröffentlicht auf ihrer Terminseite ein Sprach-KI-Widget für allgemeine Fragen. Eine Mitarbeiterin testet es zuerst im Browser mit Mikrofonfreigabe, führt ein normales Gespräch und prüft anschließend ein zweites Gerät. Sie beendet die Verbindung nicht mehrfach hintereinander, damit der Test die Sicherheitsprüfung nicht unnötig auslöst. Danach ergänzt sie auf der Seite einen sichtbaren Button zum regulären Kontaktformular für Personen, die lieber schreiben möchten.

## Häufige Fehler

### Es erscheint eine Sicherheitsprüfung während des Tests

Das kann nach vielen schnellen Verbindungsversuchen derselben Person auftreten. Schließe die Prüfung ab, warte zwischen weiteren Tests und vermeide schnelle Wiederholungen.

### Das Mikrofon funktioniert nicht

Prüfe die Browser-Berechtigung und teste mit einem zweiten Browser. Das Widget benötigt den Zugriff auf Mikrofon und Lautsprecher des verwendeten Geräts.

### Ein normales Chat-Widget verhält sich anders

Die beschriebene Sicherheitsprüfung gilt nur für die Sprachfunktion. Prüfe textbasierte Chats separat anhand ihres eigenen Einrichtungs- und Testablaufs.

## Teststatus und vollständige Einrichtung

Das Sprach-KI-Widget ist als Testfunktion gekennzeichnet. Richte es nur ein, wenn die entsprechende Option im Standort sichtbar ist, und prüfe die Nutzung vor einer breiten Veröffentlichung besonders sorgfältig.

### Den Assistenten im Widget sichtbar einrichten

Öffne beim Bearbeiten des Widgets den Bereich für den Assistenten. Wähle dort den bereits vorbereiteten Sprachassistenten aus und fülle die Angaben aus, die Besucherinnen und Besucher beim Start sehen:

* **Sprachassistent auswählen:** Lege fest, welcher vorbereitete Assistent die Gespräche führt. Prüfe seine Antworten vorher außerhalb des Widgets.
* **Sichtbarer Name:** Diese Pflichtangabe erscheint in der Startansicht des Widgets. Verwende einen klaren Namen, damit Besuchende sofort wissen, mit wem sie sprechen.
* **Beschreibung:** Die kurze Beschreibung steht ebenfalls in der Startansicht. Erkläre in einem Satz, wobei der Assistent hilft, zum Beispiel bei allgemeinen Fragen zu einem Termin.

Ein Assistent, dessen Ablauf eine Übergabe eines laufenden Gesprächs an eine Person auslöst, kann nicht für dieses Widget ausgewählt werden. Wähle in diesem Fall einen passenden Assistenten ohne diese Übergabe oder biete zusätzlich einen direkten Kontaktweg an.

Sprachsitzungen über dieses Widget werden nicht aufgezeichnet. Plane den Funktionstest deshalb so, dass du Begrüßung, Antwortqualität und Abschluss direkt während des Gesprächs prüfst.

Vor dem Erstellen müssen ein Sprach-KI-Assistent und dessen Gesprächsablauf bereits eingerichtet sein. Im Standort lassen sich bis zu 100 Sprach-KI-Assistenten anlegen. Im Chat-Widget wählst du anschließend diesen Assistenten aus und legst den Namen fest, den Besucherinnen und Besucher sehen.

1. Öffne die verfügbaren Testfunktionen in den Standort-Einstellungen und aktiviere das Sprach-KI-Widget, falls die Option vorhanden ist.
2. Öffne **Websites und Leadgewinnung > Chat-Widgets**.
3. Erstelle ein Widget oder bearbeite ein vorhandenes.
4. Wähle den Sprach-KI-Assistenten und vergib einen verständlichen sichtbaren Namen.
5. Speichere das Widget.
6. Kopiere über **Code abrufen** den Einbindungscode in den Kopf- oder Fußbereich der gewünschten Website oder des Funnels.
7. Veröffentliche die Seite und teste mit einem aktuellen Browser.

Besucher starten die Sprachsitzung über das Mikrofonsymbol und müssen dem Browser den Mikrofonzugriff erlauben. Sie können die Sitzung stummschalten oder beenden. Eine Rufnummer und eine zusätzliche App sind nicht erforderlich.

## Grenzen und transparente Kommunikation

Der Widget-Typ unterstützt die vorhandenen Aktionen des Sprachassistenten, ausgenommen die Übergabe eines laufenden Gesprächs an eine Person. Sitzungen werden nicht aufgezeichnet; die Oberfläche weist Besucherinnen und Besucher darauf hin. Stelle trotzdem eine Schreib- oder Kontaktalternative bereit, falls Mikrofon oder Lautsprecher nicht verfügbar sind.

### Zusätzliche Prüfung vor der Veröffentlichung

* Teste Mikrofonfreigabe und Tonausgabe in mindestens zwei Browsern.
* Prüfe, ob Begrüßung, Datenerfassung und Abschluss zu deinem tatsächlichen Prozess passen.
* Kontrolliere, ob die sichtbare Alternative ohne Mikrofon erreichbar ist.
* Prüfe nach einer Änderung des Assistenten das Widget erneut auf einer veröffentlichten Testseite.

### Praxisbeispiel

Eine Praxis zeigt das Sprach-KI-Widget zunächst nur auf einer Testseite. Dort prüft das Team die Mikrofonfreigabe, drei typische Fragen und den Hinweis zur nicht erfolgenden Aufzeichnung. Erst wenn die Gespräche verständlich und die Kontaktalternative sichtbar sind, wird das Widget auf einer Kontaktseite veröffentlicht.

## Sprach-KI-Widget innerhalb einer Seite platzieren

Wenn die eingebettete Platzierung im Standort sichtbar ist, kann das Sprach-KI-Widget als Teil des Seiteninhalts erscheinen statt fest in einer Bildschirmecke zu liegen. Diese Darstellung eignet sich zum Beispiel neben einer Buchungsmöglichkeit, in einem Hilfebereich oder im Anschluss an eine kurze Erklärung.

1. Öffne **Websites und Leadgewinnung > Chat-Widget** und erstelle ein Widget oder öffne ein vorhandenes.
2. Wähle die Sprach-KI-Variante.
3. Öffne den Bereich für Stil und wähle **Eingebettet** oder **Inline**.
4. Wähle die sichtbare Darstellung, sofern vorhanden, und kontrolliere Größe sowie Beschriftung in der Vorschau.
5. Kopiere den bereitgestellten Einbettungscode.
6. Öffne die gewünschte Funnel- oder Website-Seite im Editor.
7. Ziehe ein Code-Element an die Stelle, an der das Widget erscheinen soll, füge den Code ein und speichere.
8. Veröffentliche die Seite erst nach einem Test auf Desktop und Mobilgerät.

Im eingebetteten Modus sind manche Einstellungen für frei schwebende Widgets nicht relevant und können deshalb fehlen. Prüfe Abstand, Breite, Mikrofonfreigabe und einen gut sichtbaren alternativen Kontaktweg. Mehrere eingebettete Positionen können auf denselben Sprach-KI-Assistenten verweisen, sollten aber nur eingesetzt werden, wenn sie für Besucher wirklich sinnvoll sind.

Diese Funktion bleibt als Testfunktion gekennzeichnet. Verwende sie nur, wenn die Option im Standort sichtbar ist, und prüfe den vollständigen Gesprächsablauf vor einer breiten Veröffentlichung.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/websites-und-funnels/sprach-ki-widget-auf-der-website-testen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.