HTML und JavaScript

Website vorbereiten#

Öffnen Sie auf der Seite Agent des Agenten Live schalten → Website-Widget, aktivieren Sie Auf meiner Website anzeigen und tragen Sie unter Zulässige Website-Adressen den endgültigen Origin der Host-Seite ein. Fügen Sie Entwicklung und Produktion getrennt hinzu; http://localhost:3000, https://example.com und https://www.example.com stimmen nicht miteinander überein.

Skript installieren#

Fügen Sie den Loader direkt vor dem schließenden </body>-Tag auf jeder Seite ein, auf der der Launcher erscheinen soll. Ersetzen Sie nur den öffentlichen Site-Slug und optionale Darstellungswerte.

<script
  src="https://makeagent.fast/embed.js?v=20261022-open"
  data-agent="YOUR_SITE_SLUG"
  data-position="right"
  async
></script>

data-agent ist erforderlich. Der Slug ist öffentlich; in dieses Tag gehört kein API-Schlüssel. Behalten Sie die ?v=-Query aus dem Snippet im Dashboard bei. Die optionalen Attribute data-label, data-accent (#RGB / #RRGGBB), data-locale (en | ko | uz | ru) und data-theme (light | dark) sind in der Einbettung im Überblick beschrieben. Lassen Sie sie weg, um die gespeicherten Anzeige-Einstellungen und das automatische Theme-Verhalten zu übernehmen.

Websiteweite oder seitenspezifische Platzierung wählen#

Bei einer gemeinsamen serverseitigen Vorlage platzieren Sie das Skript im globalen Layout bzw. Footer. Für ausgewählte Seiten binden Sie es nur in diesen Vorlagen ein. Laden Sie denselben Slug nur einmal pro Dokument; doppelte Tags mit demselben Slug werden ignoriert, doch das Entfernen von Duplikaten hält Zuständigkeit und Abbau nachvollziehbar.

Fügen Sie das Snippet nicht in einen HTML-Sanitizer oder ein Rich-Text-Feld ein, das <script> entfernt. Prüfen Sie im gerenderten Seitenquelltext oder im Elements-Panel, ob das Tag weiterhin vorhanden ist.

In einer SPA entfernen oder neu einbinden#

Das Entfernen des Skripts nach seiner Ausführung entfernt nicht den Launcher, den es bereits erzeugt hat. Eine routenspezifische Client-Anwendung muss vor dem erneuten Einbinden sowohl das Skript als auch das slugspezifische Root-Element entfernen:

const slug = "YOUR_SITE_SLUG";
document.getElementById("maf-agent")?.remove();
document.getElementById(`maf-embed-root-${slug}`)?.remove();

Bevorzugen Sie es, ein websiteweites Root-Element über die clientseitige Navigation hinweg eingebunden zu lassen, damit die aktive Unterhaltung nicht verloren geht. Wenn Sie das Root-Element entfernen, hängen Sie ein neues embed.js-Skript an, um es erneut zu erzeugen.

Im Browser überprüfen#

1. Öffnen Sie die bereitgestellte Seite in einem privaten Fenster.
2. Vergewissern Sie sich, dass embed.js mit 200 antwortet und nicht durch CSP oder Consent blockiert wird.
3. Vergewissern Sie sich, dass genau ein [data-maf-embed="YOUR_SITE_SLUG"]-Root-Element existiert.
4. Öffnen Sie den Launcher und prüfen Sie, ob der iframe /embed/YOUR_SITE_SLUG lädt.
5. Senden Sie eine Frage und prüfen Sie den Thread unter Unterhaltungen.
6. Testen Sie die mobile Breite und die Mikrofonberechtigung, wenn Sprache aktiviert ist.

Fehlerbehebung#

Leiten Sie den Loader niemals über einen Proxy um und kopieren Sie ihn nicht in einen ungeprüften lokalen Fork; verwenden Sie das gehostete Skript, damit die Origin-Validierung und Korrekturen stets aktuell bleiben.