정의

• 웹사이트나 APP 상에서 아이디를 기준으로 하여 메시징 서비스에 사용자 인증 처리하는 방법 안내

사용

젠데스크 가이드 문서

웹 위젯 및 모바일 SDK용 메시징에서 최종 사용자 인증하기 – MatrixCloud (zendesk.com)

실사용 가이드

서명 키 만들기 및 공유하기

• 기본 공유 문서로 대체

필요 사항

• 최종 사용자의 external_id 가 필요

• jwt의 필수 요소가 external_id (Email은 옵션)

• external_id 는 API 혹은 사용자 upload 시에만 입력 가능

  • 즉, 최초에는 CSV 상에 입력하여 처리 할 수 있으나, 이후에는 고객사에서 고객 생성 시 젠데스크 API를 호출하여 사용자의 external_id 를 업데이트 해주는 로직 필요

  • 도움말 링크

    • Bulk importing users

    • How do I set a user's external ID? 

    • Using external ID with profiles

       

• 프로필 하단에서 확인 가능
  

BackEnd 개발 필요

• jwt 토큰 생성

• nodejs 예시

  var jwt = require('jsonwebtoken');
  var SECRET = '최종사용자인증에서 생성한 키'
  var KID = '최종사용자인증의 ID'
  
  // 필수는 scope, external_id 만 필요
  var token = jwt.sign({ scope: 'user', external_id:'외부아이디',name: '사용자이름', email: '사용자이메일'}, SECRET, { header: { kid: KID } });
  

• 요소 설명

  Enabling authenticated visitors for messaging with Zendesk SDKs

• 해당 생성 된 토큰을 Front에서 웹 위젯 로드 후 메시징 로그인 용도로 사용

WebWidget

• 채널 → 메시징 → 메시징 선택 → 설치

  

• 코드 스니펫을 고객사 APP에 위치

• 이후 고객 로그인 시 상기 BackEnd 호출 후 JWT 토큰 취득

• 젠데스크 메시징 로그인 (상기 위젯 호출 후 가능)

  zE("messenger", "loginUser", function (callback) {
    callback("취득한 토큰 입력")
  })
  

• 젠데스크 메시징 로그아웃 (상기 위젯 호출 후 가능)

  zE("messenger", "logoutUser")
  

• 가이드

  Authentication

Bot

• 로그인 여부 확인 - 조건별 브랜치

  

• 로그인 한 정보는 메시징 메타데이터 에서 취득 가능