AZAMOL AI-ASSISTENT

Assistenten auf Ihrer Website einbinden

Fünf Schritte, im Schnitt zehn bis fünfzehn Minuten. Die Schritte gelten unabhängig von Theme, Plugins oder Hosting-Anbieter Ihrer Website.

Was Sie vor dem Start brauchen

Ihr öffentlicher Schlüssel — eine kurze Zeichenfolge, die mit az_pk_ beginnt. Sie finden ihn im Tab "Einbettungscode" Ihres Assistenten-Panels.
Die Domain Ihrer Website — die Adresse, auf der Ihr Assistent laufen soll (z. B. beispiel.de).
Zugriff auf das HTML Ihrer Website — ein Theme-Editor, ein Custom-Code-Bereich oder ein Plugin.

Assistenten-Panel öffnen

Ihr Schlüssel ist nicht geheim

Der öffentliche Schlüssel ist im Quellcode Ihrer Seite sichtbar — das ist normal. Für sich allein bewirkt er nichts: Der Assistent öffnet sich nur auf von Ihnen verifizierten Domains. Kopiert jemand Ihren Schlüssel auf eine andere Seite, erscheint der Assistent dort schlicht nicht.

Einrichtung

Domain verifizieren
Fügen Sie in Ihrem Assistenten-Panel im Tab "Domains" die Domain hinzu, auf der der Assistent laufen soll. Sie können zwischen zwei Verifizierungsmethoden wählen: einem für Ihre Domain spezifischen DNS-TXT-Eintrag (der Eintragsname folgt dem Muster `_azamol.<Ihre-Domain>`) oder einer Verifizierungsdatei, die Sie auf Ihren Server hochladen (`https://<Ihre-Domain>/.well-known/azamol-dogrulama.txt`). In beiden Fällen erzeugt das Panel den benötigten Wert — kopieren Sie ihn einfach über den Kopier-Button.
Bis die Domain verifiziert ist, erscheint der Assistent nirgends — genau das schützt Ihren Schlüssel vor Missbrauch auf anderen Seiten. Nutzen Sie mehrere Adressen (z. B. beispiel.de und www.beispiel.de), fügen und verifizieren Sie jede einzeln.
Persona-Version veröffentlichen
Legen Sie im Tab "Persona" fest, wie Ihr Assistent spricht, und veröffentlichen Sie eine Version. Ohne veröffentlichte Persona-Version kann der Assistent nicht live gehen.
Assistenten veröffentlichen
Sobald Ihre Domain verifiziert und eine Persona-Version veröffentlicht ist, klicken Sie im Tab "Einstellungen" auf Veröffentlichen. Dieser Schritt bringt Ihren Assistenten vom Entwurf live — selbst wenn der Einbettungscode schon auf Ihrer Website liegt, bleibt der Assistent bis dahin unsichtbar.
4
Einbettungscode auf Ihrer Website einfügen
Fügen Sie die folgende Zeile direkt vor dem schließenden </body>-Tag Ihrer Seite ein. Ihren eigenen Schlüssel finden Sie im Tab "Einbettungscode" Ihres Assistenten-Panels.
```
<script src="https://azamol.ai/embed/v1.js" data-azamol-key="az_pk_XXXX" async></script>
```
Der Code muss auf jeder Seite vorhanden sein — am praktischsten ist daher der Footer-Bereich Ihres Themes. Wo genau Sie ihn je nach Plattform einfügen, finden Sie unten.
Seite neu laden und prüfen
Öffnen Sie Ihre Website. Unten rechts sollte eine runde Schaltfläche erscheinen. Ein Klick öffnet das Assistenten-Fenster — der Assistent lädt erst in diesem Moment, sodass Besucher, die ihn nie öffnen, keine zusätzliche Last tragen. Bei Problemen siehe den Abschnitt Fehlerbehebung unten.

Ihre Website muss HTTPS nutzen

Der Assistent funktioniert nur auf Websites, die über https:// ausgeliefert werden. Läuft Ihre Website noch über http://, aktivieren Sie zuerst Ihr SSL-Zertifikat — das bieten heute fast alle Hosting-Anbieter kostenlos an.

Wenn Sie Sprachnachrichten nutzen: Mikrofonberechtigung

Damit Besucher Sprachnachrichten senden können, darf der Permissions-Policy-Header Ihrer Website den Mikrofonzugriff nicht blockieren. Sendet Ihr Server bereits einen restriktiven Header (manche Sicherheits-Plugins und CDNs fügen ihn standardmäßig hinzu), definieren Sie die folgende Berechtigung:

