Die Identität Ihrer Besucher verifizieren

Teilen Sie dem Chat mit Chatixy.identify() mit, wer ein angemeldeter Besucher ist, und signieren Sie seine E-Mail auf Ihrem Server, damit Ihr Team eine verifizierte Identität am Gespräch sieht.

So funktioniert die Identitätsverifizierung

Ist ein Besucher auf Ihrer Website angemeldet, kann Ihre Seite dem Chat mit Chatixy.identify() mitteilen, wer er ist. E-Mail, Name und Telefonnummer erscheinen dann am Gespräch in Ihrem Posteingang, und der Chat fragt nicht mehr nach der E-Mail.

Ohne Signatur funktioniert identify() wie das Vor-Chat-Formular: Die Angaben füllen nur leere Felder, und das Gespräch gilt als nicht verifiziert. Fügen Sie eine auf Ihrem Server erstellte Signatur hinzu, den user_hash, und Chatixy markiert die Identität als verifiziert: Die Angaben ersetzen, was der Besucher eingegeben hat, und die Kontaktkarte in Ihrem Posteingang zeigt das Abzeichen Verifiziert. Ihr Support-Agent erfährt nur dann, dass die Identität verifiziert ist, wenn sie es wirklich ist.

Tipps

  • Es gelten die Feldregeln des Vor-Chat-Formulars: Eine Telefonnummer wird nur gespeichert, wenn Ihr Chat danach fragt, und ein Name, sofern das Namensfeld Ihres Chats nicht ausgeschaltet ist.

Ihr Identitätsgeheimnis finden

Jeder Chat hat sein eigenes Identitätsgeheimnis. Nur Administratoren Ihres Arbeitsbereichs können es sehen.

Schritte

  1. 1

    Chat-Einstellungen öffnen

    Klicken Sie in Ihrem Projekt bei der Website auf Konfigurieren und öffnen Sie dann Erweiterte Einstellungen.

  2. 2

    Geheimnis kopieren

    Klicken Sie unter Identitätsgeheimnis auf Anzeigen und dann auf Kopieren.

  3. 3

    Auf dem Server aufbewahren

    Speichern Sie es dort, wo nur Ihr Server es lesen kann, zum Beispiel in der Umgebungsvariablen CHATIXY_IDENTITY_SECRET.

Wichtig

  • Legen Sie das Identitätsgeheimnis niemals in den Code Ihrer Seite, in Ihr JavaScript oder in ein öffentliches Repository. Wer es kennt, kann jede E-Mail als verifiziert erscheinen lassen.
  • Neu erzeugen erstellt ein neues Geheimnis, und mit dem alten erstellte Signaturen werden sofort nicht mehr anerkannt. Nutzen Sie es, wenn das Geheimnis bekannt geworden sein könnte, und hinterlegen Sie das neue sofort auf Ihrem Server.

Die E-Mail auf Ihrem Server signieren

Die Signatur ist ein HMAC-SHA256 der E-Mail des Besuchers, mit Ihrem Identitätsgeheimnis als Schlüssel erstellt und in Kleinbuchstaben-Hexadezimal geschrieben: 64 Zeichen.

Signieren Sie genau die E-Mail, die Sie an identify() übergeben. Chatixy ändert die Groß- und Kleinschreibung vor der Prüfung nicht, daher ergeben Ann@Example.com und ann@example.com verschiedene Signaturen. Erstellen Sie die Signatur auf Ihrem Server, wenn Sie die Seite ausliefern oder Ihre eigene API antwortet, niemals im Browser.

Node.js

const crypto = require('crypto');

const userHash = crypto
  .createHmac('sha256', process.env.CHATIXY_IDENTITY_SECRET)
  .update(user.email)
  .digest('hex');

PHP

$userHash = hash_hmac('sha256', $user->email, getenv('CHATIXY_IDENTITY_SECRET'));

Python

import hashlib
import hmac
import os

user_hash = hmac.new(
    os.environ['CHATIXY_IDENTITY_SECRET'].encode(),
    user.email.encode(),
    hashlib.sha256,
).hexdigest()

Ruby

require 'openssl'

user_hash = OpenSSL::HMAC.hexdigest('SHA256', ENV.fetch('CHATIXY_IDENTITY_SECRET'), user.email)

Die Identität an den Chat übergeben

Rufen Sie Chatixy.identify() mit der E-Mail des Besuchers und der Signatur als user_hash auf; name und phone sind optional. Schreiben Sie die Werte, die Ihr Server erzeugt hat, in die Seite - das Beispiel unten zeigt Platzhalter.

Sie können es aufrufen, sobald Ihre Seite weiß, wer der Besucher ist. Aufrufe, bevor der Chat bereit ist, warten und laufen, sobald er es ist, und eine vor der ersten Nachricht übergebene Identität wird dem Gespräch zugeordnet, das diese Nachricht beginnt.

HTML

<script>
  window.chatixyAsyncInit = function (Chatixy) {
    Chatixy.identify({
      email: 'ann@example.com',
      name: 'Ann',
      user_hash: 'SIGNATURE_FROM_YOUR_SERVER',
    });
  };
</script>
<script src="https://chatixy.com/source/YOUR_WIDGET_KEY.js" async></script>

Wenn eine Signatur nicht passt

Ein user_hash, der nicht passt, speichert nichts aus diesem Aufruf: keine E-Mail, keinen Namen, keine Telefonnummer und kein Abzeichen Verifiziert. Der Chat selbst funktioniert wie gewohnt weiter, und der Besucher sieht keinen Fehler.

Ein verifiziertes Gespräch bleibt verifiziert: Ein späterer Aufruf von identify() ohne Signatur kann das nicht rückgängig machen.

Warum erscheint das Abzeichen Verifiziert nicht?

Prüfen Sie, dass Sie genau die übergebene E-Mail signieren, Buchstabe für Buchstabe; dass Sie das Geheimnis dieses Chats verwenden, denn jeder Chat hat sein eigenes; dass die Signatur hexadezimal geschrieben ist; und dass niemand das Geheimnis neu erzeugt hat, nachdem Sie es kopiert haben.

Muss ich die E-Mail signieren?

Nein. identify() ohne user_hash übergibt die Angaben des Besuchers trotzdem an Ihren Posteingang. Sie gelten als nicht verifiziert und füllen nur Felder, die noch leer sind.