> 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/kommunikation/telefonie/chat-widget-zu-whatsapp-leiten.md).

# Chat-Widget zu WhatsApp leiten

Richte einen Website-Chat ein, der Interessierte nach dem Ausfüllen direkt zu deiner ausgewählten WhatsApp-Nummer weiterleitet, und prüfe den gesamten Weg mit einem echten Test.

## Was dieses Widget für Besuchende macht

Dieses Chat-Widget ist kein gewöhnlicher Live-Chat auf deiner Website. Es führt Interessierte nach dem Ausfüllen des Widgets in einen WhatsApp-Chat mit der von dir ausgewählten Geschäftsnummer.

Der Ablauf ist einfach:

1. Eine Person öffnet deine Website oder deinen Funnel.
2. Sie sieht das Chat-Widget und trägt die abgefragten Angaben sowie ihre Nachricht ein.
3. Nach dem Absenden öffnet sich WhatsApp mit der ausgewählten Nummer und der Nachricht.
4. Dein Team erhält die Unterhaltung im Gesprächsbereich und kann dort antworten.

Das eignet sich besonders, wenn Anfragen direkt im gewohnten Messenger weitergeführt werden sollen.

> **Wichtig:** Die Auswahl der Zielnummer entscheidet, wo die Nachricht ankommt. Prüfe sie vor der Veröffentlichung mit einem echten Testkontakt.

## Wann dieser Weg passt

| Situation                                                                | WhatsApp-Chat-Widget geeignet? | Warum                                                                              |
| ------------------------------------------------------------------------ | ------------------------------ | ---------------------------------------------------------------------------------- |
| Interessierte sollen schnell per Messenger Kontakt aufnehmen             | Ja                             | Der Übergang von Website zu WhatsApp ist direkt.                                   |
| Dein Team beantwortet Anfragen vor allem im Gesprächsbereich             | Ja                             | Die Unterhaltung wird dort sichtbar und kann weitergeführt werden.                 |
| Besuchende sollen direkt auf der Website live mit einer Person schreiben | Nicht unbedingt                | Dieses Widget leitet nach WhatsApp weiter; es ist kein fortlaufender Website-Chat. |
| Noch keine WhatsApp-Nummer ist eingerichtet                              | Noch nicht                     | Zuerst muss eine nutzbare Nummer hinterlegt sein.                                  |

## Voraussetzungen

* WhatsApp ist im Standort aktiviert.
* Mindestens eine WhatsApp-Nummer ist eingerichtet und kann Nachrichten empfangen.
* Du darfst Chat-Widgets erstellen und die gewünschte Website oder den Funnel bearbeiten.
* Für externe Webseiten darfst du Code im Kopfbereich der Seite einfügen.
* Du hast eine Testnummer, mit der du den Ablauf als Besuchende:r prüfen kannst.

Wenn noch keine Nummer vorhanden ist, führt die Oberfläche bei der Auswahl zurück zur Einrichtung der WhatsApp-Nummer. Richte die Nummer zuerst vollständig ein und kehre anschließend zum Widget zurück.

## So funktioniert der gesamte Ablauf

| Schritt                                  | Was passiert                                                                           |
| ---------------------------------------- | -------------------------------------------------------------------------------------- |
| Widget konfigurieren                     | Du legst Texte, Gestaltung, Formular und Zielnummer fest.                              |
| Widget auf der Seite aktivieren          | Das Widget wird auf einer Website, in einem Funnel oder per Einbettung sichtbar.       |
| Besuchende Person sendet das Formular ab | Die Person wird zum WhatsApp-Chat weitergeleitet.                                      |
| Nachricht trifft an der Zielnummer ein   | Dein Team sieht die Unterhaltung im Gesprächsbereich und erhält eine Benachrichtigung. |

Die Weiterleitung beginnt erst, nachdem das Widget ausgefüllt und abgesendet wurde. Ein sichtbares Widget allein löst noch keine Nachricht aus.

## Neues WhatsApp-Widget anlegen

1. Öffne **Websites** und wechsle zu **Chat-Widget**.
2. Wähle **Neu**, um ein neues Widget anzulegen.
3. Wähle bei der Chat-Art **WhatsApp**.
4. Gib dem Widget einen eindeutigen internen Namen, zum Beispiel „Website – Beratung per WhatsApp“.
5. Öffne den Bereich für das Chat-Fenster.
6. Richte Texte, Erscheinungsbild, Formular und Zielnummer ein.
7. Speichere das Widget.

