Wo finde ich den Embed-Code?
Im Dashboard unter dem Tab „Widget" findest du den Code-Snippet für deinen Agenten. Klick auf das Kopier-Icon — und du hast ihn in der Zwischenablage.
Der Code sieht so aus:
Die data-agent-id ist eindeutig pro Agent — sie wird automatisch eingesetzt. data-position ist optional und steuert die Widget-Position (bottom-right, bottom-left).
Einbau auf WordPress
Drei Wege — vom einfachsten zum flexibelsten:
Mit einem Header-Plugin (empfohlen)
Installiere das Plugin „WPCode Lite" oder „Insert Headers and Footers". Im Plugin-Bereich findest du ein Feld „Scripts in Header" — dort den kopierten Code einfügen und speichern.
Direkt im Theme
Wenn du dein Theme selbst pflegst, im header.php direkt vor dem schließenden </head> einfügen.
Mit Elementor oder Page-Buildern
Bei Elementor: Site-Settings → Custom Code → „Header" auswählen, Code einfügen. Bei Divi: Theme Options → Integration → „Add code to the <head>".
Einbau auf Webflow
In den Project Settings → Custom Code → Bereich „Head Code" den Snippet einfügen und veröffentlichen. Wirkt sofort auf allen Seiten der Site.
Wenn du das Widget nur auf bestimmten Seiten brauchst: Auf der Seite → „Page Settings" → „Custom Code" → „Inside <head> tag".
Einbau auf Framer
In Framer öffnest du Site Settings → General → Custom Code. Im Feld „Start of <head> tag" den Code einfügen. Auch hier: sofort aktiv auf allen Seiten.
Statische Seiten (HTML)
Wenn du eine eigene HTML-Site hast: Den Code direkt in den <head>-Bereich aller Seiten einfügen, auf denen das Widget erscheinen soll.
Für Geschwindigkeit zusätzlich ein preconnect ergänzen:
Das verkürzt den ersten Request um 100–200ms — bei kalten Verbindungen spürbar.
DSGVO-Cookie-Banner integrieren
Das Widget setzt einen funktionalen Cookie und sendet Audio-Daten an unsere EU-Server — daher braucht es Einwilligung in deinem Cookie-Banner.
In den meisten Cookie-Tools (Cookiebot, Usercentrics, Borlabs) trägst du Clickfone als „Funktionaler Cookie" oder „Service" mit folgenden Angaben ein:
| Feld | Wert |
|---|---|
| Service-Name | Clickfone |
| Anbieter | Clickpear Agency |
| Zweck | KI-gestützter Telefon- & Chat-Assistent |
| Datenkategorie | Audio, Telefonnummer (optional), Transkript |
| Datenübermittlung | EU (AWS Frankfurt) |
| Speicherdauer | 30 Tage (Standard), konfigurierbar |
Mehr Details zur DSGVO findest du im Artikel DSGVO-Konformität.
Häufige Probleme
Wenn das Widget nicht erscheint, gehen wir diese Checkliste durch — meistens ist es einer dieser vier Punkte:
- Browser-Konsole prüfen. F12 → Konsole → nach „clickfone" suchen. Fehlermeldungen sind eindeutig.
- Cookie-Banner blockiert? Test mit deaktiviertem Cookie-Consent. Wenn das Widget dann erscheint, fehlt der Eintrag im Cookie-Tool.
- Domain-Whitelist? Im Widget-Tab unter „Erlaubte Domains" deine Domain mit und ohne www. eintragen.
- Content-Security-Policy? Wenn deine Seite eine CSP hat, muss https://widget.clickfone.de in script-src und connect-src stehen.
Detaillierte Diagnose-Schritte gibt's in der Schritt-für-Schritt-Hilfe.
War dieser Artikel hilfreich?
Frage nicht beantwortet?
Schreib uns direkt — wir antworten innerhalb von 24 Stunden an Werktagen.
E-Mail an info@clickfone.de