Olotalk zu WordPress hinzufügen

WordPress hat kein einzelnes Feld für Custom Code. Die zuverlässigen Wege sind deshalb ein Footer-Hook oder ein Header-/Footer-Plugin.

Sie benötigen Ihre Assistant-ID (ast_oltk_…) aus dem Schritt Installation Ihres Assistants. Ganz neu? Starten Sie mit dem Schnellstart.


Am einfachsten: das offizielle Olotalk-Plugin

  1. Öffnen Sie in wp-admin Plugins → Installieren und suchen Sie nach Olotalk.
  2. Installieren und aktivieren Sie Olotalk Grounded AI Assistant.
  3. Gehen Sie zu Einstellungen → Olotalk und klicken Sie auf Connect to Olotalk.
  4. Melden Sie sich an, bestätigen Sie die Website und wählen Sie einen Assistant. Die Assistant-ID trägt sich von selbst ein.

Keine Theme-Dateien, nichts zum Kopieren und keine ID zum Suchen. Das Plugin speichert Ihre Assistant-ID und deren Anzeigenamen und entfernt beides wieder, sobald Sie das Plugin löschen.

Was beim Verbinden übermittelt wird

Bevor etwas übergeben wird, zeigt Ihnen Olotalk, welche Website anfragt und was sie genau erhält: die ID und den Anzeigenamen des Assistants und sonst nichts. Kein Kontozugriff, kein API-Schlüssel und keine Ihrer Inhalte.

Gehört die Domain dieser Website noch zu keiner Domain in Ihrem Olotalk-Konto, erhalten Sie eine Warnung, die sie benennt, und müssen bestätigen, dass Sie sie kennen. In jedem Fall schickt Olotalk Ihnen eine E-Mail, sobald eine Verbindung zustande kommt, damit eine Verbindung, die Sie nicht gestartet haben, nicht unbemerkt bleibt.

Wenn das Verbinden nicht funktioniert

Was Sie sehenWas passiert istWas zu tun ist
Dieser Verbindungslink ist unvollständig oder fehlerhaftDer Link kam ohne alle nötigen Angaben bei Olotalk an, meist weil er aus dem Verlauf oder einer E-Mail geöffnet statt in wp-admin ausgelöst wurde.Beginnen Sie erneut unter Einstellungen → Olotalk.
Verbindungscode abgelaufen oder bereits verwendetEine Verbindung gilt wenige Minuten und lässt sich nur einmal einlösen.Klicken Sie erneut auf Connect to Olotalk.
Bestätigen Sie, dass Sie die Website kennenDie Domain gehört zu keiner Domain in Ihrem Olotalk-Konto.Setzen Sie das Häkchen, wenn die Website Ihnen gehört. Andernfalls schließen Sie die Seite, es wurde noch nichts übermittelt.
Website-Adresse und Admin-Adresse liegen auf verschiedenen DomainsWordPress-Adresse und Website-Adresse verweisen auf unterschiedliche Hosts, was eine Verbindung nicht überbrücken kann.Fügen Sie die Assistant-ID stattdessen von Hand ein.
Die Schaltfläche tut nichts, oder der Rücksprung kommt nie anEin Sicherheits-Plugin, eine SSO-Schicht oder ein Managed Host hat die Weiterleitung blockiert.Fügen Sie die Assistant-ID stattdessen von Hand ein.

Zum Verbinden und zum Ändern dieser Einstellungen ist die Rolle Administrator erforderlich; allen anderen wird die Schaltfläche nicht angezeigt.

Das Feld für die Assistant-ID bleibt immer verfügbar. Beide Wege führen zum selben Ergebnis, und das Einfügen der ID ist der verlässliche Rückfallweg. Über Einstellungen → Olotalk können Sie die Schaltfläche auch ganz ausblenden, wenn Ihr Team ausschließlich eine ID einfügen soll.

Wenn Sie kein Plugin installieren möchten oder bereits ein Header-/Footer-Plugin verwenden, funktionieren die manuellen Wege unten genauso gut.


Alternative: ein Headers-&-Footers-Plugin

Wenn Sie keine Theme-Dateien anfassen möchten, installieren Sie ein Plugin, das rohes HTML injiziert. Häufig verwendet werden WPCode oder Insert Headers and Footers.

  1. Installieren und aktivieren Sie das Plugin.
  2. Öffnen Sie seine Einstellungen, z. B. Code Snippets → Header & Footer oder Settings → Insert Headers and Footers.
  3. Fügen Sie das Snippet in das Feld Footer oder Body ein und speichern Sie:
<script
  src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
  data-olotalk-assistant-id="YOUR_ASSISTANT_ID"
  async
></script>

Diese Plugins geben das Snippet unverändert aus. Die data-olotalk-*-Attribute bleiben also erhalten.

<html>
<head> … </head>
<body>
… your page …
Ziel<script src="…/loader.iife.js" data-olotalk-assistant-id="…" async></script>
</body>
</html>
Fügen Sie das Snippet in dem Footer-/Body-Feld des Plugins ein. Egal, wo eine Plattform es platziert: Das Ziel ist immer dasselbe. Es lädt direkt vor dem schließenden Body-Tag.

Wenn Sie Ihr eigenes Child-Theme oder ein site-spezifisches Plugin pflegen, hängen Sie den Loader an wp_footer:

// functions.php (Child-Theme oder site-spezifisches Plugin)
add_action( 'wp_footer', function () {
  ?>
  <script
    src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
    data-olotalk-assistant-id="YOUR_ASSISTANT_ID"
    async
  ></script>
  <?php
} );

Verwenden Sie kein einfaches wp_enqueue_script() für den Loader. Der Assistant braucht die data-olotalk-*-Attribute auf dem generierten <script>-Tag; wenn Sie manuell enqueuen, hängen Sie sie mit dem Filter script_loader_tag an. Andernfalls nutzen Sie das rohe wp_footer-Snippet oben oder ein Header-/Footer-Plugin.


Ihre Domain erlauben

Fügen Sie die Domain Ihrer Site unter Installationsdomains Ihres Assistants hinzu. Wenn Sie auf einer Preview-URL unter *.wordpress.com oder *.wpcomstaging.com veröffentlichen, tragen Sie diese ebenfalls ein.

Wenn ein Caching-Plugin wie WP Rocket, W3 Total Cache oder LiteSpeed eine Option wie „delay JavaScript execution“ aktiviert hat, schließen Sie olotalk davon aus. Andernfalls lädt der Launcher erst, nachdem der Besucher mit der Seite interagiert.


Prüfen

Öffnen Sie Ihre veröffentlichte Site und suchen Sie unten rechts nach dem Chat-Launcher. Prüfen Sie anschließend Ihr Dashboard: Die Karte Installationsstatus im Schritt Installation zeigt Erkannt auf ihredomain.com, sobald das Snippet lädt, mit Korrektur per Klick, falls die Domain noch nicht erlaubt ist. Nichts zu sehen? Dann schauen Sie in Troubleshooting.