방문자의 신원 확인하기
Chatixy.identify()로 로그인한 방문자가 누구인지 채팅에 알리고 서버에서 이메일에 서명하면, 팀이 대화에서 확인된 신원을 볼 수 있습니다.
신원 확인의 작동 방식
방문자가 웹사이트에 로그인해 있으면 페이지가 Chatixy.identify()로 그 방문자가 누구인지 채팅에 알릴 수 있습니다. 그러면 이메일, 이름, 전화번호가 받은편지함의 대화에 표시되고, 채팅은 더 이상 이메일을 묻지 않습니다.
서명 없이 identify()는 채팅 전 양식처럼 동작합니다. 정보는 빈 필드만 채우고 대화는 확인되지 않음으로 표시됩니다. 서버에서 만든 서명인 user_hash를 추가하면 Chatixy가 신원을 확인됨으로 표시합니다. 정보가 방문자가 입력한 내용을 대체하고, 받은편지함의 연락처 카드에 확인됨 배지가 표시됩니다. 지원 에이전트에게는 실제로 확인되었을 때만 신원이 확인되었다고 알립니다.
팁
- 채팅 전 양식의 필드 규칙이 적용됩니다. 전화번호는 채팅이 전화번호를 요청할 때만, 이름은 채팅의 이름 필드가 꺼져 있지 않을 때 저장됩니다.
신원 비밀 키 찾기
채팅마다 고유한 신원 비밀 키가 있습니다. 워크스페이스 관리자만 볼 수 있습니다.
단계
- 1
채팅 설정 열기
프로젝트에서 사이트의 구성를 클릭한 다음 고급 설정을 엽니다.
- 2
비밀 키 복사
신원 비밀 키 아래에서 표시를 클릭한 다음 복사를 클릭합니다.
- 3
서버에 보관
서버만 읽을 수 있는 곳에 저장하세요. 예를 들어 환경 변수
CHATIXY_IDENTITY_SECRET입니다.
중요
- 신원 비밀 키를 페이지 코드, JavaScript 또는 공개 저장소에 절대 넣지 마세요. 이를 가진 사람은 누구나 어떤 이메일이든 확인된 것처럼 보이게 할 수 있습니다.
- 다시 생성은 새 비밀 키를 만들며, 이전 키로 만든 서명은 즉시 인정되지 않습니다. 비밀 키가 유출되었을 수 있을 때 사용하고, 새 비밀 키를 바로 서버에 적용하세요.
서버에서 이메일에 서명하기
서명은 신원 비밀 키를 키로 사용해 방문자 이메일로 계산한 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()를 호출해도 이를 되돌릴 수 없습니다.
확인됨 배지가 표시되지 않는 이유는 무엇인가요?
전달하는 이메일을 한 글자도 다르지 않게 서명하는지, 채팅마다 비밀 키가 다르므로 이 채팅의 비밀 키를 사용하는지, 서명이 16진수로 작성되었는지, 복사한 뒤 누군가 비밀 키를 다시 생성하지 않았는지 확인하세요.
이메일에 꼭 서명해야 하나요?
아니요. user_hash 없는 identify()도 방문자 정보를 받은편지함에 전달합니다. 확인되지 않음으로 표시되며 아직 비어 있는 필드만 채웁니다.