Website-Widget einrichten

Das UniverX-Widget ist die Schaltfläche, die auf Ihrer Website erscheint und Kunden ermöglicht, einen Videoanruf oder eine Chat-Sitzung mit Ihrem Team zu starten. Dieser Leitfaden führt Sie durch die Erstellung eines Widgets, die Anpassung seines Erscheinungsbilds und das Hinzufügen zur Website.

---

Bevor Sie beginnen

• Sie benötigen die Rolle Admin oder Owner oder gehören zu einer Gruppe mit der Berechtigung Manage widgets.
• Sie müssen mindestens eine aktive Warteschlange eingerichtet haben. Siehe Warteschlangen-Konfiguration.
• Um den Einbettungscode zu Ihrer Website hinzuzufügen, benötigen Sie die Hilfe der Person, die Ihre Website verwaltet (ein Entwickler, Webmaster oder Ihre CMS-Plattform).

---

Widget erstellen

1. Gehen Sie zu Admin console → Widgets.

2. Klicken Sie auf Add widget.

3. Füllen Sie die Registerkarte Basic settings aus:

   Feld	Beschreibung
   Domain (erforderlich)	Die Website-Domain, auf der das Widget erscheinen wird, z. B. yourcompany.com
   Widget active	Schalten Sie dies ein, um das Widget sofort zu aktivieren

4. Klicken Sie auf die Registerkarte Queue und wählen Sie aus, zu welcher Warteschlange dieses Widget Kunden weiterleitet.

5. Klicken Sie auf Save changes.

Tipp

Erstellen Sie ein separates Widget für jede Domain oder Subdomain, auf der Sie das Widget anzeigen möchten. Ein Widget = eine Domain.

---

Widget konfigurieren

Nach der Erstellung können Sie das Widget weiter konfigurieren. Klicken Sie auf das Bearbeitungssymbol neben einem beliebigen Widget, um das Konfigurationsfenster zu öffnen. Das Fenster hat fünf Registerkarten:

Basic settings

Feld	Beschreibung
Domain	Die Domain, für die dieses Widget autorisiert ist
Widget active	Ob das Widget auf Ihrer Website live ist

Queue

Wählen Sie aus, welche Warteschlange Kunden von diesem Widget weiterleitet. Wenn Sie die Warteschlange ändern, wird das Widget neue Kunden sofort zur neuen Warteschlange weiterleiten.

Precall form

Ein Formular vor dem Anruf sammelt Informationen vom Kunden, bevor er mit einem Agenten verbunden wird – zum Beispiel seinen Namen, den Grund für den Anruf oder die Kontonummer.

1. Wählen Sie eine Formularvorlage aus dem Dropdown-Menü aus oder lassen Sie es leer, um das Formular vor dem Anruf zu überspringen.
2. Siehe Formular-Builder, um zu erfahren, wie Sie Formularvorlagen erstellen.

Appearance

Passen Sie das Erscheinungsbild des Widgets an, um es Ihrer Marke anzupassen:

Einstellung	Optionen / Beschreibung
Position	Bottom right, Bottom left, Top right, Top left
Company name	Wird im Widget-Header angezeigt
Show company name	Schalter zum Ein-/Ausblenden
Logo URL	URL Ihres Firmenlogos (optional)
Show logo	Schalter zum Ein-/Ausblenden
Welcome message	Begrüßungstext, der dem Kunden angezeigt wird
Button text	Beschriftung auf der Start-Schaltfläche
Placeholder text	Hinweistext in Eingabefeldern
Primary color	Hauptmarkenfarbe (Hex-Code)
Secondary color	Akzentfarbe
Background color	Widget-Hintergrundfarbe
Text color	Farbe des Textes im Widget
Border radius	None, Small, Medium, Large, Extra large
Font family	Arial, Helvetica, Georgia, Times New Roman, Roboto, Inter
Button style	Rounded, Square, Pill
Animation speed	Slow, Normal, Fast
Auto-open widget	Öffnet das Widget automatisch beim Laden der Seite
Enable sound	Spielt einen Ton ab, wenn eine neue Nachricht eintrifft
Enable notifications	Aktiviert Browser-Benachrichtigungen
Enable file upload	Ermöglicht Kunden das Hochladen von Dateien
Max message length	Maximale Zeichen pro Kundennachricht

Tipp

Verwenden Sie die Hex-Farbcodes Ihrer Marke für die primären und Textfarben, um das Widget konsistent mit Ihrem Website-Design zu halten. Ihr Marketing- oder Design-Team kann diese bereitstellen.

Embed code

Sobald Ihr Widget konfiguriert ist, müssen Sie den Einbettungscode zu Ihrer Website hinzufügen.

1. Klicken Sie auf die Registerkarte Embed code im Widget-Konfigurationsfenster.
2. Sie sehen einen Code-Ausschnitt.
3. Klicken Sie auf Copy code, um ihn in Ihre Zwischenablage zu kopieren.
4. Senden Sie diesen Code mit den unten stehenden Anweisungen an Ihren Website-Administrator.

---

Widget zur Website hinzufügen

Für Ihren Website-Administrator:

Fügen Sie den kopierten Einbettungscode in das HTML jeder Seite ein, auf der das Widget erscheinen soll – typischerweise kurz vor dem schließenden </body>-Tag. Das Widget erscheint automatisch, sobald der Code vorhanden ist.

