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'bottomundbottomMobile: Abstand unten in Pixeln, damit der Knopf keine Bedienelemente verdeckthideLauncherundhideLauncherOnMobile: Standardknopf ausblenden, etwa für einen eigenen Knopftheme:'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 NachrichtAgileSupport('searchHelp', 'Begriff')undAgileSupport('showArticle', id)für das Help CenterAgileSupport('on', 'unreadCountChange', n => …)für eine Ungelesen-Zahl an Ihrem eigenen KnopfAgileSupport('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
- Öffnen Sie Einstellungen › Einbau, Abschnitt 3. Angemeldete Nutzer erkennen (optional). Dort steht das Identitätsgeheimnis (sichtbar für Admins über Anzeigen).
- Berechnen Sie auf Ihrem Server den
userHash: HMAC-SHA256 deruserIdmit dem Identitätsgeheimnis, als Hex-Wert. Beispielcode für Node.js, PHP und Python steht in der App. - Ü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.