Widget installieren

Ein einziges Script-Tag. Kein Build-Schritt, kein zu installierendes Paket, keine Framework-Integration.

Das Snippet

<script
  src="https://widget.minaya.ai/widget.js"
  data-site-key="your-site-key"
  data-api-url="https://api.minaya.ai"
  async
></script>

Kopieren Sie die Version mit Ihrem echten Site-Key aus Installation & Einbettung im Dashboard. Platzieren Sie es vor dem schließenden </body>-Tag.

Attribute

Attribut	Erforderlich	Zweck
`src`	Ja	Woher das Script bereitgestellt wird (ein CDN).
`data-site-key`	Ja	Identifiziert Ihr Unternehmen. Öffentlich, funktioniert aber nur auf freigegebenen Domains.
`data-api-url`	Ja	Ihr Minaya-Backend. Getrennt von `src` — Script und API können auf unterschiedlichen Hosts liegen.
`async`	Empfohlen	Verhindert, dass das Script das Rendern der Seite blockiert.

data-api-url muss auf Ihre API zeigen, nicht auf das CDN, das das Script bereitstellt. Zeigt es auf das CDN, liefert jede Anfrage 403, da dieser Host keine API hat.

Hinweise zu Frameworks

Next.js

import Script from "next/script";

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://widget.minaya.ai/widget.js"
          data-site-key="your-site-key"
          data-api-url="https://api.minaya.ai"
          strategy="afterInteractive"
        />
      </body>
    </html>
  );
}

WordPress

Fügen Sie das Snippet in die Footer-Vorlage Ihres Themes ein, oder verwenden Sie ein Plugin für „Header- und Footer-Scripts". Das Hinzufügen zu einem Child-Theme sorgt dafür, dass es Updates übersteht.

Shopify

Fügen Sie es in theme.liquid direkt vor </body> ein.

Single-Page-Apps

Das Widget wird einmal eingebunden und bleibt über die clientseitige Navigation hinweg bestehen. Binden Sie es nicht pro Route erneut ein.

Auch die Regeln aus der Einstellung Seiten folgen der clientseitigen Navigation: Das Widget verschwindet und erscheint beim Routenwechsel ohne Neuladen und behält das Gespräch.

Domain-Freigabeliste

Das Widget funktioniert nur auf Origins, die Sie im Dashboard eintragen. Erfassen Sie jeden Host, den Besucher verwenden:

https://example.com
https://www.example.com
https://staging.example.com

Origins werden exakt abgeglichen, sodass example.com und www.example.com unterschiedliche Einträge sind.

Fehlerbehebung

Symptom	Ursache
`403` bei Anfragen	Origin nicht freigegeben, oder `data-api-url` zeigt auf das CDN.
Es erscheint nichts	Script wurde nicht geladen, oder `data-site-key` fehlt. Konsole prüfen.
Falsche Farben	Die Konfiguration wird kurz zwischengespeichert; nach dem Speichern von Änderungen ein Hard-Reload durchführen.
Widget hinter anderen Elementen	Erhöhen Sie seinen `z-index` über Eigenes CSS.
Eine rote Nachricht im Chat, dass er nicht richtig konfiguriert ist	Der Site-Key passt zu keinem Widget (unter Einbetten erneut kopieren), oder diese Domain steht nicht in den erlaubten Ursprüngen. Die Konsole nennt den Grund.
Eine rote Nachricht, dass der Chat Minaya nicht erreicht	`data-api-url` ist falsch, oder die API ist aus dem Browser des Besuchers nicht erreichbar. Die Nachricht zeigt die versuchte URL.
Nur auf manchen Seiten nichts	Eine Seiten-Regel blendet es dort aus – siehe Platzierung und Verhalten.

Site-Key rotieren

Eine Rotation macht den alten Key sofort ungültig, und jede bestehende Einbettung funktioniert nicht mehr — aktualisieren Sie Ihr Snippet daher im selben Zug.

ZurückEigenes CSS WeiterFrameworks & Plattformen