> 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/live-chat-auf-der-website-einrichten-und-betreuen/zusatzliche-felder-im-live-chat-abfragen.md).

# Zusätzliche Felder im Live-Chat abfragen

## Was du damit erreichst

Mit zusätzlichen Kontaktfeldern im Live-Chat kannst du schon beim Start eines Gesprächs Informationen erfassen, die über Name, Rufnummer, E-Mail-Adresse und Nachricht hinausgehen. Das hilft, Anfragen einzuordnen und dem Team beim ersten Kontakt den richtigen Kontext zu geben.

Das Formular kann beim Start eines Gesprächs erscheinen oder während eines laufenden Gesprächs angefordert werden. Nutze nur Felder, die für die erste Bearbeitung wirklich nötig sind. Zu viele Pflichtfelder erhöhen die Wahrscheinlichkeit, dass Besucher den Chat abbrechen.

## Voraussetzungen

* Die benötigten Kontaktfelder sind bereits angelegt.
* Du bearbeitest ein Chat-Widget mit Kontaktformular.
* Du kennst den Zweck jedes abgefragten Feldes und kannst ihn für Besucher einfach erklären.
* Du testest die Änderungen in der Widget-Vorschau und anschließend auf der veröffentlichten Website.

## Kontaktformular im Builder öffnen

1. Öffne die Einstellungen des gewünschten Chat-Widgets.
2. Wechsle im Builder zu **Chat-Fenster**.
3. Öffne dort den Bereich **Kontaktformular-Optionen**.
4. Wähle die Standardfelder und vorhandenen zusätzlichen Kontaktfelder aus, die im Formular erscheinen sollen.
5. Prüfe die Vorschau auf der rechten Seite.
6. Speichere die Änderung.

Die geprüften Ansichten zeigen die Kontaktformular-Optionen als auswählbare Felder. Im Builder siehst du direkt, wie die Auswahl im Widget auf Rechner, Tablet oder Mobilgerät wirkt.

Die Einstellung gilt nur für dieses Widget, nicht für alle Widgets deines Standorts.

## Was Besucher vor dem Gespräch sehen

Du kannst zwei Texte verständlich formulieren:

* **Chat-Fenster-Titel:** die kurze Überschrift des Widgets.
* **Einleitender Hinweis:** erklärt in einem Satz, warum die Angaben gebraucht werden.

Formuliere zum Beispiel: **„Sag uns kurz, worum es geht. Wir melden uns so schnell wie möglich.“** Vermeide technische Begriffe und frage nur Daten ab, die dein Team wirklich verwendet.

## Standardfelder und zusätzliche Felder

| Feld                         | Bedeutung                                                                   | Wichtige Regel                                                                                        |
| ---------------------------- | --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Name**                     | Zuordnung der Anfrage zu einer Person.                                      | Ist erforderlich.                                                                                     |
| **Rufnummer**                | Rückruf oder Kontakt per Telefon.                                           | Mindestens Rufnummer oder E-Mail-Adresse muss vorhanden sein, damit ein Kontakt angelegt werden kann. |
| **E-Mail-Adresse**           | Antwort per E-Mail und eindeutige Zuordnung.                                | Mindestens Rufnummer oder E-Mail-Adresse muss vorhanden sein.                                         |
| **Nachricht**                | Erste Beschreibung des Anliegens.                                           | Nutze sie, wenn Besucher ihr Anliegen direkt schildern sollen.                                        |
| **Zusätzliches Kontaktfeld** | Eine bereits angelegte Information, zum Beispiel Thema, Datum oder Auswahl. | Nur verwenden, wenn es die erste Bearbeitung verbessert.                                              |

Wenn weder Rufnummer noch E-Mail-Adresse ausgewählt ist, wird die Rufnummer als notwendige Kontaktmöglichkeit wieder ergänzt. So kann der Kontakt nach dem Absenden angelegt werden.

## Geeignete Feldarten

Das Kontaktformular unterstützt diese zusätzlichen Feldarten:

* einzeiliger Text;
* mehrzeiliger Text;
* Betrag;
* Zahl;
* Rufnummer;
* Datum;
* Einzelauswahl.

Wähle die Feldart danach, wie Besucher die Angabe tatsächlich machen sollen. Für eine kurze Auswahl wie **Thema der Anfrage** ist eine Einzelauswahl besser als ein freier Text. Für eine konkrete Terminangabe ist ein Datumsfeld besser als ein Textfeld.

