アプリ内通話、ウェブ通話、ビデオ通話の属性を渡す - 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

  • クレーム:

    * 日付形式の詳細については、次のインターネットエンジニアリングタスクフォース (IETF) ドキュメント: JSON ウェブトークン (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。

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

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

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

注記

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

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

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