Agile Developer Hilfe-Center › Agile Kundensupport

Wie baue ich das Chat-Widget in meine Website ein?

Snippet mit Ihrem Schlüssel ks_… unter Einstellungen › Einbau kopieren und vor </body> einfügen. Mit identify und userHash erkennen Sie angemeldete Nutzer sicher.

Das Snippet

Ihr persönliches Snippet finden Sie unter Einstellungen › Einbau, Abschnitt 1. Snippet einfügen. Es sieht so aus:

<script src="https://kundensupport.agiledeveloper.de/widget.js" data-key="ks_…" async></script>

Fügen Sie es auf jeder Seite direkt vor </body> ein. Der Schlüssel beginnt mit ks_ und ist öffentlich, er darf im Quelltext stehen. In der App finden Sie Anleitungen für HTML, WordPress, Shopify, Wix und Jimdo, Google Tag Manager sowie React und Co.

Das Widget ist rund 21 KB klein, öffnet sich nie von selbst und setzt keine Cookies.

Optionen

Vor dem Snippet können Sie window.AgileSupportSettings setzen, zum Beispiel:

<script>
  window.AgileSupportSettings = { position: 'left', bottom: 24, bottomMobile: 80, hideLauncherOnMobile: false };
</script>
  • position: 'left' oder 'right'
  • bottom und bottomMobile: Abstand unten in Pixeln, damit der Knopf keine Bedienelemente verdeckt
  • hideLauncher und hideLauncherOnMobile: Standardknopf ausblenden, etwa für einen eigenen Knopf
  • theme: 'auto' oder 'light'

Dieselben Optionen gehen als Attribute am Skript, zum Beispiel data-position, data-bottom, data-bottom-mobile oder data-hide-launcher.

Eigener Knopf und JavaScript-API

Unter Einstellungen › Einbau, Abschnitt 2. JavaScript-API (optional):

  • AgileSupport('open'), AgileSupport('close'), AgileSupport('toggle')
  • AgileSupport('showNewMessage', 'Text') öffnet mit vorbereiteter Nachricht
  • AgileSupport('searchHelp', 'Begriff') und AgileSupport('showArticle', id) für das Help Center
  • AgileSupport('on', 'unreadCountChange', n => …) für eine Ungelesen-Zahl an Ihrem eigenen Knopf
  • AgileSupport('shutdown') beim Abmelden, entfernt den Verlauf aus dem Browser

Für einen eigenen Knopf setzen Sie hideLauncher: true und rufen AgileSupport('toggle') auf.

Angemeldete Nutzer sicher erkennen (Identitätsprüfung)

Wenn Ihre Kunden in Ihrer eigenen App angemeldet sind, kann das Widget sie erkennen. Ihr Team sieht dann Name, E-Mail und eigene Attribute, und der Kontakt bekommt das Abzeichen Verifiziert.

So geht es

  1. Öffnen Sie Einstellungen › Einbau, Abschnitt 3. Angemeldete Nutzer erkennen (optional). Dort steht das Identitätsgeheimnis (sichtbar für Admins über Anzeigen).
  2. Berechnen Sie auf Ihrem Server den userHash: HMAC-SHA256 der userId mit dem Identitätsgeheimnis, als Hex-Wert. Beispielcode für Node.js, PHP und Python steht in der App.
  3. Übergeben Sie die Daten im Browser:
AgileSupport('identify', {
  userId: '12345',
  userHash: '…vom Server…',
  name: 'Anna Beispiel',
  email: 'anna@example.com',
  company: { id: 'f-1', name: 'Beispiel GmbH' },
  attributes: { plan: 'Pro' }
});

Alternativ setzen Sie dieselben Angaben vorab als user in window.AgileSupportSettings. Beim Abmelden rufen Sie AgileSupport('shutdown') auf.

Wichtig

  • Das Identitätsgeheimnis gehört nur auf Ihren Server, nie in den Browser oder ins Git.
  • Geheimnis erneuern kann nur der Inhaber. Danach sind alle bisherigen Hashes ungültig, passen Sie Ihren Server sofort an.
  • Ohne gültigen Hash bleibt der Kontakt unverifiziert.

Aussehen ändern

Farbe, Logo, Position und Texte stellen Sie unter Einstellungen › Widget ein. Siehe „Wie passe ich Aussehen und Texte des Widgets an?“

Damit das Widget nur auf Ihren eigenen Seiten läuft, tragen Sie unter Einstellungen › Datenschutz die Erlaubten Domains ein.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 11. Oktober 2026

Weitere Artikel zu Agile Kundensupport

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.