AgentNice Standalone-Setup

Voraussetzungen prüfen

Lizenz und Domain

Du brauchst eine aktive AgentNice-Lizenz, der deine Ziel-Domain zugeordnet ist. Domain und Lizenz verknüpfst du beim Kaufflow auf danpardella.de. Wenn deine Lizenz auf eine andere Domain ausgestellt ist, melde dich unter hej@danpardella.de, bevor du die Einrichtung startest.

Zugriff auf die Zielseite

Du musst einen <script>-Block in den HTML-Quelltext deiner Seite einfügen können. Wo das geht, hängt von der Plattform ab — plattform-spezifische Pfade findest du in Sektion 5.

SMTP-Postfach

Du brauchst ein eingerichtetes Mail-Postfach bei deinem Hoster oder einem externen Mail-Provider, plus die zugehörigen SMTP-Login-Daten: Server-Hostname, Port, Verschlüsselung, Benutzername und Passwort.

---

1. SMTP im AgentNice-Backend hinterlegen

Anders als beim WordPress Client-Plugin werden bei der Standalone-Variante die SMTP-Zugangsdaten zentral im AgentNice-Admin auf danpardella.de hinterlegt. Der Server schickt damit die Form-Mails in deinem Namen — verschlüsselt gespeichert, gültig nur für deine Lizenz.

Schritte

1. Login auf danpardella.de mit dem Account aus dem Kaufflow.
2. AgentNice-Admin → Lizenzen → deine Lizenz öffnen.
3. Sektion Mail-Versand (SMTP) ausfüllen: SMTP Host, Port, Benutzername, Passwort, Absender, Verschlüsselung.
4. Speichern.

---

2. Variante A — Floating-Button

Ein Toggle-Button erscheint unten rechts auf jeder Seite, auf der das Snippet eingebaut ist. Per Klick öffnet sich das Chat-Fenster mit dem konfigurierten Agent.

Code-Snippet

<!-- AgentNice Floating Chat -->
<script>
  window.AgentNiceConfig = {
    apiUrl: 'https://www.danpardella.de/wp-json/agentnice/v1/chat',
    licenseKey: 'AN-XXXX-XXXX-XXXX',
    domain: 'deine-domain.de'
  };
</script>
<script src="https://www.danpardella.de/wp-json/agentnice/v1/widget.js" defer></script>

Was anpassen

• licenseKey: durch deinen Lizenzkey aus der Welcome-Mail ersetzen
• domain: die Domain, auf der du das Snippet einbaust — muss exakt mit der Lizenz-Domain übereinstimmen

Wo einbauen

Vor dem schließenden </body> der Seite. Plattform-spezifische Pfade siehe Sektion 5.

---

3. Variante B — Inline-Embed

Der Chat erscheint inline an einer von dir bestimmten Stelle der Seite, ohne Toggle-Button, voll sichtbar. Geeignet für dedizierte Kontakt- oder Support-Seiten.

Code-Snippet

<!-- AgentNice Inline Embed -->
<script>
  window.AgentNiceConfig = {
    apiUrl: 'https://www.danpardella.de/wp-json/agentnice/v1/chat',
    licenseKey: 'AN-XXXX-XXXX-XXXX',
    domain: 'deine-domain.de'
  };
</script>
<div data-agentnice-embed style="height:600px;"></div>
<script src="https://www.danpardella.de/wp-json/agentnice/v1/widget.js" defer></script>

Was anpassen

• licenseKey und domain wie bei Variante A
• style="height:600px;": Höhe des Embed-Containers nach Bedarf — z.B. 100vh für volle Viewport-Höhe oder 500px für eine kompaktere Darstellung

Wo einbauen

Den Container-Div an der Stelle im HTML platzieren, wo der Chat erscheinen soll. Die zwei Script-Tags drumherum oder direkt vor </body>. Plattform-spezifische Pfade siehe Sektion 5.

---

4. SMTP testen

1. AgentNice-Admin → Lizenzen → deine Lizenz öffnen.
2. Sektion Mail-Versand (SMTP) → Button SMTP-Verbindung testen.
3. Bei Erfolg: Test-Mail wird an die hinterlegte Absender-Adresse zugestellt — kurz im Postfach prüfen.
4. Bei Fehler: lesbare Fehlermeldung wird angezeigt (Auth-Failure, Host-Resolution, TLS-Mismatch etc.).

---

5. Plattform-spezifische Schritte

---

6. Wenn etwas nicht funktioniert

Das Widget erscheint nicht

Browser-Console öffnen (F12), nach roten Fehlern suchen. Häufigste Ursachen:

• Lizenzkey falsch eingetragen.
• Die domain in der Config stimmt nicht mit der Lizenz-Domain überein.
• Script-Tag wurde von einem Cache-Plugin entfernt.

„Versand temporär nicht möglich“ beim Form-Absenden

SMTP nicht konfiguriert oder Verbindung schlägt fehl. Im AgentNice-Admin Send-Log und Test-Button prüfen (Sektion 4).

CORS-Fehler in der Browser-Console

Die domain im Snippet stimmt nicht mit der in der Lizenz hinterlegten Domain überein, oder die Lizenz ist auf inaktiv gesetzt. Lizenz-Status im AgentNice-Admin prüfen.

Form-Submit gibt 422 zurück

Pflichtfelder im Form sind leer oder ein Email-Feld enthält keine gültige Adresse. Browser-DevTools → Network-Tab → Response-Body zeigt das fehlende Feld.

Test-Mail kommt nicht an

Spam-Ordner prüfen. Bei IONOS und All-Inkl: die smtp_from-Adresse muss zur SMTP-Auth-Domain passen, sonst lehnt der Server den Versand ab.

---

7. Wie geht’s weiter?

SMTP ist konfiguriert, der Widget-Code ist eingebettet — dein Agent läuft. Was als nächstes?

• Forms im Agent konfigurieren — Forms erstellst du im AgentNice-Admin auf danpardella.de. Änderungen werden bei nächster Agent-Config-Aktualisierung wirksam.
• Theming pro Lizenz — Farben, Schriften und Tonalität deines Agents passt du im AgentNice-Admin an. Änderungen werden bei der nächsten Agent-Config-Aktualisierung wirksam.

Support

Wenn nach allen Schritten noch etwas nicht funktioniert, melde dich bei hej@danpardella.de mit:

• Lizenzkey-Anfang (z.B. AN-K4CR-...)
• Plattform und URL der Zielseite
• Browser-Console-Output bei JS-Fehlern

Antwort meist innerhalb eines Werktags.

---

← Zurück zur Doku-Übersicht