Rückruf-Widget
Das Rückruf-Widget ist ein kleines, einbettbares Formular, mit dem Ihre Website-Besucher ihre Telefonnummer hinterlassen und von Ihrem KI-Agenten zurückgerufen werden — in der Regel innerhalb von Sekunden. Statt Besucher zum Selbstanrufen aufzufordern, kommt das Gespräch zu ihnen.
Dies ist der fünfte Widget-Typ, neben den Widgets Floating, Pill, Pill Floating und Inline — er funktioniert jedoch ganz anders. Die übrigen Widgets starten ein Sprachgespräch direkt im Browser. Das Rückruf-Widget stellt einen echten Telefonanruf in eine Warteschlange, den Ihr Agent über Ihre ausgehende Nummer tätigt.
Wann Sie es verwenden sollten
| Szenario | Warum sich das Rückruf-Widget eignet |
|---|---|
| Lead-Gen-Landingpages | Der Besucher verbindet sich mit einer Telefonnummer, der Agent qualifiziert ihn in der nächsten Minute |
| Produktseiten mit hoher Kaufabsicht | „Mit einer Fachkraft sprechen", ohne dass der Besucher selbst wählen muss |
| Mobile-First-Websites | Ein Tipp auf die Pille, keine Berechtigungsabfrage, keine Kopfhörer nötig |
| Erreichbarkeit außerhalb der Geschäftszeiten | Der Besucher hinterlässt nach Feierabend eine Nummer, der Agent ruft an, sobald die Warteschlange wieder öffnet |
| Weniger Reibung als bei Formularen | Besucher füllen ein einziges Feld aus und erhalten sofort eine Antwort |
Voraussetzungen
Das Rückruf-Widget setzt drei Dinge in Ihrem Konto voraus, bevor es aktiviert werden kann:
| Voraussetzung | Grund |
|---|---|
| Bezahlter Tarif (Starter oder höher) | Die während des Rückrufs verbrauchten Outbound-Minuten werden minutengenau abgerechnet |
| Verifizierte ausgehende Telefonnummer, die dem Agenten zugewiesen ist | Der Agent benötigt eine echte Nummer, von der aus er anrufen kann |
| Verifizierte E-Mail-Adresse in Ihrem Workspace | Bestätigt die Eigentümerschaft, bevor ausgehende Anrufe freigeschaltet werden |
Fehlt eine dieser Voraussetzungen, zeigt der Abschnitt „Rückruf-Widget" im Widgets-Tab des Agenten einen Hinweis an, der Ihnen genau sagt, was zu beheben ist. Das Widget bleibt deaktiviert, bis alle drei Bedingungen erfüllt sind.
Das Rückruf-Widget ist im Free-Tarif nicht verfügbar, da es ausgehende Telefonanrufe tätigt. Alle anderen Widget-Typen (Floating, Pill, Inline) bleiben kostenlos.
Einrichtung
1. Rückruf am Agenten aktivieren
- Öffnen Sie Ihren Agenten und wechseln Sie in den Widgets-Tab.
- Scrollen Sie zum Abschnitt Rückruf-Widget.
- Aktivieren Sie den Schalter „Rückruf-Widget aktivieren".
- Konfigurieren Sie Folgendes:
- Wiederholungsversuche — wie oft der Agent erneut anruft, wenn der Besucher nicht abhebt (1–5, Standard 3).
- Wiederholungsintervall — Minuten zwischen den Versuchen (1–30, Standard 5).
- Widget-Sprache — die Sprache, in der Formular, Statusmeldungen und Länderauswahl mit Ihrem Besucher kommunizieren (14 Sprachen verfügbar — siehe unten).
- Theme — Farbschema für die schwebende Pille und den Dialog (verwendet dieselbe Theme-Palette wie die übrigen Widgets).
- Speichern.
Eine Live-Vorschau des Widgets erscheint neben den Einstellungen, sodass Sie Ihre Änderungen sofort sehen — Sie müssen nichts deployen, um das Aussehen zu testen.
2. Embed-Snippet kopieren
Kopieren Sie im selben Abschnitt das HTML-Snippet:
<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>
Fügen Sie es einmal in Ihre Website ein, üblicherweise direkt vor </body>. Das Widget erscheint als schwebende Pille in der Ecke der Seite.
Der Tag @latest sorgt dafür, dass Ihre Website automatisch neue Widget-Versionen erhält, sobald diese veröffentlicht werden. Pinnen Sie eine bestimmte Version an (z. B. hanc-webrtc-widgets@1.4.0), wenn Sie die volle Kontrolle über Upgrades behalten möchten.
Was der Besucher sieht
Das Widget führt Besucher durch vier Zustände:
| Zustand | Was der Besucher sieht |
|---|---|
| Formular | Schwebende Pille in der Ecke. Zum Öffnen anklicken. Länderauswahl links, Eingabefeld für die Telefonnummer rechts, Absenden-Schaltfläche. |
| In Warteschlange | „Sie sind in der Warteschlange — noch etwa N Sekunden, bis wir Sie anrufen." Aktualisiert sich live. |
| Wählt | „Wir rufen Sie jetzt an." Bleibt sichtbar, bis der Anruf zustande kommt oder fehlschlägt. |
| Abgeschlossen / Fehlgeschlagen | Eine kurze Bestätigung oder eine freundliche Fehlermeldung mit dem Hinweis „Seite neu laden, um einen weiteren Rückruf anzufordern". |
Das Formular validiert die Telefonnummer automatisch gegen das nationale Format des gewählten Landes und verweigert das Absenden, solange die Nummer nicht plausibel ist.
Länderabdeckung
Die Länderauswahl deckt Europa (EU + DACH + UK), Nordamerika (USA + Kanada) sowie eine kuratierte Auswahl weiterer gut unterstützter Länder ab. Jedes Land zeigt Flagge, Namen und einen Beispielplatzhalter im jeweiligen Landesformat, damit der Besucher weiß, was er eingeben soll.
Wenn ein Land, das Ihre Besucher nutzen, nicht aufgeführt ist, wenden Sie sich an support@hanc.ai — die Abdeckung wird regelmäßig erweitert.
HTML-Attribute
Das Widget akzeptiert folgende Attribute am <hanc-ai-callback>-Tag:
| Attribut | Erforderlich | Beschreibung |
|---|---|---|
agent-id | Ja | Die eindeutige Kennung Ihres Agenten |
locale | Nein | Überschreibt die UI-Sprache des Widgets für diese Seite (z. B. locale="de"). Nützlich, wenn Ihre Website mehrsprachig ist und die Seitensprache nicht zur Standardsprache des Agenten passt. |
theme | Nein | Überschreibt das Farb-Theme für diese Seite |
position | Nein | Wo die schwebende Pille verankert wird (bottom-right, bottom-left, top-right, top-left) |
Alles, was Sie weglassen, fällt auf die Konfiguration zurück, die Sie am Agenten im Dashboard gesetzt haben.
Beispiel: deutschsprachige Seite auf einer mehrsprachigen Website
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
Der Pillen-Text, die Dialog-Beschriftungen, die Länderauswahl und die Statusmeldungen wechseln allesamt ins Deutsche. Der Agent selbst spricht weiterhin in der Sprache, für die er konfiguriert ist — locale wirkt sich ausschließlich darauf aus, was der Besucher auf der Seite liest.
Widget-Sprache
Die Widget-UI wird mit 14 vorinstallierten Sprachen ausgeliefert:
| Code | Sprache |
|---|---|
en | English |
de | Deutsch |
fr | Français |
es | Español |
it | Italiano |
pt | Português |
pl | Polski |
cs | Čeština |
hu | Magyar |
tr | Türkçe |
kk | Қазақша |
zh | 中文 |
ru | Русский |
uk | Українська |
Der Agent wählt seine Sprache in folgender Reihenfolge nach Priorität:
- Das Attribut
locale="…"im Embed (höchste Priorität) - Die im Widgets-Tab des Agenten eingestellte Widget-Sprache
- Englisch (Standard)
Die Widget-Sprache wirkt sich nur auf den Bildschirmtext aus, den der Besucher liest — Beschriftungen, Länderauswahl, Statusmeldungen. Das eigentliche Sprachgespräch findet in der Sprache statt, für die Ihr Agent konfiguriert ist.
Wiederholungsverhalten
Wenn der Besucher beim ersten Versuch nicht abhebt, wartet der Agent das konfigurierte Intervall ab und wählt erneut — bis zur konfigurierten Anzahl an Versuchen.
- Versuche: 1–5 (Standard 3)
- Intervall: 1–30 Minuten (Standard 5)
Das Widget zeigt dem Besucher den Status jedes Versuchs an. Schlagen alle Versuche fehl, wechselt das Widget in den Zustand „Wir konnten Sie nicht erreichen" mit einer höflichen Nachricht.
Drei Versuche im Abstand von fünf Minuten funktionieren bei den meisten Lead-Gen-Seiten gut — schnell genug, dass der Besucher noch auf der Seite ist, und gleichzeitig zurückhaltend genug, um nicht aufdringlich zu wirken. Erhöhen Sie die Werte, wenn Ihre Zielgruppe dazu neigt, unbekannte Nummern zu ignorieren.
Ein Rückruf pro Seitenaufruf
Sobald ein Besucher seine Nummer übermittelt hat, sperrt sich das Widget für den Rest des Seitenlebenszyklus:
- Das Schließen des Dialogs klappt die Pille ein, setzt jedoch nicht das Formular zurück.
- Beim erneuten Öffnen wird der aktuelle Zustand angezeigt (in Warteschlange / wählt / abgeschlossen / fehlgeschlagen) und nicht ein frisches Formular.
- Um einen zweiten Rückruf zu veranlassen, muss der Besucher die Seite neu laden.
So werden versehentliche Doppelübermittlungen verhindert, während bereits ein Anruf unterwegs ist. Bricht der Besucher seinen in der Warteschlange befindlichen Rückruf ausdrücklich über den Dialog ab (Schaltfläche „Abbrechen" im Warteschlangen-Bildschirm), wird die Sperre aufgehoben, und er kann sofort erneut absenden.
Was passiert beim Neuladen während eines laufenden Rückrufs?
Lädt ein Besucher die Seite neu, während der Agent noch versucht, seine Nummer zu erreichen, erkennt das Widget, dass für dieselbe Nummer bereits ein aktiver Rückruf existiert, und verbindet sich stillschweigend wieder mit diesem — kein doppelter Wählvorgang, kein zweiter Eintrag in der Warteschlange. Der Besucher sieht einfach seinen bestehenden Status genau dort weiterlaufen, wo er ihn verlassen hat.
Parallelität und Durchsatz
Ein einzelner Agent kann bis zu 10 gleichzeitig laufende Rückrufe bearbeiten. Übermittlungen darüber hinaus warten in der Warteschlange und werden gewählt, sobald wieder Kapazität frei wird.
Die Warteschlange wird kontinuierlich abgearbeitet — die meisten Besucher werden innerhalb weniger Sekunden nach dem Absenden angerufen, sofern Sie nicht nahe an der Parallelitätsgrenze sind.
Spam- und Missbrauchsschutz
Das Rückruf-Widget tätigt echte Telefonanrufe, daher verfügt es über eingebaute Schutzmechanismen, die schädlichen Traffic davon abhalten, Ihre Rechnung in die Höhe zu treiben. Diese arbeiten automatisch — es gibt nichts für Sie zu konfigurieren.
| Schutzmechanismus | Was der Besucher erlebt |
|---|---|
| „Ich bin kein Roboter"-Prüfung | Wenn der Missbrauchsschutz auf der Plattform aktiviert ist, durchläuft der Besucher ein schnelles Google reCAPTCHA, bevor der Rückruf in die Warteschlange aufgenommen wird. Echte Besucher schaffen es in einer Sekunde; Bots werden gestoppt. |
| Nummernvalidierung | Das Formular verweigert das Absenden einer Nummer, die nicht plausibel zum gewählten Land passt, sodass Tippfehler und unsinnige Nummern nie gewählt werden. |
| Sonderrufnummern & Nummern außerhalb der Abdeckung | Sonderrufnummern, einige VoIP-Bereiche und Nummern außerhalb der unterstützten Abdeckung werden nicht per Telefon zurückgerufen. Wenn der Browser des Besuchers es unterstützt, bietet das Widget stattdessen einen Sprachanruf im Browser an; andernfalls sieht er eine höfliche Meldung „diese Nummer können wir nicht anrufen". So wird verhindert, dass das Widget missbraucht wird, um teure Sonderrufnummern zu wählen. |
| Limit für wiederholte Übermittlungen | Dieselbe Nummer kann pro Stunde nur eine begrenzte Anzahl von Malen für einen Agenten in die Warteschlange aufgenommen werden. Besucher, die das überschreiten, sehen statt des Warteschlangen-Bildschirms eine freundliche Nachricht „wir melden uns in Kürze bei Ihnen". |
Diese Schutzmechanismen existieren, weil ein öffentliches Rückruf-Formular ein offensichtliches Ziel für Missbrauch ist — andernfalls könnte jemand es auf Sonderrufnummern richten oder es mit Bots bombardieren, um Ihre ausgehenden Minuten zu verbrennen. Die Schutzmechanismen laufen unauffällig im Hintergrund; normale Besucher bemerken sie nie.
Live-Vorschau im Dashboard
Der Widgets-Tab zeigt eine Live-Vorschau des Rückruf-Widgets neben den Einstellungen an. Jede Änderung, die Sie vornehmen — Theme, Sprache, Anzahl der Wiederholungen — aktualisiert die Vorschau sofort. Sie müssen Ihre Website nicht deployen, um zu sehen, wie das Widget aussehen wird.
Die Vorschau verwendet ein Mock-Manifest mit der vollständigen Länderliste und einer Demo-Berechtigung, sodass das Widget auch in Tarifen gerendert wird, in denen ausgehende Rückrufe noch nicht verfügbar sind.
Eingebettetes Tracking
Das Widget sendet dieselben call-start- und call-end-Events wie die übrigen Widgets. Hören Sie sie in JavaScript ab, wenn Sie eigene Analytics auslösen möchten:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Visitor's callback was just connected — track as conversion
});
widget.addEventListener('call-end', () => {
// Callback finished — track duration, outcome, etc.
});
Tarifverfügbarkeit
| Tarif | Rückruf-Widget |
|---|---|
| Free | Nicht verfügbar (erfordert ausgehende Anrufe) |
| Starter / Pro / Business / Enterprise | Verfügbar |
Alle bezahlten Tarife erhalten denselben Funktionsumfang des Widgets. Die Kosten pro Anruf folgen Ihrem normalen Outbound-Tarif — siehe Abrechnung.
Verwandt
- Website-Widgets — Widget-Typen Floating, Pill, Pill Floating und Inline für Gespräche im Browser
- Einstellungen — Anrufeinstellungen auf Agentenebene, einschließlich der maximalen Anrufdauer, die auch für Rückrufe gilt
- Telefonnummern — Die ausgehende Nummer verbinden, von der aus Ihr Rückruf-Widget anrufen wird
- FAQ — Häufige Fragen und Sonderfälle