Amazon Connect でアプリ内、ウェブ、ビデオ通話のカスタマーエクスペリエンスをパーソナライズする - Amazon Connect
代替方法: スニペットコードからコンタクト属性を直接渡すコミュニケーションウィジェットのコードとセキュリティキーをコピーする

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Connect でアプリ内、ウェブ、ビデオ通話のカスタマーエクスペリエンスをパーソナライズする

このトピックのステップはオプションですが、実行することをお勧めします。これにより、アプリケーション内で以前に実行されたアクションに基づいて、顧客エクスペリエンスをパーソナライズできます。このオプションを使用すると、コンテキスト情報を属性として渡す機能など、新しい呼び出しを開始する際により詳細なコントロールを行うことができます。

これらのステップを実行したら、ウェブサイト管理者と協力して、新しい通話用にウェブトークン (JWTs) を発行するようにJSONウェブサーバーを設定する必要があります。

  1. コミュニケーションウィジェットを既に作成している場合は、[コミュニケーションウィジェット] ページで、編集するウィジェットを選択します。

  2. [ドメインとセキュリティ] セクションで、[編集] をクリックします。

  3. [Add security for your communications widget requests] で、[はい] を選択します。

    [はい] オプション。

  4. [Save and continue] を選択します。Amazon Connect では、次とともにウィジェットを作成します。

    • Amazon Connect では、次のページに の作成に使用できる 44 文字のセキュリティキーが用意されていますJWTs。

    • Amazon Connect は、通話が開始されJWTたときに をチェックするコールバック関数を通信ウィジェット埋め込みスクリプトに追加します。

      次の例に示すように、コールバック関数を埋め込みスニペットに実装する必要があります。

      amazon_connect('authenticate', function(callback) {
  window.fetch('/token').then(res => {
    res.json().then(data => {
      callback(data.data);
    });
  });
});

    次のステップでは、ウェブサイトで開始したすべての通話のセキュリティキーを取得します。このセキュリティキーJWTsを使用して問題が発生するようにウェブサーバーをセットアップするには、ウェブサイト管理者にお問い合わせください。

  5. [Save and continue] を選択します。

  6. カスタムHTMLコードスニペットをコピーし、ウェブサイトのソースコードに挿入します。

代替方法: スニペットコードからコンタクト属性を直接渡す

注記

これらの属性は、HostedWidget- プレフィックスでスコープが指定されますが、依然としてクライアント側では変更可能 (ミュータブル) です。問い合わせフローで PIIまたはイミュータブルなデータが必要な場合は、 JWT セットアップを使用します。

次の例は、ウィジェットのセキュリティを有効にせずに、スニペットコードから直接コンタクト属性を渡す方法を示しています。

<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', 'widgetId');
  amazon_connect('snippetId', 'snippetId');
  amazon_connect('styles', /* ... */);
  // ...
  
  amazon_connect('contactAttributes', {
   foo: 'bar'
  })
<script/>

コンタクトフローで属性を使用する

[コンタクト属性の確認] フローブロックでは、次の画像で示しているように、[ユーザー定義] の名前空間を介してこれらの属性にアクセスできます。このフローブロックを利用して、分岐ロジックを追加できます。フルパスは $Attribute.HostedWidget-attributeName です。

Valid プロンプトと Invalid プロンプトに分岐するフローブロックを示した画像。

コミュニケーションウィジェットのコードとセキュリティキーをコピーする

このステップでは選択内容を確認して、コミュニケーションウィジェットのコードをコピーし、ウェブサイトに埋め込みます。を作成するためのシークレットキーをコピーすることもできますJWTs。

セキュリティキー

この 44 文字のセキュリティキーを使用して、JSONウェブサーバーからウェブトークンを生成します。キーを変更する必要がある場合、キーを更新またはローテーションすることもできます。これにより、Amazon Connect によって新しいキーが提供されます。以前のキーは、交換できるようになるまで保持されます。新しいキーのデプロイ後、Amazon Connect に戻って以前のキーを削除できます。

セキュリティキー。

顧客がウェブサイトの通話開始アイコンを操作すると、通信ウィジェットはウェブサーバーに をリクエストしますJWT。これJWTを指定すると、ウィジェットはエンドユーザーの Amazon Connect への呼び出しの一部としてそれを含めます。次に Amazon Connect では、シークレットキーを使用してトークンが復号化されます。成功すると、 JWTがウェブサーバーによって発行され、Amazon Connect がコールをコンタクトセンターエージェントにルーティングしたことを確認します。

JSON ウェブトークンの詳細

  • アルゴリズム: HS256

  • クレーム:

    * 日付形式の詳細については、次の Internet Engineering Task Force (IETF) ドキュメント: JSON Web Token (JWT）、5 ページを参照してください。

次のコードスニペットは、Python JWTで を生成する方法の例を示しています。

payload = {
'sub': widgetId, // don't add single quotes, such as 'widgetId'
'iat': datetime.utcnow(),
'exp': datetime.utcnow() + timedelta(seconds=JWT_EXP_DELTA_SECONDS)
}

header = {
'typ': "JWT",
'alg': 'HS256'
}

encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm=JWT_ALGORITHM, headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect

コミュニケーションウィジェットのスクリプト

次の図は、カスタマーがコンタクトセンターを呼び出すことができるようにするウェブサイトに JavaScript 埋め込む の例を示しています。このスクリプトでは、ウェブサイトの右下隅にウィジェットが表示されます。

次の図は、 の場所の例を示していますwidgetId。

コミュニケーションウィジェットのスクリプト

ウェブサイトがロードされると、まず [チャット開始] アイコンが表示されます。顧客がこのアイコンを選択すると、コミュニケーションウィジェットが開き、エージェントとの通話ができます。

コミュニケーションウィジェットは、[編集] をクリックするといつでも変更できます。

注記

変更を保存すると、数分でカスタマーエクスペリエンスが更新されます。保存する前にウィジェットの設定を確認してください。

ウィジェットのプレビューの編集リンク

ウェブサイト上のウィジェットのアイコンを変更するには、ウェブサイトを直接更新するための新しいコードスニペットを受け取ります。