JavaScript-API
Globale Methoden, die nach dem Laden des Widget-Skripts verfügbar sind.
Respondo.init(config)#
Initialisiert und montiert das Widget. Muss einmal aufgerufen werden. Gibt die Widget-Instanz zurück.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)#
Hängt die Nutzeridentität an die aktuelle Sitzung an. Nach der Anmeldung aufrufen.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
userHash: 'hmac_sha256_signature', // optional, zur Identitätsverifizierung
metadata: { plan: 'pro' },
properties: { // benutzerdefinierte Kontakteigenschaften
account_type: 'enterprise', // in den Agent-Einstellungen definierte Schlüssel
region: 'eu-west'
}
});Respondo.track(name, properties?)#
Zeichnet ein clientseitiges Ereignis für den aktuellen Besucher auf (z. B. Kauf, Plan-Upgrade). Ereignisse können ereignisgesteuerte Touren starten und auf Tour-Ziele einzahlen. Best-Effort-Zustellung mit keepalive, sodass Ereignisse, die unmittelbar vor einer Navigation ausgelöst werden (Checkout-Redirect), trotzdem ankommen. Nach init() aufrufen.
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.destroy()#
Entfernt das Widget von der Seite. Nützlich für SPAs beim Navigieren zu Seiten, auf denen das Widget nicht erscheinen soll. Es löscht weder die Identität des Besuchers noch die gespeicherte Konversation — verwenden Sie für das Abmelden Respondo.reset().
// Widget von der Seite entfernen
Respondo.destroy();
// Bei Bedarf später erneut initialisieren (setzt dieselbe Konversation fort)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()#
Abmeldung / Geräteübergabe auf gemeinsam genutzten Geräten. Löscht die anonyme Besucher-ID, die gespeicherte Konversation und das Sitzungstoken aus dem Browser, widerruft das Sitzungstoken serverseitig, sodass Kopien davon nicht mehr funktionieren, und montiert ein frisches anonymes Widget neu. Rufen Sie dies im Logout-Hook Ihrer App auf.
// Beim Abmelden — Identität, Konversation und Sitzung löschen, neu starten
Respondo.reset();Automatische Datenerfassung
Das Widget erfasst und speichert automatisch Folgendes bei jeder Konversation:
| Daten | Quelle |
|---|---|
| Client-IP | HTTP-Header |
| Browser / OS | User-Agent-Header |
| Sprache | Accept-Language-Header |
| Zeitzone | Intl-API (JavaScript) |
| Seiten-URL | window.location |
| Referrer | Referer-Header |