Die Originalansicht zeigt die Übersicht mit der Aktion zum Anlegen eines neuen Widgets sowie die Auswahl zwischen mehreren Chat-Arten. Wähle bewusst WhatsApp aus; die anderen Chat-Arten führen zu einem anderen Gesprächsablauf.

## Chat-Fenster verständlich einrichten

Im Bereich für das Chat-Fenster siehst du eine Vorschau neben den Einstellungen. Nutze sie während der Einrichtung: So erkennst du früh, ob die Texte und Felder für Besuchende verständlich sind.

### Titel und Einstiegstext

Lege einen kurzen Titel und eine klare Einladung fest.

| Bestandteil        | Gute Aufgabe                             | Beispiel                                                                     |
| ------------------ | ---------------------------------------- | ---------------------------------------------------------------------------- |
| Titel              | Sagt sofort, worum es geht.              | „Frage zu unserem Angebot?“                                                  |
| Einstiegstext      | Erklärt, was nach dem Absenden passiert. | „Schreib uns kurz dein Anliegen. Wir öffnen anschließend den WhatsApp-Chat.“ |
| Schaltflächen-Text | Macht die nächste Aktion eindeutig.      | „Chat starten“                                                               |

Versprich keine sofortige Antwort, wenn dein Team nicht jederzeit erreichbar ist. Beschreibe lieber klar, dass der WhatsApp-Chat geöffnet wird.

### Farben und Gestaltung

Du kannst Texte, Farben und Gestaltung des Fensters an eure Website anpassen. Die WhatsApp-Variante verwendet üblicherweise Grüntöne; eigene Farben sind ebenfalls möglich.

Prüfe dabei immer die Vorschau:

* Ist der Text gut lesbar?
* Hebt sich die Schaltfläche vom Hintergrund ab?
* Passt das Widget auf Mobilgeräten noch vollständig auf den Bildschirm?
* Erkennt eine Person auf den ersten Blick, dass nach dem Klick WhatsApp geöffnet wird?

### Formularfelder

Die Originalansicht zeigt ein Formular mit Name, Telefonnummer und einem Nachrichtenfeld. Je nach Einrichtung können weitere Kontaktangaben wie E-Mail-Adresse abgefragt werden.

Frage nur Angaben ab, die dein Team für die Bearbeitung wirklich braucht. Ein kurzes, eindeutiges Formular senkt die Hürde zur Kontaktaufnahme. Das Nachrichtenfeld sollte erklären, welche Information hilfreich ist, zum Beispiel: „Worum geht es?“.

## Zielnummer auswählen

Die Zielnummer ist der wichtigste Schritt der Einrichtung.

1. Öffne im Chat-Fenster den Bereich **WhatsApp-Einstellungen**.
2. Wähle bei **WhatsApp-Nummer auswählen** die Nummer aus, die Anfragen erhalten soll.
3. Prüfe die Nummer sorgfältig, besonders wenn mehrere Nummern zur Auswahl stehen.
4. Sieh dir die Vorschau an.
5. Speichere erst danach das Widget.

Die Auswahl legt fest, zu welcher Nummer Besuchende beim Start des Chats geleitet werden. Wenn die richtige Nummer nicht angezeigt wird, richte sie zuerst unter **Einstellungen → WhatsApp** ein. Erstelle kein Widget mit einer Ersatznummer, nur um die Einrichtung abzuschließen.

## Widget auf deiner Seite sichtbar machen

### Website oder Funnel

1. Öffne die Einstellungen der gewünschten Website oder des gewünschten Funnels.
2. Aktiviere dort das Chat-Widget.
3. Wähle das eben erstellte WhatsApp-Widget aus.
4. Speichere und veröffentliche die Seite nach eurem üblichen Ablauf.
5. Öffne die veröffentlichte Seite in einem privaten Browserfenster.

### Externe Webseite

Wenn die Seite außerhalb des Standorts betrieben wird, verwende den bereitgestellten Einbettungscode.

1. Öffne das fertige Chat-Widget.
2. Wähle die Aktion zum Abrufen des Codes.
3. Kopiere den Code vollständig.
4. Füge ihn im Kopfbereich der externen Seite ein.
5. Veröffentliche die externe Seite.
6. Prüfe, ob das Widget sichtbar ist und nicht von anderen Seitenelementen verdeckt wird.

