Zum Hauptinhalt springen
DocumentationAPI ReferenceVideo Tutorials

Callback Widget

Das Callback Widget ist ein kleines, einbettbares Formular, mit dem Ihre Website-Besucher ihre Telefonnummer hinterlassen und von Ihrem KI-Agenten zurückgerufen werden können — 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 dem Floating Widget, Pill Widget, Inline Widget und Popup-Widget — er funktioniert jedoch ganz anders. Die übrigen Widgets starten ein Sprachgespräch direkt im Browser. Das Callback Widget stellt einen echten Telefonanruf in eine Warteschlange, den Ihr Agent über Ihre ausgehende Nummer tätigt.

Wann Sie es verwenden sollten​

SzenarioWarum sich das Callback Widget eignet
Lead-Gen-LandingpagesDer Besucher verbindlicht sich mit einer Telefonnummer, der Agent qualifiziert ihn in der nächsten Minute
Produktseiten mit hoher Kaufabsicht„Mit einem Spezialisten sprechen", ohne dass der Besucher selbst wählen muss
Mobile-First-WebsitesEin Tipp auf die Pille, keine Berechtigungsabfrage, keine Kopfhörer nötig
Erreichbarkeit außerhalb der GeschäftszeitenDer Besucher hinterlässt nach Feierabend eine Nummer, der Agent ruft an, sobald die Warteschlange wieder geöffnet ist
Weniger Reibung als bei FormularenBesucher füllen ein einziges Feld aus und erhalten sofort eine Antwort

Voraussetzungen​

Das Callback Widget setzt drei Dinge in Ihrem Konto voraus, bevor es aktiviert werden kann:

VoraussetzungGrund
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 istDer Agent benötigt eine echte Nummer, von der aus er anrufen kann
Verifizierte E-Mail-Adresse in Ihrem WorkspaceBestätigt die Eigentümerschaft, bevor ausgehende Anrufe freigeschaltet werden

Fehlt eine dieser Voraussetzungen, zeigt der Bereich „Callback Widget" im Widgets-Tab des Agenten einen Hinweis an, der Ihnen genau sagt, was zu tun ist. Das Widget bleibt deaktiviert, bis alle drei Bedingungen erfüllt sind.

Free-Tarif

Das Callback 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. Callback am Agenten aktivieren​

  1. Öffnen Sie Ihren Agenten und wechseln Sie in den Widgets-Tab.
  2. Scrollen Sie zum Bereich Callback Widget.
  3. Aktivieren Sie den Schalter „Callback Widget aktivieren".
  4. Konfigurieren Sie folgende Einstellungen:
    • 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 das Formular, die Statusmeldungen und die 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).
  5. Speichern.

Eine Live-Vorschau des Widgets erscheint neben den Einstellungen, sodass Sie Änderungen sofort sehen können — Sie müssen nichts deployen, um das Aussehen zu testen.

2. Embed-Snippet kopieren​

Kopieren Sie im selben Bereich 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.

tipp

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:

ZustandWas der Besucher sieht
FormularSchwebende 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 — 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 / FehlgeschlagenEine 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:

AttributErforderlichBeschreibung
agent-idJaDie eindeutige Kennung Ihres Agenten
localeNeinÜ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.
themeNeinÜberschreibt das Farb-Theme für diese Seite
positionNeinWo 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:

CodeSprache
enEnglish
deDeutsch
frFrançais
esEspañol
itItaliano
ptPortuguês
plPolski
csČeština
huMagyar
trTürkçe
kkҚазақша
zh中文
ruРусский
ukУкраїнська

Die Widget-Sprache wird in folgender Reihenfolge nach Priorität bestimmt:

  1. Das Attribut locale="…" im Embed (höchste Priorität)
  2. Die im Widgets-Tab des Agenten eingestellte Widget-Sprache
  3. Englisch (Standard)
Widget-Sprache ≠ gesprochene Sprache des Agenten

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.

Die richtigen Werte wählen

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 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 den 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 Schleife aus „Agent freigegeben, dann wählen" arbeitet die Warteschlange kontinuierlich ab — die meisten Besucher werden innerhalb weniger Sekunden nach dem Absenden angerufen, sofern Sie nicht nahe an der Parallelitätsgrenze sind.

Es gibt ein Rate-Limit pro Nummer (eine Nummer kann pro Stunde nur eine begrenzte Anzahl von Malen für denselben Agenten in die Warteschlange aufgenommen werden), um Missbrauch zu verhindern. Besucher, die dieses Limit erreichen, sehen statt des Warteschlangen-Bildschirms eine freundliche Nachricht: „Wir melden uns in Kürze bei Ihnen."

Live-Vorschau im Dashboard​

Der Widgets-Tab zeigt eine Live-Vorschau des Callback Widgets neben den Einstellungen an. Jede Änderung — 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', () => {
  // Der Rückruf des Besuchers wurde gerade verbunden — als Conversion erfassen
});

widget.addEventListener('call-end', () => {
  // Rückruf beendet — Dauer, Ergebnis etc. erfassen
});

Tarifverfügbarkeit​

TarifCallback Widget
FreeNicht verfügbar (erfordert ausgehende Anrufe)
Starter / Pro / Business / EnterpriseVerfügbar

Alle bezahlten Tarife erhalten denselben Funktionsumfang des Widgets. Die Kosten pro Anruf folgen Ihrem normalen Outbound-Tarif — siehe Abrechnung.

Verwandte Themen​

  • Website Widgets — Floating, Pill, Inline und Popup-Widget-Typen 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 Callback Widget anrufen wird
  • FAQ — Häufige Fragen und Sonderfälle