Permissions-Policy: microphone=(self "https://azamol.ai")

Ohne diese Berechtigung fällt nur die Sprachnachricht aus — Textchat und Bildversand bleiben unberührt; der Besucher erhält beim Tippen auf das Mikrofonsymbol einen verständlichen Hinweis.

Was können Besucher an den Assistenten senden?

Neben Text nimmt der Assistent auch Bilder und Sprachnachrichten entgegen. Besucher müssen nichts installieren — alles läuft im Chatfenster.

Bilder: JPG, PNG, WebP oder GIF, jeweils bis 5 MB. Besucher können ein Produktfoto, einen Screenshot oder die Aufnahme eines Dokuments senden und dazu fragen.
Sprachnachrichten: über die Mikrofon-Schaltfläche aufgenommen, bis zu 60 Sekunden. Für alle, die nicht tippen möchten oder unterwegs am Handy sind.
Ein Anhang pro Nachricht — Bild und Ton lassen sich nicht zusammen senden.

Eine Nachricht mit Anhang zählt weiterhin als eine einzige Nachricht in Ihrem Kontingent. Für Foto oder Aufnahme fällt kein Aufpreis an.

Wo Sie den Code je nach Plattform einfügen

WordPress

Gehen Sie im Adminbereich zu Design → Theme-Datei-Editor.
Öffnen Sie die Datei footer.php.
Fügen Sie den Code direkt über der Zeile </body> ein.
Speichern.

Damit er bei einem Theme-Update nicht verloren geht, ist ein Code-Einfüge-Plugin wie WPCode oder ein Child-Theme die sicherere Wahl.

Wix

Gehen Sie zu Einstellungen → Benutzerdefinierter Code.
Klicken Sie auf Code hinzufügen und fügen Sie den Code ein.
Wählen Sie als Platzierung Body — Ende.
Speichern Sie, damit er auf allen Seiten gilt.

Shopify

Gehen Sie zu Online-Shop → Themes → Code bearbeiten.
Öffnen Sie die Datei theme.liquid.
Fügen Sie den Code direkt über der Zeile </body> ein.
Speichern.

Webflow

Gehen Sie in den Projekteinstellungen zu Project Settings → Custom Code.
Fügen Sie den Code in das Feld "Footer Code" (Before </body> tag) ein.
Klicken Sie auf Save Changes und veröffentlichen Sie Ihre Website erneut (Publish) — der Code wird erst nach der Veröffentlichung aktiv.

Dieses Feld steht nur in kostenpflichtigen Publishing-Plänen zur Verfügung; in der Designer-Vorschau funktioniert es möglicherweise nicht.

Squarespace

Gehen Sie zu Einstellungen → Erweitert → Code-Injektion.
Fügen Sie den Code in das Feld "Footer" ein — dieser gilt für jede Seite Ihrer Website.
Speichern.

Die Code-Injektion kann in manchen Einsteiger-Tarifen von Squarespace deaktiviert sein; prüfen Sie in diesem Fall Ihren Tarif.

Eigene HTML-Website

Öffnen Sie die HTML-Datei jeder Seite.
Fügen Sie den Code direkt über dem schließenden </body>-Tag ein.
Laden Sie die Dateien auf Ihren Server hoch.

Haben Sie eine gemeinsame Footer-Vorlage, genügt es, ihn nur dort einzufügen.

Wenn der Assistent nicht erscheint

Gehen Sie diese Punkte der Reihe nach durch. Die meisten Fälle liegen an einem der ersten beiden.

