Nutzer identifizieren
Standardmäßig behandelt das Widget Besucher als anonym. Rufen Sie uj.identify auf, um Feedback, Stimmen, Kommentare, Benachrichtigungen und Unterhaltungen dem Konto eines Kunden zuzuordnen.
Einfache Identifizierung
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
firstName: 'Ada',
lastName: 'Lovelace',
avatar: 'https://example.com/avatar.jpg'
}
});user.id ist erforderlich. Verwenden Sie eine stabile ID aus Ihrer Datenbank statt einer E-Mail-Adresse oder eines Anzeigenamens, die sich ändern können. email ist optional, wird aber dringend empfohlen, damit UserJot den Nutzer über Boards, die Weiterleitung von E-Mails und Unterhaltungen hinweg zuordnen kann. Wenn Sie eine email übergeben, wird sie nur mit einem bestehenden UserJot-Konto verknüpft, dessen E-Mail-Adresse bestätigt wurde.
Wann identify aufgerufen werden sollte
Rufen Sie uj.identify auf, sobald Ihre App weiß, wer angemeldet ist. Wird der Aufruf mit exakt denselben Daten erneut ausgeführt, solange die Sitzung noch aktiv ist, hat das keine Auswirkungen. Sobald die Sitzung abläuft oder sich ein Feld (einschließlich E-Mail-Adresse oder Merkmalen) ändert, sendet das SDK eine neue Anfrage. Bei Übergabe eines anderen Nutzers wird die Sitzung sofort gewechselt.
Wenn sich der Nutzer von Ihrer App abmeldet, rufen Sie uj.logout() auf:
if (user) {
uj.identify({
user: {
id: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
}
});
} else {
uj.logout();
}Eigenschaften hinzufügen
Merkmale sind benutzerdefinierte Attribute, die einem Mitgliederprofil zugeordnet werden und im Dashboard neben den Anfragen und Unterhaltungen des Mitglieds angezeigt werden.
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
traits: {
plan: 'pro',
seats: 12,
trialing: false
}
}
});Merkmalswerte können Zeichenfolgen, Zahlen, boolesche Werte oder null sein (monthlySpend muss, sofern mitgesendet, eine nicht negative Zahl sein). Reservierte Schlüssel (wie id, email, role oder companies) werden ignoriert und in result.warnings gemeldet. Die vollständige Liste finden Sie in der SDK-Referenz.
Unternehmen hinzufügen
Bei B2B-Produkten können Sie dem Nutzer ein oder mehrere Unternehmen zuordnen:
uj.identify({
user: { id: 'user-123', email: 'ada@example.com' },
companies: [
{
id: 'acme',
name: 'ACME Inc.',
domain: 'acme.com',
logo: 'https://acme.com/logo.png',
traits: { plan: 'enterprise', arr: 24000 }
}
]
});id ist für jedes Unternehmen erforderlich. name, domain, logo (HTTPS-URL) und traits sind optional. Wenn Signierte Tokens erforderlich unter Einstellungen → Anmeldung aktiviert ist, werden Unternehmen, die außerhalb eines signierten JWT übergeben werden, ignoriert und es wird eine UNSIGNED_COMPANY_IGNORED-Warnung ausgegeben.
Was identify zurückgibt
Sobald das SDK-Skript geladen wurde, gibt uj.identify ein Promise zurück:
const result = await uj.identify({
user: { id: 'user-123', email: 'ada@example.com' }
});
result.viewer; // the identified user, or null
result.identityTrust; // 'signed' or 'unsigned'
result.warnings; // fields the server ignored or adjustedRatenbegrenzungen und Fehler
Ratenbegrenzung und clientseitige Wartezeit: Identify-Anfragen sind auf 30 pro Minute und 300 pro Stunde je IP-Adresse und Workspace begrenzt. Bei Überschreitung des Stundenlimits wird eine 1-stündige Sperre ausgelöst. Nach dem Empfang von HTTP
429erzwingt das SDK eine lokale Abkühlphase (unter Berücksichtigung vonRetry-After, auf einen Zeitraum zwischen 1 Sekunde und 1 Stunde begrenzt; standardmäßig 60 Sekunden), sodass Wiederholungsschleifen lokal fehlschlagen, ohne die API mit Anfragen zu überlasten.Abgelehnte Aufrufe: Wenn der Server einen Identify-Aufruf ablehnt (z. B. wegen eines ungültigen Tokens, aktivierter Option Require signed tokens ohne Token, eines E-Mail-Konflikts, der
409zurückgibt, oder eines gemäß DSGVO gelöschten Mitglieds, das403/member_erasedzurückgibt), wird das Promise mitIDENTIFY_FAILEDabgelehnt und der Besucher bleibt anonym.
Identität und Konversationen
Wenn Conversations aktiviert ist:
Identifizierte Nutzer überspringen die Abfrage der Besucherdaten und erhalten Antworten des Teams an die E-Mail-Adresse ihres Kontos.
Anonyme Besucher erhalten browsergebundene Gastunterhaltungen. Je nach Widget-Einstellungen können dabei optional Kontaktdaten erfasst werden.
Im Widget können anonyme Besucher Feedback abgeben und auf Updates reagieren. Für das Hochvoten von Feedback, das Kommentieren und das Öffnen der Benachrichtigungsglocke muss jedoch uj.identify aufgerufen werden. Zum Bearbeiten oder Löschen eigener Beiträge und Kommentare im Widget ist eine signierte Identität erforderlich.
Wenn unter Einstellungen → Anmeldung die Option Require signed tokens aktiviert ist, werden nicht signierte Aufrufe von identify mit HTTP 403 abgelehnt und der Besucher bleibt anonym. Verwenden Sie Signierte Identität, um Konten serverseitig zu verifizieren.
Welche Authentifizierungsmethode sollte ich verwenden?
Methode | Einsatzbereich | Sicherheit | Tarif | Anleitung |
|---|---|---|---|---|
Nicht signiert ( | In-App-Widget | Vom Browser bereitgestellt (kann gefälscht werden) | Alle Tarife | Dieser Artikel |
Signierte Identität (HS256-JWT) | In-App-Widget (+ Links zum öffentlichen Portal, wenn die automatische Anmeldung aktiviert ist) | Serverseitig verifiziertes JWT | Starter & Professional (für den strikten Modus) | |
Automatische Anmeldung | Öffentliches Portal & Inline-Einbettungen ( | Serverseitig verifiziertes HS256-JWT | Starter & Professional | |
Single Sign-on (SSO) | Anmeldeweiterleitung zum öffentlichen Portal | Serverseitig verifiziertes HS256-JWT | Professional | |
Swift SDK ( | iOS- und macOS-Apps | Nicht signiert oder HMAC-SHA256-Signatur | Starter & Professional (erfordert automatische Anmeldung) |
Nächster Schritt
Verifizieren Sie Nutzeridentitäten in Ihrem Backend mit Signierte Identität.