Der Einbettungscode gehört in den Kopfbereich der Seite. Eine unvollständige oder an anderer Stelle eingefügte Einbettung kann dazu führen, dass das Widget nicht erscheint.

## Den Besuchsablauf vollständig testen

Teste nicht nur die Vorschau im Editor, sondern die veröffentlichte Seite mit einer echten Testnummer.

1. Öffne die Seite in einem privaten Browserfenster oder auf einem zweiten Gerät.
2. Prüfe, ob das Widget sichtbar und lesbar ist.
3. Öffne das Widget.
4. Fülle die sichtbaren Formularfelder aus.
5. Sende eine eindeutige Testnachricht, zum Beispiel „TEST – Website-Widget – Datum“.
6. Prüfe, ob WhatsApp mit der erwarteten Zielnummer geöffnet wird.
7. Prüfe, ob die Nachricht im Gesprächsbereich erscheint.
8. Antworte testweise und kontrolliere, ob die Antwort am Testgerät ankommt.

Wenn ein Schritt nicht funktioniert, ändere nur eine Einstellung und teste erneut. So bleibt nachvollziehbar, was den Fehler ausgelöst hat.

## Typische Fehler und ihre Ursache

### Es ist keine Zielnummer auswählbar

Die WhatsApp-Nummer ist noch nicht eingerichtet oder nicht nutzbar. Öffne **Einstellungen → WhatsApp**, schließe die Einrichtung ab und kehre dann zum Widget zurück.

### Das Widget ist in der Vorschau sichtbar, aber nicht auf der Website

Prüfe, ob es in den Einstellungen der konkreten Website oder des konkreten Funnels aktiviert wurde. Bei einer externen Seite kontrolliere, ob der vollständige Code im Kopfbereich eingefügt und die Seite danach veröffentlicht wurde.

### Der Chat öffnet die falsche Nummer

Öffne die Einstellungen des Widgets und kontrolliere die ausgewählte Zielnummer. Speichere die Korrektur und wiederhole den Test in einem privaten Browserfenster.

### Eine Unterhaltung erscheint nicht im Gesprächsbereich

Prüfe zuerst, ob der Test wirklich bis zum Absenden und Öffnen von WhatsApp durchgeführt wurde. Kontrolliere danach die Zielnummer und suche nach der eindeutigen Testnachricht.

### Der Text im Widget weckt falsche Erwartungen

Wenn dort eine sofortige Antwort versprochen wird, obwohl niemand erreichbar ist, passe Titel und Einstiegstext an. Das Widget soll erklären, was tatsächlich als Nächstes geschieht: der Wechsel zu WhatsApp.

## Praxisbeispiel: Beratungsanfrage von der Website

Ein Beratungsunternehmen möchte Anfragen über seine Angebotsseite direkt im Messenger erhalten.

1. Das Team richtet eine WhatsApp-Nummer für Beratungsanfragen ein.
2. Es erstellt ein neues Widget mit dem Titel „Frage zu deiner Beratung?“.
3. Das Formular fragt Name, Telefonnummer und Anliegen ab.
4. Als Zielnummer wird ausschließlich die Beratungsnummer ausgewählt.
5. Das Widget wird auf der Angebotsseite aktiviert.
6. Eine Teamkollegin testet die Seite mit einem Mobiltelefon.
7. Sie prüft, ob WhatsApp mit der Beratungsnummer geöffnet wird und die Testnachricht im Gesprächsbereich erscheint.
8. Erst danach veröffentlicht das Team die Seite für alle Besuchenden.

So landet eine Anfrage nicht in einem allgemeinen Postfach, sondern direkt beim vorgesehenen Team.

## Kurz-Check vor der Veröffentlichung

* Ist WhatsApp aktiviert und eine passende Zielnummer eingerichtet?
* Wurde beim neuen Widget tatsächlich die Chat-Art WhatsApp ausgewählt?
* Sind Titel, Einstiegstext und Schaltflächen-Text für Besuchende verständlich?
* Werden nur notwendige Formularfelder abgefragt?
* Ist die richtige Zielnummer ausgewählt?
* Ist das Widget auf der konkreten Website oder im Funnel aktiviert beziehungsweise korrekt eingebettet?
* Wurde der vollständige Ablauf von der veröffentlichten Seite bis zur Antwort getestet?


---

# 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/kommunikation/telefonie/chat-widget-zu-whatsapp-leiten.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.