Symptom	Mögliche Ursache	Lösung
Es erscheint überhaupt keine Schaltfläche	Der Code fehlt auf der Seite oder die Schlüssel-Zeile fehlt	Suchen Sie im Quellcode Ihrer Seite nach der Zeile embed/v1.js. Fehlt sie, wurde der Code nicht eingefügt; ist sie da, prüfen Sie die Schreibweise von data-azamol-key.
Ich klicke auf die Schaltfläche, aber das Fenster öffnet sich nicht	Die Domain ist noch nicht verifiziert oder der Assistent noch nicht veröffentlicht	Prüfen Sie die Verifizierung im Tab "Domains" und den Veröffentlichungsstatus im Tab "Einstellungen" Ihres Assistenten-Panels. www- und Nicht-www-Adressen gelten als getrennt.
Das Fenster öffnet sich, bleibt aber leer	Die Adresse steht nicht auf der Freigabeliste	Öffnen Sie die Browserkonsole (F12) — eine blockierte Einbettung wird dort protokolliert.
Er erscheint nur auf manchen Seiten	Der Code wurde nicht auf allen Seiten eingefügt	Verschieben Sie den Code in Ihre gemeinsame Footer-Vorlage.
Funktioniert lokal, aber nicht live	Die Live-Adresse wurde nicht separat verifiziert	Fügen Sie sowohl Test- als auch Live-Adresse im Tab "Domains" hinzu und verifizieren Sie beide.
Sie nutzen einen nicht standardmäßigen Port	Adressen wie beispiel.de:8443 gelten als eigener Ursprung	Fügen Sie die Adresse mit Port als eigene Domain hinzu und verifizieren Sie sie.
Ihre Website hat eine Content-Security-Policy (CSP)	Der Browser blockiert den Frame	Fügen Sie frame-src https://azamol.ai, script-src https://azamol.ai und connect-src https://azamol.ai zu Ihrer Policy hinzu.
Sie nutzen einen Werbeblocker	Das Skript wird möglicherweise blockiert	Testen Sie es in einem privaten Fenster bei deaktiviertem Blocker.

Hilft das alles nicht, öffnen Sie die Browserkonsole (F12) und senden Sie uns einen Screenshot der Zeilen, die mit [azamol-embed] beginnen.

Welche Links teilt der Assistent?

Da wir Ihre Website bei der Einrichtung crawlen, kann der Assistent den Link zu der Seite mitgeben, auf der seine Antwort beruht — Besucher müssen nicht nachfragen, wo das steht.

Geteilt werden nur Seiten Ihrer eigenen Domain, die beim Crawl tatsächlich gefunden wurden.
Erfindet oder errät der Assistent eine Adresse, wird dieser Link auf dem Server entfernt, bevor er den Besucher erreicht. Das ist eine erzwungene Regel, keine Bitte an das Modell.
Pro Antwort wird auf höchstens 2 verschiedene Seiten verlinkt — die Antwort wird so keine Linkliste.

Links öffnen in einem neuen Tab — das Gespräch geht nicht verloren.

Was in Ihre Datenschutzerklärung gehört

Der Assistent verarbeitet die Nachrichten Ihrer Besucher, um Antworten zu erzeugen. Nach DSGVO/KVKK sind Sie der Verantwortliche, Azamol handelt als Auftragsverarbeiter in Ihrem Namen. Die Einwilligungstexte und Informationspflichten gehören daher in Ihre eigene Datenschutzerklärung.

Weisen Sie darauf hin, dass Ihre Website einen AI-Assistenten nutzt und Nachrichten verarbeitet werden.
Weisen Sie Besucher darauf hin, keine besonderen Kategorien personenbezogener Daten — etwa Ausweisnummern oder Gesundheitsdaten — in den Assistenten einzugeben.
Halten Sie fest, dass Gesprächsinhalte nicht gespeichert werden — Nachrichten werden ausschließlich zur Erzeugung der Antwort verarbeitet und danach verworfen; Azamol speichert keine Gesprächstexte, und Mitarbeitende können sie nicht lesen.
Weisen Sie darauf hin, dass Nachrichten auf einer Cloud-Infrastruktur außerhalb Ihres Landes verarbeitet werden, und behandeln Sie diese Übermittlung in Ihrer Erklärung.

Häufig gestellte Fragen

Verlangsamt er meine Website?▼

Nein. Die geladene Datei ist komprimiert etwa 7 KB groß und läuft asynchron — sie wartet nicht auf den Seitenaufbau und verzögert ihn nicht. Das Assistenten-Fenster selbst lädt erst, wenn ein Besucher auf die Schaltfläche klickt.

Zerstört er mein Design?▼

Nein. Der Assistent läuft in einem von Ihrer Seite isolierten Frame; Ihr CSS beeinflusst ihn nicht, und er beeinflusst Ihre Seite nicht.

Kann ich denselben Schlüssel auf mehreren Websites nutzen?▼

Sie können mehrere Domains hinzufügen; Ihr Limit sehen Sie im Assistenten-Panel. Jede Adresse muss separat verifiziert werden.

Und wenn ich ihn entfernen möchte?▼

Löschen Sie einfach die eine hinzugefügte Zeile. Es bleibt nichts weiter zurück.

Kommen Sie nicht weiter? Melden Sie sich — wir helfen gerne. Kontakt aufnehmen