Das Formular unterstützt höchstens fünf Felder insgesamt. Standardfelder und zusätzliche Felder werden zusammengezählt.

## Pflichtfelder bewusst einsetzen

Du kannst zusätzliche Kontaktfelder als erforderlich markieren.

1. Wähle ein hinzugefügtes Feld im Kontaktformular aus.
2. Aktiviere die Einstellung für **Pflichtfeld**.
3. Prüfe die Vorschau: Erforderliche Felder sind mit einem Stern markiert.
4. Speichere und teste die Eingabe als Besucher:in.

Ein Pflichtfeld muss vollständig und gültig ausgefüllt sein, bevor das Formular abgesendet werden kann. Das gilt sowohl beim Start eines Chats als auch dann, wenn ein Teammitglied während eines laufenden Gesprächs Kontaktdaten anfordert.

Mache nur Angaben verpflichtend, die du für die erste sinnvolle Reaktion brauchst. Eine Freitextfrage wie **„Wie können wir helfen?“** eignet sich häufig besser als freiwilliges Feld als eine Rufnummer oder eine konkret benötigte Auswahl.

## Eingabe prüfen

Rufnummern werden mit Landesvorwahl geprüft. E-Mail-Adressen müssen ein gültiges Format haben. Enthält das Formular zwei oder mehr Rufnummernfelder, gilt die im Formular gewählte Landesvorwahl für alle Rufnummernfelder gleichzeitig.

Teste insbesondere:

1. ein Formular mit leerem Pflichtfeld;
2. eine unvollständige E-Mail-Adresse;
3. eine Rufnummer mit der passenden Landesvorwahl;
4. mehrere Rufnummernfelder, falls du sie verwendest;
5. den Kontakt nach erfolgreichem Absenden.

## Ergebnis prüfen

Öffne das Widget im privaten Browserfenster oder auf einem Testgerät.

1. Starte das Gespräch und prüfe Titel, Hinweis und sichtbare Felder.
2. Lasse ein Pflichtfeld leer und kontrolliere, dass das Formular nicht abgesendet wird.
3. Fülle das Formular korrekt aus und sende es ab.
4. Prüfe, ob der Kontakt angelegt wurde und die zusätzlichen Angaben am richtigen Kontakt gespeichert sind.
5. Bitte ein Teammitglied, in einem Testgespräch **Kontaktdaten anfordern** zu wählen, und prüfe auch diesen Ablauf.

Ein Besucher mit einer noch aktiven Unterhaltung kann später ohne erneutes Formular zurückkehren. Wurde die Unterhaltung beendet oder gelöscht, erscheint das Formular erneut.

## Typische Fehler

### Zu viele Pflichtfelder

Beschränke dich auf Angaben, die dein Team für die erste Reaktion wirklich braucht. Entferne zusätzliche Pflichtfelder und teste, ob die Anfrage dadurch einfacher abgeschlossen werden kann.

### Ein zusätzliches Feld erscheint nicht

Prüfe, ob das Kontaktfeld bereits angelegt ist und unter **Kontaktformular-Optionen** ausgewählt wurde. Speichere die Widget-Änderung und aktualisiere den Testbrowser.

### Kein Kontakt wird angelegt

Kontrolliere, ob neben dem Namen mindestens eine Rufnummer oder E-Mail-Adresse im Formular vorhanden ist. Prüfe außerdem die Eingabe im Test auf ein gültiges Format.

### Die Landesvorwahl wirkt auf mehrere Felder

Das ist bei mehreren Rufnummernfeldern erwartetes Verhalten: Die ausgewählte Landesvorwahl gilt für alle Rufnummernfelder im Formular. Frage deshalb mehrere Rufnummern nur ab, wenn das für den Ablauf wirklich nötig ist.

> **Praxisbeispiel:** Ein Beratungsteam möchte neue Chat-Anfragen schneller zuordnen. Neben **Name** und **E-Mail-Adresse** fügt es das Einzelauswahlfeld **Thema der Anfrage** mit drei klaren Optionen hinzu. Das Thema wird als Pflichtfeld markiert, eine freiwillige Detailfrage bleibt optional. Im Test prüft das Team die Vorschau auf Rechner und Mobilgerät, sendet eine Beispielanfrage ab und kontrolliert anschließend, ob das Thema am Kontakt gespeichert ist.


---

# 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/live-chat-auf-der-website-einrichten-und-betreuen/zusatzliche-felder-im-live-chat-abfragen.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.