Achtung

Der Einbettungscode ist eindeutig für Ihre Domain. Verwenden Sie ihn nicht auf einer anderen Domain als der in den Widget-Einstellungen konfigurierten. Wenn Sie das Widget auf mehreren Domains benötigen, erstellen Sie ein separates Widget für jede.

---

Domain-Eigentümerschaft verifizieren

UniverX kann von Ihnen verlangen, dass Sie nachweisen, dass Sie die Domain besitzen, auf der das Widget installiert ist. Es gibt drei Verifizierungsmethoden:

Methode	Wie es funktioniert
DNS verification	Fügen Sie einen DNS-TXT-Eintrag zu den DNS-Einstellungen Ihrer Domain hinzu
File verification	Laden Sie eine Verifizierungsdatei in das Stammverzeichnis Ihrer Website hoch
Meta tag verification	Fügen Sie ein Meta-Tag zum <head>-Bereich Ihrer Homepage hinzu

Ihr Website-Administrator oder IT-Team kann die Domain-Verifizierung abschließen. Der Widget-Editor zeigt den Status als Verified oder Not verified an.

---

Widget testen

Testen Sie das Widget vor der Live-Schaltung, um sicherzustellen, dass es lädt und korrekt weiterleitet:

1. Gehen Sie zu Admin console → Widgets.
2. Klicken Sie auf Test widget neben dem Widget, das Sie testen möchten.
3. Das Widget öffnet sich in einer Testumgebung. Überprüfen Sie, dass:
   • Das Widget an der richtigen Position erscheint
   • Ihr Branding (Farben, Logo, Willkommensnachricht) korrekt angezeigt wird
   • Das Formular vor dem Anruf erscheint, falls konfiguriert
   • Das Routing zur korrekten Warteschlange verbindet

Tipp

Bitten Sie einen Kollegen, den vollständigen Ablauf aus der Perspektive des Kunden zu testen – vom Klicken auf das Widget bis zur Verbindung mit einem Agenten.

---

Widget aktivieren oder deaktivieren

Sie können ein Widget pausieren, ohne es zu löschen. Dies ist nützlich während Wartungszeiten.

1. Gehen Sie zu Admin console → Widgets.
2. Klicken Sie auf das Bearbeitungssymbol neben dem Widget.
3. Schalten Sie Widget active ein oder aus.
4. Klicken Sie auf Save changes.

Status	Bedeutung
Active	Widget ist live und akzeptiert Kundensitzungen
Inactive	Widget ist verborgen; Kunden können keine Sitzungen starten
Maintenance	Widget ist vorübergehend ausgesetzt

---

Widget löschen

1. Gehen Sie zu Admin console → Widgets.
2. Klicken Sie auf die Option Delete widget in der Spalte Actions.
3. Bestätigen Sie das Löschen.

Achtung

Das Löschen eines Widgets entfernt es aus UniverX. Allerdings wird jeder Einbettungscode, der bereits auf Ihrer Website vorhanden ist, nicht mehr funktionieren. Bitten Sie Ihren Website-Administrator, den Einbettungscode nach dem Löschen von Ihrer Website zu entfernen.

---

Widget-Einrichtungs-Checkliste

Verwenden Sie diese Checkliste, um zu bestätigen, dass Ihr Widget bereit ist, bevor Sie live gehen:

• Widget mit korrekter Domain erstellt
• Warteschlange dem Widget zugewiesen
• Erscheinungsbild mit Ihrem Branding angepasst
• Formular vor dem Anruf konfiguriert (oder absichtlich leer gelassen)
• Einbettungscode kopiert und zur Website hinzugefügt
• Domain-Verifizierung abgeschlossen (falls erforderlich)
• Widget-Status auf Active gesetzt
• Test-Widget ausgeführt und Ergebnisse sehen korrekt aus
• Ein Kollege hat den vollständigen Kundenablauf Ende-zu-Ende getestet

---

Fehlerbehebung

Das Widget erscheint nicht auf meiner Website. Überprüfen Sie, dass:

• Der Einbettungscode korrekt in jede Seite eingefügt wurde, kurz vor dem schließenden </body>-Tag.
• Das Widget in der Admin console auf Active gesetzt ist.
• Die Domain in den Widget-Einstellungen genau mit der Domain Ihrer Website übereinstimmt (einschließlich oder ausschließlich www, je nach Bedarf).

Das Widget erscheint, aber keine Agenten erhalten Anfragen. Stellen Sie sicher, dass die mit diesem Widget verknüpfte Warteschlange Active ist und Agenten zugewiesen hat. Siehe Warteschlangen-Konfiguration.

Das Widget wird angezeigt, aber das Formular vor dem Anruf erscheint nicht. Überprüfen Sie, dass Sie eine Formularvorlage auf der Registerkarte Precall form der Widget-Einstellungen ausgewählt haben und dass die Formularvorlage auf Active gesetzt ist. Siehe Formular-Builder.

Die Domain wird als “Not verified” angezeigt. Folgen Sie den Domain-Verifizierungsschritten und bitten Sie Ihren Website-Administrator oder Ihr IT-Team, die erforderliche DNS-, Datei- oder Meta-Tag-Verifizierung abzuschließen.

---

Formular-Builder Formularvorlagen vor dem Anruf erstellen, um Kundeninformationen zu sammeln.