訪問者の身元を確認する

Chatixy.identify() でログイン中の訪問者が誰かをチャットに伝え、そのメールアドレスをサーバーで署名すると、チームは会話で確認済みの身元を確認できます。

身元確認のしくみ

訪問者がウェブサイトにログインしているとき、ページは Chatixy.identify() でその人が誰かをチャットに伝えられます。メールアドレス、名前、電話番号が受信箱の会話に表示され、チャットはメールアドレスを尋ねなくなります。

署名がない場合、identify() はチャット前フォームと同じように動作します。情報は空の項目だけを埋め、会話は未確認として扱われます。サーバーで作成した署名 user_hash を加えると、Chatixy は身元を確認済みとして扱います。情報は訪問者が入力した内容を置き換え、受信箱の連絡先カードに 確認済み のバッジが表示されます。サポートエージェントには、本当に確認済みのときだけ身元が確認済みだと伝えられます。

ヒント

  • チャット前フォームの項目ルールが適用されます。電話番号はチャットで電話番号を尋ねる設定のときだけ、名前はチャットの名前項目がオフでない限り保存されます。

ID シークレットを確認する

チャットごとに専用の ID シークレット があります。ワークスペースの管理者だけが表示できます。

手順

  1. 1

    チャットの設定を開く

    プロジェクトでサイトの 設定 をクリックし、高度な設定 を開きます。

  2. 2

    シークレットをコピーする

    ID シークレット で 表示 をクリックし、次に コピー をクリックします。

  3. 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() でも、訪問者の情報は受信箱に渡されます。未確認として扱われ、まだ空の項目だけを埋めます。