訪問者の身元を確認する
Chatixy.identify() でログイン中の訪問者が誰かをチャットに伝え、そのメールアドレスをサーバーで署名すると、チームは会話で確認済みの身元を確認できます。
身元確認のしくみ
訪問者がウェブサイトにログインしているとき、ページは Chatixy.identify() でその人が誰かをチャットに伝えられます。メールアドレス、名前、電話番号が受信箱の会話に表示され、チャットはメールアドレスを尋ねなくなります。
署名がない場合、identify() はチャット前フォームと同じように動作します。情報は空の項目だけを埋め、会話は未確認として扱われます。サーバーで作成した署名 user_hash を加えると、Chatixy は身元を確認済みとして扱います。情報は訪問者が入力した内容を置き換え、受信箱の連絡先カードに 確認済み のバッジが表示されます。サポートエージェントには、本当に確認済みのときだけ身元が確認済みだと伝えられます。
ヒント
- チャット前フォームの項目ルールが適用されます。電話番号はチャットで電話番号を尋ねる設定のときだけ、名前はチャットの名前項目がオフでない限り保存されます。
ID シークレットを確認する
チャットごとに専用の ID シークレット があります。ワークスペースの管理者だけが表示できます。
手順
- 1
チャットの設定を開く
プロジェクトでサイトの 設定 をクリックし、高度な設定 を開きます。
- 2
シークレットをコピーする
ID シークレット で 表示 をクリックし、次に コピー をクリックします。
- 3
サーバーに保管する
サーバーだけが読める場所に保存します。たとえば環境変数
CHATIXY_IDENTITY_SECRETです。
重要
- ID シークレットをページのコード、JavaScript、公開リポジトリに決して置かないでください。持っている人は誰でも、任意のメールアドレスを確認済みに見せかけられます。
- 再生成 は新しいシークレットを作成し、古いシークレットで作った署名はすぐに認められなくなります。シークレットが漏れた可能性があるときに使い、新しいシークレットをすぐにサーバーに設定してください。
サーバーでメールアドレスに署名する
署名は、ID シークレットを鍵として訪問者のメールアドレスから計算した HMAC-SHA256 を、小文字の 16 進数 64 文字で表したものです。
identify() に渡すメールアドレスをそのまま署名してください。Chatixy は確認前に大文字と小文字を変えないため、Ann@Example.com と ann@example.com は異なる署名になります。署名はページを生成するときや自社 API の応答時にサーバーで作成し、ブラウザでは決して作成しないでください。
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)身元をチャットに渡す
訪問者のメールアドレスと、署名を user_hash として Chatixy.identify() を呼び出します。name と phone は省略できます。サーバーが作成した値をページに書き込んでください。下の例はプレースホルダーです。
ページが訪問者を把握した時点ですぐに呼び出せます。チャットの準備ができる前の呼び出しは待機し、準備ができると実行されます。最初のメッセージより前に渡した身元は、そのメッセージで始まる会話に結び付けられます。
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>署名が一致しない場合
一致しない user_hash は、その呼び出しから何も保存しません。メールアドレス、名前、電話番号、確認済み のバッジのいずれも保存されません。チャット自体は通常どおり動作し、訪問者にエラーは表示されません。
確認済みの会話は確認済みのままです。後から署名なしで identify() を呼び出しても取り消されません。
確認済み のバッジが表示されないのはなぜですか?
渡しているメールアドレスを 1 文字も違わずに署名しているか、チャットごとにシークレットが異なるのでこのチャットのシークレットを使っているか、署名が 16 進数で書かれているか、コピーした後に誰かがシークレットを再生成していないかを確認してください。
メールアドレスへの署名は必須ですか?
いいえ。user_hash なしの identify() でも、訪問者の情報は受信箱に渡されます。未確認として扱われ、まだ空の項目だけを埋めます。