定義

• ウェブサイトやアプリ上でIDを基準にしてメッセージングサービスにユーザー認証処理する方法の案内

使用

Zendeskガイド文書

ウェブウィジェットおよびモバイルSDK用メッセージングで最終ユーザー認証する – MatrixCloud (zendesk.com)

実使用ガイド

署名キー作成および共有

• 基本共有文書で置き換え

必要事項

• 最終ユーザーのexternal_idが必要
• jwtの必須要素がexternal_id（Emailはオプション）
• external_idはAPIまたはユーザーアップロード時にのみ入力可能
  • つまり、初めはCSV上に入力して処理することができるが、その後は顧客が顧客を作成する際にZendesk APIを呼び出してユーザーのexternal_idを更新するロジックが必要
  • ヘルプリンク
    • ユーザーの一括インポート
    • ユーザーのexternal IDを設定するには？ 

    • プロファイルに外部IDを使用する

       

• プロファイル下部で確認可能
  

バックエンド開発必要

• jwtトークン生成
• nodejsの例

  var jwt = require('jsonwebtoken');
  var SECRET = '最終ユーザー認証で生成したキー'
  var KID = '最終ユーザー認証のID'
  
  // 必須はscope、external_idのみ
  var token = jwt.sign({ scope: 'user', external_id:'外部ID',name: 'ユーザー名', email: 'ユーザーのメール'}, SECRET, { header: { kid: KID } });
  

• 要素説明

  Zendesk SDKを使用してメッセージングの認証された訪問者を有効にする

• 生成されたトークンをフロントでウェブウィジェットをロード後メッセージングログイン用に使用

WebWidget

• チャネル → メッセージング → メッセージング選択 → インストール

  

• コードスニペットを顧客のアプリに配置
• その後顧客ログイン時に上記バックエンドを呼び出してJWTトークンを取得
• Zendeskメッセージングログイン（上記ウィジェット呼び出し後可能）

  zE("messenger", "loginUser", function (callback) {
    callback("取得したトークンを入力")
  })
  

• Zendeskメッセージングログアウト（上記ウィジェット呼び出し後可能）

  zE("messenger", "logoutUser")
  

• ガイド

  認証

ボット

• ログインの有無を確認 - 条件別ブランチ

  

• ログインした情報はメッセージングメタデータから取得可能