Widget wird nicht angezeigt

Wenn das Conviro-Chat-Widget auf Ihrer Website nicht erscheint, arbeiten Sie diese Checkliste Schritt für Schritt durch.

1. Embed Code prüfen

• Öffnen Sie Dashboard -> Assistants -> Ihr Bot -> Embed Code.
• Kopieren Sie das aktuelle Snippet und stellen Sie sicher, dass es korrekt in Ihrem HTML platziert ist.
• Das Script-Tag muss vor dem schließenden \</body\>-Tag stehen (nicht im \<head\>).
• Achten Sie darauf, dass es keine Tippfehler oder fehlenden Zeichen gibt.

2. Public Key prüfen

• Prüfen Sie, ob der Wert publicKey im Embed Code mit dem im Dashboard angezeigten Schlüssel übereinstimmt.
• Public Keys beginnen mit pk_.
• Wenn Sie den Schlüssel neu generiert haben, aktualisieren Sie den Embed Code auf Ihrer Website.

3. Domain-Allowlist prüfen

• Öffnen Sie Dashboard -> Assistants -> Ihr Bot -> Channels.
• Stellen Sie sicher, dass die Domain Ihrer Website in der Liste Allowed Domains steht.
• Nehmen Sie alle Varianten auf: example.com, www.example.com und localhost für die Entwicklung.
• Geben Sie das Protokoll (https://) nicht an – nur den Domainnamen.

4. Prüfen, ob der Bot aktiv ist

• Öffnen Sie Dashboard -> Assistants.
• Der Status Ihres Bots muss Active sein (grüne Anzeige).
• Ist er pausiert oder inaktiv, klicken Sie darauf, um ihn zu aktivieren.

5. Auf JavaScript-Fehler prüfen

• Öffnen Sie Ihre Website in einem Browser.
• Drücken Sie F12 (oder Rechtsklick -> Inspect), um die Developer Tools zu öffnen.
• Wechseln Sie zum Tab Console.
• Suchen Sie nach Fehlern, die Conviro oder das Widget betreffen:
• Widget init failed – Problem mit Public Key oder Domain
• 403 Forbidden – Domain steht nicht in der Allowlist
• 404 Not Found – die URL des Widget-Scripts ist falsch
• net::ERR_BLOCKED_BY_CLIENT – ein Adblocker blockiert das Script

6. Adblocker deaktivieren

Adblocker (uBlock Origin, AdBlock Plus, Brave Shields) können das Widget-Script blockieren.

• Deaktivieren Sie den Adblocker vorübergehend und laden Sie die Seite neu.
• Erscheint das Widget, nehmen Sie Ihre Domain in den Einstellungen des Adblockers auf die Whitelist.

7. Caching prüfen

• Wenn Sie ein Caching-Plugin verwenden (WP Super Cache, Cloudflare usw.), leeren Sie den Cache, nachdem Sie den Embed Code eingefügt haben.
• Laden Sie die Seite testweise in einem Inkognito-/privaten Browserfenster, um den Cache zu umgehen.

8. Auf Script-Konflikte prüfen

• Andere Chat-Widgets oder JavaScript-Bibliotheken können mit Conviro in Konflikt geraten.
• Prüfen Sie die Console auf Fehler anderer Scripts.
• Entfernen Sie andere Chat-Widgets testweise, um das Problem einzugrenzen.

9. Content Security Policy (CSP)

Wenn Ihre Website eine strikte Content Security Policy hat, müssen Sie möglicherweise Folgendes erlauben:

• script-src: cdn.conviro.io
• connect-src: api.conviro.io
• frame-src: cdn.conviro.io

10. Funktioniert es immer noch nicht?

Wenn keiner der oben genannten Punkte das Problem löst:

• Erstellen Sie einen Screenshot der Fehler in der Console.
• Notieren Sie die URL Ihrer Website, Ihren Browser und Ihr Betriebssystem.
• Wenden Sie sich mit diesen Angaben an den Support unter [email protected].