概要

デスクトップ レイアウト機能を使用すると、ビジネス要件に応じて Webex Contact Center デスクトップを構成できます。 ロゴ、タイトル、ウィジェットなどの要素をカスタマイズできます。 デスクトップ レイアウトを作成し、チームに割り当てることができます。 このレイアウトは、そのチームの一員としてログインするすべてのエージェントのデスクトップ上でのエージェント エクスペリエンスを生成します。

レイアウトには次の 2 つの種類があります。

  • グローバル レイアウト: このレイアウトは、チームを作成するときにデフォルトで割り当てられるシステム生成レイアウトです。 詳細については、 チームを管理する。 チームを作成すると、グローバル レイアウトがチームのデスクトップ レイアウトとして自動的に設定されます。 このレイアウトは削除できません。

  • カスタム レイアウト: カスタマイズされたデスクトップ エクスペリエンスを提供するレイアウト。 1 つまたは複数のチームに対してカスタム レイアウトを作成できます。

エージェントがログインしているときに新しいデスクトップ レイアウトを割り当てると、エージェントは新しいレイアウトを表示するためにページを再読み込みする必要があります。

Webex Contact Center デスクトップは、次の 3 つのペルソナをサポートします。

  • エージェント(Agent)

  • スーパーバイザ(Supervisor)

  • スーパーバイザーとエージェント

JSON レイアウト ファイルには、各ペルソナごとに個別のセクションがあります。 管理者は、JSON レイアウト ファイルの対応するセクションで各ペルソナの設定を構成する必要があります。 サンプル JSON レイアウトファイルの詳細については、以下を参照してください。 JSON レイアウトのトップレベルプロパティ

Cisco がデスクトップ レイアウトに新しい機能を追加すると、変更されていないレイアウトが新しい機能で自動的に更新されます。 更新されたデスクトップ レイアウトは、変更されていないデスクトップ レイアウトを使用している既存のチームで自動的に利用できるようになります。 変更されていないデスクトップ レイアウトを使用しているデスクトップ ユーザは、ログイン時またはブラウザを再読み込み時に、新しいレイアウト ベースの機能を受け取ります。

を使用している場合は デフォルトのデスクトップ Layout.json ファイルを一切変更せずに保存した場合、変更されていないレイアウトとみなされます。 ただし、 デフォルトのデスクトップ Layout.json ファイルを編集して再度アップロードすると、ファイルの内容やファイル名が変更されていなくても、レイアウトが変更されたとみなされます。

カスタム デスクトップ レイアウトを使用するチームの場合、管理者は新しい機能を組み込むためにレイアウト定義を定期的に更新する必要があります。 管理者が変更されていないレイアウトまたは変更されていないレイアウトを使用するチームを表示すると、新しいデスクトップ機能が自動的に適用されたことを示すメッセージが表示されます。

デスクトップには、iframe ベースと Web コンポーネント ベースの 2 種類のウィジェットがあります。 ヘッダー、ナビゲーション (カスタム ページ)、永続領域、ヘッドレス領域、補助パネルは、デスクトップ内のカスタマイズ可能な領域です。 これらはウィジェットではありません。

次のリストは、構成できるスペースの詳細を示しています。 画像はデスクトップのレイアウトを示しています。

  1. タイトルとロゴ領域: このスペースには、画面の左上隅に Webex Contact Center のロゴと名前 (デフォルト) が表示されます。

  2. 水平ヘッダー エリア: このスペースには、カスタム ウィジェットを配置できる構成可能なエリアがあります。 これらのウィジェットでは、インライン情報やドロップダウン メニューなどを表示できます。 このヘッダーの高さは 64 ピクセルしかないため、ウィジェットの高さはヘッダーの高さを超えることはできません。

  3. ワークスペース 領域: このスペースは、ナビゲーション バーの選択内容やエージェントが顧客と対話しているときに変化します。 エージェントが通話中の場合、この領域にはインタラクション コントロールと補助情報ペイン (カスタム ウィジェットと永続ウィジェットを含む) が表示されます。 エージェントが電子メール、チャット、またはソーシャル チャネルでやり取りしているとき、この領域にはワークスペース領域と補助情報ペイン (永続ウィジェット領域を含む) が表示されます。

    カスタムページ ワークスペース ペインのデスクトップ インターフェイスに表示されます。 ナビゲーション バーのアイコンからカスタム ページにアクセスできます。 各カスタム ページには、1 つ以上のカスタム ウィジェットを含めることができます。

    カスタムウィジェット JSON レイアウトで構成されたサードパーティ アプリケーションです。 カスタム ウィジェットは、カスタム ページ、カスタム Tab (補助情報ペイン)、またはデスクトップの水平ヘッダーに配置できます。

  4. ナビゲーションバー 領域: このスペースを使用して、カスタム ページにアクセスするためのナビゲーション項目を追加します。

Sample Webex Contact Center Desktop user interface for voice, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
音声用サンプルデスクトップ UI
Sample Webex Contact Center Desktop user interface for new digital channels, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
新しいデジタルチャネルのサンプルデスクトップ UI

JSON レイアウトのトップレベルプロパティ

[ロール(Roles)]

デフォルトの JSON レイアウトには次の 3 つの役割があります。

  • エージェント - エージェントが Webex Contact Center デスクトップにサインインしてエージェント アクティビティを処理するときに表示されるデスクトップ レイアウトを設定します。

  • スーパーバイザー - スーパーバイザーが Webex Contact Center デスクトップにサインインしてスーパーバイザー機能のみを処理するときに表示されるデスクトップ レイアウトを設定します。

    スーパーバイザーがデスクトップにサインインすると、プライマリ チームに指定されたデスクトップ レイアウトが適用されます。 プライマリ チームを指定しない場合は、グローバル レイアウトが適用されます。 デフォルトでは、APS レポートは無効になっています。

  • SupervisorAgent: スーパーバイザが Webex Contact Center デスクトップにサインインしたときに表示されるデスクトップ レイアウトを設定し、スーパーバイザの機能とエージェントのアクティビティの両方を処理します。

関連する JSON レイアウト ファイルの対応するペルソナで、各ロールのウィジェットを追加または変更できます。

以下は、ロールに基づいた JSON レイアウトの最上位プロパティです。

{ "agent": { "version": "0.1.0", "appTitle": "Webex Contact Center", "logo": "", "taskPageIllustration": "https://www.abc.com/image/logo.jpg", "stopNavigateOnAcceptTask": false, "dragDropEnabled": false, "notificationTimer": 8, "maximumNotificationCount": 3, "browserNotificationTimer": 8, "wxmConfigured": false, "desktopChatApp": { "webexConfigured": false, } "headerActions": ["outdial", "notification"], "area": { "advancedHeader": { ... }, "パネル": {... }, "ナビゲーション": {... }、"持続的":{ ... }, "ヘッドレス": {... } }, }, "supervisor": { "version": "0.1.0", "appTitle": "Webex Contact Center", "logo": "", "taskPageIllustration": "https://www.abc.com/image/logo.jpg", "stopNavigateOnAcceptTask": false, "dragDropEnabled": false, "notificationTimer": 8, "maximumNotificationCount": 3, "browserNotificationTimer": 8, "wxmConfigured": false, "desktopChatApp": { "webexConfigured": false, } "headerActions": ["outdial", "notification"], "area": { "advancedHeader": { ... }, "パネル": {... }, "ナビゲーション": {... }、"持続的":{ ... }, "ヘッドレス": {... }, "ホームページ": {... } }, } "supervisorAgent": { "version": "0.1.0", "appTitle": "Webex Contact Center", "logo": "", "taskPageIllustration": "https://www.abc.com/image/logo.jpg", "stopNavigateOnAcceptTask": false, "dragDropEnabled": false, "notificationTimer": 8, "maximumNotificationCount": 3, "browserNotificationTimer": 8, "wxmConfigured": false, "desktopChatApp": { "webexConfigured": false, } "headerActions": ["outdial", "notification"], "area": { "advancedHeader": { ... }, "パネル": {... }, "ナビゲーション": {... }、"持続的":{ ... }, "ヘッドレス": {... } }, } },
  • JSON レイアウト プロパティに加えられた変更は、デスクトップ ブラウザーを更新すると有効になります。
  • JSON レイアウトで有効にした機能がデスクトップで使用できない場合は、Cisco サポートに連絡して機能を有効にしてください。
  • JSON レイアウト内のすべてのプロパティでは大文字と小文字が区別されます。

アプリタイトル

デスクトップの水平ヘッダーのタイトルを指定します。 デフォルトのタイトルは Webex Contact Center

「アプリタイトル」:「Webex Contact Center」

デフォルトの appTitle は コンタクトセンターデスクトップWebex Contact Center。 古いデフォルトの appTitle を使用する既存のカスタムレイアウトには影響はありません(コンタクトセンターデスクトップ)。 新しい appTitle を使用するには、カスタム レイアウトを変更する必要があります。 ただし、新しいグローバルレイアウトでは、デフォルトの appTitle が次のように使用されます。 Webex Contact Center

タイトルはテキスト、画像、または空の文字列のいずれかになります。 タイトルテキストは 2 行に表示されます。 テキストが 2 行目を超える場合は、省略記号アイコンが表示され、ツールヒントに完全なタイトルが表示されます。 タイトルにスタイルを適用することはできません。

データ URI (Uniform Resource Identifier) を使用するか、コンテンツ配信ネットワーク (CDN)、Amazon Web Services (AWS) Simple Storage Service (S3) バケット、または同様のホスティング サービスでカスタム タイトル イメージをホストし、ホストされたイメージへの URL を指定できます。 サポートされているタイトル画像の形式は、PNG、JPG、JPEG、GIF、SVG、WebP です。 サポートされるタイトル画像のサイズは 184 x 32 ピクセル (幅 x 高さ) です。

ロゴ

会社のロゴの URL を指定します。 URL を指定しない場合は、デフォルトで Webex Contact Center ロゴが表示されます。

「ロゴ」:「https://my-cdn.com/logo.png」

CDN、Amazon Web Services (AWS) Simple Storage Service (S3) バケット、または同様のホスティング サービスでカスタム ロゴ イメージをホストし、ホストされたイメージへの URL を指定できます。 サポートされているロゴ画像の形式は、PNG、JPG、JPEG、GIF、SVG、WebP です。 サポートされるロゴ画像のサイズは 96 x 32 ピクセル (幅 x 高さ) です。

表 1. デスクトップレイアウト構成に基づいたアプリタイトルとロゴの表示マトリックス
条件 アプリタイトル ロゴ
appTitle とロゴが設定されていない場合
「アプリタイトル」: "",「ロゴ」: "", 
タイトルなし デフォルトのロゴ
appTitle とロゴが設定されている場合
「appTitle」:「ABC 社」、「logo」:「https://my-cdn.com/abclogo.png」、 
設定されたテキスト 構成されたロゴ
appTitle が設定されていて、logo が設定されていない場合
"appTitle": "ABC 社", "logo": "", 
設定されたテキスト デフォルトのロゴ

appTitle が設定されておらず、logo が設定されている場合

「アプリタイトル」: "",「ロゴ」: "https://my-cdn.com/abclogo.png", 
タイトルなし 構成されたロゴ
appTitle が設定されていて、ロゴが優先されない場合
"appTitle": "ABC Company", "logo": "no-logo", 
設定されたテキスト ロゴなし

appTitle が設定されておらず、ロゴが優先されない場合

"appTitle": ""、"ロゴ": "ロゴなし"、 
タイトルなし ロゴなし
appTitle が画像として追加され、ロゴが設定されている場合
「アプリタイトル」:「https://my-cdn.com/abccompanylogo.png」,「ロゴ」:「https://my-cdn.com/abclogo.png」, 
構成された画像 構成されたロゴ

appTitle が画像として追加され、ロゴが設定されていない場合

「アプリタイトル」:「https://my-cdn.com/abccompanylogo.png」,「ロゴ」:「」 
構成された画像 デフォルトのロゴ

appTitle が画像として追加され、ロゴが優先されない場合は

"appTitle": "https://my-cdn.com/abccompanylogo.png "、"logo": "ロゴなし"、 
構成された画像 ロゴなし
  • カスタム画像のサイズは、アスペクト比に基づいて調整されます。 先ほど設定したカスタム タイトル テキストがデスクトップに 2 行で表示される場合があります。 これを回避するには、カスタム タイトル テキストを変更します。
  • デスクトップの水平ヘッダーにタイトルとロゴが設定されていない場合、そのスペースはヘッダー ウィジェットによって使用されます。 タイトルとロゴのスペースを使用するには、ヘッダー ウィジェットを正しく構成する必要があります。
  • タイトルとロゴを合わせた最大幅は 304 ピクセル (パディングを含む) を超えることはできません。 ロゴの幅が 96 ピクセル未満の場合は、残りの幅をタイトルに使用できます。
  • カスタム画像のサイズがサポートされているサイズより大きい場合、画像のサイズは水平ヘッダーのアスペクト比に基づいて調整されます。 カスタム画像のサイズがサポートされているサイズより小さい場合、実際の画像のサイズが水平ヘッダーに保持されます。

タスクページのイラスト

組織の設定とブランドの調整に基づいて、タスク ページのカスタム イラストを指定します。 エージェントがサインインすると、タスク ページに、構成されたイラストが背景として表示されます。 デフォルトでは、タスク ページはイラストなしで表示されます。

"タスクページイラスト": "https://www.abc.com/image/logo.jpg",

データ URI を使用するか、コンテンツ配信ネットワーク (CDN)、Amazon Web Services (AWS) Simple Storage Service (S3) バケット、または同様のホスティング サービスでカスタム イラストをホストし、ホストされたイラストの URL を指定できます。 イラストは、レイアウト定義に基づいてグローバル レベルまたはチーム レベルで構成できます。 壊れた画像がデスクトップに表示されないようにするには、正しい URL を設定してください。

サポートされているタスク ページのイラスト形式は、PNG、JPG、JPEG、GIF、SVG、WebP です。 イラストの推奨サイズは 400×400 ピクセル(幅×高さ)です。 カスタムイラストのサイズが推奨サイズより大きい場合、タスクページのアスペクト比に基づいてイラストのサイズが調整されます。 カスタムイラストのサイズが推奨サイズより小さい場合、実際のイラストのサイズがタスクページに保持されます。

Webex Contact Center interface example of a custom illustration retraining the actual size.
実際のサイズを維持したカスタムイラストのサンプル例
Webex Contact Center interface example of a custom illustration adjusted based on the aspect ratio.
アスペクト比に基づいて調整されたカスタムイラストのサンプル例

タスク承認時にナビゲートを停止する

エージェントが以前のタスクの作業中に新しいタスクを受け入れた場合に、新しく受け入れたタスクにフォーカスを移すかどうかを決定します。 デフォルト値は 間違い

"stopNavigateOnAcceptTask": false

値が次のように設定されている場合 真実ユーザがデスクトップ上で新しいタスクを受け入れると、フォーカスは前のタスクに保持され、新しく受け入れたタスクには移りません。 この設定により、ユーザは新しいリクエストを受け入れるときにデータが失われるのを防ぐことができます。

たとえば、エージェント 1 が顧客 1 とチャットしながら、同時に顧客 2 と音声通話しているとします。音声通話中に、エージェント 1 はインタラクション コントロール ペインで顧客 2 の詳細を更新しています。 現在、エージェント 1 の [タスク リスト] ペインには 2 つのアクティブなタスクがあり、フォーカスは [インタラクション コントロール] ペインにあります。 エージェント 1 が顧客 3 からの新しいチャット リクエストを受け入れると、フォーカスは顧客 2 とのインタラクション コントロール ペインに残り、新しく受け入れられたチャット リクエストには移動しません。

前のタスクにフォーカスを保持し、新しく承認されたタスクに移行しないようにするには、 stopNavigateOnAcceptTask プロパティ値を true に設定したカスタム レイアウトを選択します

stopNavigateOnAcceptTask プロパティ値が JSON レイアウトに入力されていない場合、デスクトップはフォーカスを新しく承認されたタスクに移動します。 この動作は、 stopNavigateOnAcceptTask プロパティ値が false に設定されている場合と同様です。

  • この設定は、タスクの承諾、会議、相談、転送、アウトダイヤル コール、アウトバウンド キャンペーン コール、自動ラップアップなど、デスクトップで実行されるすべてのタスク (音声およびデジタル チャネル) に適用されます。
  • デスクトップ ユーザが Home ページにアクセスしていて、タスク リスト ペインにアクティブなタスクがない場合、この設定は適用されません。 このような場合、新しいタスクが承認されると、フォーカスは Home ページから新しく承認されたタスクに移ります。

ドラッグドロップ有効

カスタム ページでウィジェットのドラッグ アンド ドロップとサイズ変更を有効にするには、値を true に設定します。 デフォルト値は falseです。

"ドラッグドロップ有効": false

補助情報ペインのタブでドラッグ アンド ドロップ機能を有効にする方法の詳細については、「 補助情報ペイン」を参照してください。

通知タイマー

デスクトップ上のデスクトップ通知が自動的に閉じられるまでの期間 (秒単位) を設定します。 通知はデスクトップの右上隅に表示されます。 デフォルトのタイムアウト値は 8 秒です。 タイムアウト値の有効な範囲は 1 ~ 10 秒です。 タイムアウトの変更を有効にするには、変更後にブラウザを更新する必要があります。

「通知タイマー」: 8

最大通知数

デスクトップに一度に表示されるデスクトップ通知の数を設定します。 デフォルト値は 3 です。デスクトップ通知の範囲は 1 ~ 10 です。 デスクトップ通知が積み重ねられています。 通知が多い場合は、 notificationTimer 設定に応じて、通知が若干遅れて表示されます。

「最大通知数」: 3

ブラウザ通知タイマー

デスクトップ上のブラウザ トースター通知が自動的に閉じられるまでの期間 (秒単位) を設定します。 トースターは、デスクトップがアクティブなブラウザ ウィンドウではない場合、または Tab である場合にのみ表示されるネイティブ ブラウザ通知です。 デスクトップブラウザウィンドウまたは Tab が非アクティブの場合

  • 他のブラウザウィンドウまたはタブで作業しています。

  • 他のアプリケーションで作業しています。

  • デスクトップ ブラウザ ウィンドウを最小化しました。

通知はデスクトップの右上隅に表示されます。 デフォルトのタイムアウト値は 8 秒です。 タイムアウト値の推奨範囲は 5 ~ 15 秒です。 タイムアウトの変更を有効にするには、変更後にブラウザを更新する必要があります。

「ブラウザ通知タイマー」: 8

ブラウザ通知に設定されたタイムアウトは、オペレーティング システムとブラウザの設定によって異なります。 タイムアウト値は、Windows OS、Chrome OS、および macOS の Chrome ブラウザで適用されます。 ただし、サポートされている他のブラウザは、構成された通知タイムアウト値を一貫して尊重しません。

wxmConfigured

(オプション) Webex Experience Management を構成するには、値を true に設定します。 デフォルト値は falseです。

"wxmConfigured": true

デスクトップチャットアプリ

Webex アプリなどの Cisco が提供する複数のチャット アプリケーションを設定します。

webex 構成済み

Webex アプリは、メッセージング機能や会議機能とともにデスクトップ内で構成できます。 この構成により、エージェントはデスクトップから移動することなく、組織内の他のエージェント、スーパーバイザー、および主題専門家 (SME) と共同作業を行うことができます。

  • サイト管理者は、Webex Meeting ユーザを管理し、ユーザが Webex Enterprise Edition を持っている場合にのみ権限を割り当てます。 詳細については、「Cisco Webex Control Hub での Webex Meetings ユーザーの管理」を参照してください。
  • 監督者と SME は、自分のシステム (個人用デバイス) に Webex クライアントをダウンロードするか、Web 用 Webex アプリ ( https://web.webex.com/) を使用して Webex アプリにアクセスする必要があります。 詳細については、 アプリをダウンロードするをご覧ください。
  • Agent Desktop 内の Webex アプリにアクセスして、Agent Desktop から移動せずに、組織内の他のエージェント、スーパーバイザー、および主題専門家 (SME) と共同作業を行うことができます。 通話制御機能は利用できません。 通話の受信と発信を行うには、外部の非埋め込み型 Webex アプリが必要です。 詳細については、「Calling Apps」を参照してください。

デスクトップ内で Webex アプリを構成するには:

  • Cisco Webex Control Hub で、ユーザにサービスを追加するときに、 高度なメッセージング チェックボックスをオンにします (ユーザ > ユーザの管理 > サービス > メッセージング)。 詳細については、 「Cisco Webex サイト管理のユーザ アカウントの管理」 を参照してください。

  • カスタム デスクトップ レイアウトで、 webexConfigured プロパティの値を true に設定します。

    「デスクトップチャットアプリ」: {「webexConfigured」: true },

    webexConfigured プロパティのデフォルト値は falseです。

    Webex アプリは、エージェント、スーパーバイザー、スーパーバイザーエージェントのロールでのみ使用できます。 webex 構成済み 不動産価値を 真実 これらのそれぞれの役割について。 エージェント、スーパーバイザー、またはスーパーバイザーエージェントは、Webex アプリからサインアウトできません。

    表示するには Webex アイコン Webexデスクトップの水平ヘッダーにあるアイコン()をクリックし、値を入力します。 Webex の中で ヘッダーアクション 財産。 詳細については、 ヘッダーアクション

    特定のチームで Webex アプリを有効にするには、カスタムレイアウトを選択して webex 構成済み プロパティ値が設定されている 真実。 詳細については、 チームを作成する

Webex アプリは、補助情報ペイン、カスタム ページ、カスタム ウィジェットでも構成できます。 詳細については、 補助情報パネル

Webex アプリ通知

指定された値は 通知タイマー そして ブラウザ通知タイマー 通知タイマーのプロパティは、Webex アプリに適用できます。 これらのプロパティのデフォルトのタイムアウト値は 8 秒です。 詳細については、 notificationTimer および browserNotificationTimer を参照してください

ヘッダーアクション

デスクトップの水平ヘッダー上のアイコンの順序を変更します。 デフォルトの順序は次のとおりです。

  1. Webex アイコン (Webex)

  2. 音声インジケーターに電話を使用する (アウトダイヤル)

  3. 通知アイコン。 (通知センター)

headerActions プロパティの値を次のように設定します。

アイコン名

headerActions プロパティ値

Webex アプリ

webex

アウトダイヤルコール

アウトダイヤル

通知センター

通知

"headerActions": ["Webex", "アウトダイヤル", "通知"],

headerActions プロパティ値では大文字と小文字が区別されます。

アイコンのデフォルトの順序を変更するには、 headerActions プロパティと値をカスタム レイアウトに入力します。

例:

"headerActions": ["通知", "発信", "Webex"],
  • カスタム レイアウトに headerActions プロパティと値を入力しない場合は、アイコンはデフォルトの順序で表示されます。
  • デスクトップからヘッダー アイコンと関連機能を削除するには、 headerActions プロパティ ("headerActions": []) に空の値を設定します。 ただし、Webex アプリを補助情報ペインまたはカスタム ページに追加した場合、あるいはカスタム ウィジェットとして追加した場合、Webex アプリはデスクトップの水平ヘッダーで使用できませんが、エージェントは引き続き Webex アプリにアクセスできます。
  • webexConfigured プロパティ値が false に設定されている場合、 Webex 値が headerActions プロパティに追加されていても、 Webex App アイコンはデスクトップの水平ヘッダーに表示されません。 詳細については、 webexConfigured を参照してください。

エリア

area プロパティは、デスクトップ レイアウトのコア セクションです。 エリアに応じてレイアウトを定義できます。

「エリア」: {「ヘッダー」: { ... }, "advancedHeader: { { "comp": "widget-1", "attributes": { ... }, "スクリプト": .... } }, "パネル": {... }, "ナビゲーション": {... }、"持続的":{ ... }, "ヘッドレス": {... } },

次の エリア オブジェクトを設定できます。

  • パネル: 補助情報ペインの 2 番目のパネルまたは右端のパネルを表します。

  • ナビゲーション: カスタム ページと、そのページに関連するナビゲーション要素を表します。

  • 永続的: 永続的でデスクトップのすべてのページに表示されるページ レベルのウィジェットを表します。

  • ヘッドレス: 視覚的なインターフェースを持たず、バックグラウンドでロジックを実行するウィジェットを表します。

advancedHeader プロパティが設定されている場合は、header プロパティと headerActions プロパティを削除する必要があります。

高度なヘッダー

デスクトップの水平ヘッダー上のアイコンの表示をカスタマイズし、順序を変更します。 デフォルトの順序は次のとおりです。

  1. Webex アイコン (Webex)

  2. 音声インジケーターに電話を使用する (外線通話)

  3. 通知アイコン。 (通知センター)

  4. Webex Contact Center エージェント状態セレクター。 (エージェント状態セレクター)

advancedHeader プロパティの値を次のように設定します。

アイコン名

headerActions プロパティ値

Webex アプリ

エージェント X-Webex

アウトダイヤルコール

エージェント x アウトダイヤル

通知センター

エージェント x 通知

エージェント状態セレクター

エージェント X 状態セレクター

"advancedHeader": [ { "comp": "agentx-webex" }, { "comp": "agentx-outdial" }, { "comp": "agentx-notification" }, { "comp": "agentx-state-selector" } { "comp": "widget-1", "attributes": {... }, "スクリプト": .... } ]

advancedHeader プロパティ値では大文字と小文字が区別されます。

アイコンのデフォルトの順序を変更するには、 advancedHeader プロパティと値をカスタム レイアウトに入力します。

ウィジェットはドロップダウン メニューに左から右へ流れていきます。

  • カスタム レイアウトに advancedHeader プロパティを入力しない場合は、デフォルトのヘッダーが表示されます。

  • 高度なヘッダーが有効になっている場合は、例に従ってウィジェットを既存のヘッダーから高度なヘッダーに移動する必要があります。

  • 高度なヘッダーを有効にすると、古いヘッダーは表示されません。

  • すべてのウィジェット アイコンには、CSS で定義されるデフォルトのパディングとマージンがあり、デスクトップではカスタマイズできません。

  • ロゴ、タイトル、プロフィールアイコンの位置は固定されており、カスタマイズすることはできません。

  • デスクトップからヘッダー アイコンと関連機能を削除するには、 advancedHeader プロパティ ("advancedHeader": []) で関連するコンポーネントに空の値を設定します。

    Webex アプリを補助情報ペインまたはカスタム ページに追加した場合、あるいはカスタム ウィジェットとして追加した場合、Webex アプリはデスクトップの水平ヘッダーで使用できませんが、エージェントは引き続き Webex アプリにアクセスできます。

  • 長いラベルを持つウィジェットを追加すると、使用可能なスペースに応じて切り捨てられたラベル名が表示されます。

    属性 textContent を使用してウィジェットにラベルを追加できます。

    { "comp": "timer-widget", "attributes": { "duration": "08:00:00" }, "textContent": "現在のシフトのカウントダウンタイマー", "script": "https://wxcc-demo.s3.amazonaws.com/widgets/timer-widget.js" }

    「現在のシフトのカウントダウン タイマー」というラベルは、使用可能なスペースに応じて切り捨てられて表示されます。

    • 長いラベルを持つウィジェットを追加しないでください。

    • ウィジェットがドロップダウンに流れる場合は、ウィジェット アイコンのみがクリック可能になります。

  • もし、 webex 構成済み プロパティ値は次のように設定されます 間違い、その Webex アプリ アイコンはデスクトップの水平ヘッダーに表示されません。 Webex 価値が付加されるのは 高度なヘッダー 財産。 詳細については、 webex 構成済み

Home ページ

デスクトップにログインすると、Home ページが表示されます。

Home ページは、スーパーバイザーとスーパーバイザーエージェントのペルソナにのみ適用されます。

Home ページでは次のウィジェットを表示できます。 アナライザー ウィジェットはデフォルトで提供されますが、管理者は永続ウィジェットとカスタム ウィジェットを構成することもできます。 詳細については、 JSON レイアウトのトップレベルプロパティ

アナライザーウィジェット

デフォルトでは、アナライザー ウィジェットはデスクトップの Home ページに表示されます。

Home ページレイアウト設定

組織の設定とブランドの調整に基づいたレイアウトを表示するように、デスクトップの Home ページを構成できます。 編集する ホームページ Home ページを構成するフィールド。 ユーザがデスクトップにサインインしたときに、Home ページに表示される次のコンポーネントを構成できます。

  • ようこそメッセージ

  • その タスク ナビゲーション バーのアイコンをクリックして、タスク ウィンドウに移動します。 その タスク コール モニタリング機能が有効になっているスーパーバイザーおよびスーパーバイザー & エージェントのロールには、アイコンが表示されます。 タスク ペインには、受信した顧客リクエスト、アクティブおよび過去の顧客とのやり取り、アクティブな監視リクエストが表示されます。

  • キュー名チャネル タイプ管理対象チームなどのセクションをフィルターします

次の表は、Home ページを構成するために必要な ページ プロパティについて説明しています。

表 2. 動的 Home ページレイアウト - ページプロパティ

財産

説明とコード

ページ > useFlexLayout

Flex レイアウトは新しい Web コンポーネントです。 既存のウィジェットは変更されません。 新しいフレックス レイアウトでは、同じレイアウト構成形式が簡略化された方法で使用されます。 下位互換性があり、既存のウィジェットに影響を与えません。 JSON レイアウトを構成する必要があります。 JSON レイアウトを構成するには、ウィジェットの高さと幅を指定します。 ウィジェットは、JSON レイアウト内で設定されているのと同じ順序でレンダリングされます。 ウィジェットのデフォルトのマージンは 8 ピクセルです。

JSON レイアウトは、ウィジェットの寸法 (幅 x 高さ) と座標 (X、Y、Z) に基づいています。

柔軟なレイアウトは、個々のウィジェットのサイズ変更、ウィジェットの最大化などの機能をサポートします。

個々のウィジェットの高さはピクセル単位で測定されます。 高さ 1 単位 = 40 ピクセル。 ウィジェットの幅は、コンテナ内の列の数と、コンテナの幅に基づいて変化する列の数によって決まります。

ウィジェットは左から右に表示されます。 高度なレイアウト エンジンは、カスタム ロジックを使用して、ウィジェットの水平方向と垂直方向の両方のスペース調整を適用します。 最初、レイアウトは水平に読み込まれます。 ウィジェットは水平方向に読み込まれた後、垂直方向に読み込まれ、スペースの使用が最適になることが保証されます。

画面サイズに基づいてウィジェットを構成します。 画面サイズに応じてウィジェットの幅を拡大または縮小することができます。 これにより、ウィジェットの読みやすさと使いやすさが向上します。

フレックス レイアウトでは、大、中、小、極小などの標準ブレークポイントが提供されます。

  • 大きなウィジェットの解像度は 1360 ピクセル以上です。 大きなウィジェットの場合は、列の値を 12 に指定します。

  • 中サイズのウィジェットの解像度は 1070 ~ 1360 ピクセルです。 中サイズのウィジェットの場合は、列の値を 10 に指定します。

  • 小さいウィジェットの解像度は 850 ~ 1070 ピクセルです。 小さいウィジェットの場合は、列の値を 6 に指定します。

  • 極小ウィジェットの解像度は 500 ピクセルです。 非常に小さいウィジェットの場合は、列の値を 4 に指定します。

これらのピクセルは、オペレーティング システムとブラウザによって異なる場合があります。

"page": { "id": "landing", "useFlexLayout": true, "widgets": { "comp1": { "comp": "div", "width": 4, "height": 4, "textContent": "ウィジェット 1", "attributes": { "style": "width: max-content; margin: 80px 240px; color: white;" } }, "comp2": { "comp": "div", "width": 4, "height": 4, "textContent": "ウィジェット 2", "attributes": { "style": "width: max-content; margin: 80px 240px;color: white;" } } } 

ページ > comp

必ず一意のカスタム コンポーネントを提供してください。

"comp": "ページタイトル",

page-title コンポーネントは、カスタム HTML 要素のレベル 2 見出し <h2> を表します。

ページ > ページヘッダー

静的、動的、またはその両方が可能なタイトル文字列を指定してください。

page-title コンポーネントは、カスタム HTML 要素のレベル 2 見出し <h2> を表します。

  • 静的文字列: たとえば、Hey, Welcome!

    "comp": "page-title", "attributes": { "pageTitle": "こんにちは、ようこそ!" }
  • 動的文字列: STOREから値を取得します。 たとえば、Jane Doe です。

    "comp": "ページタイトル", "属性": { "pageTitle": "$STORE.agent.agentName" }

  • 両方: 静的文字列と動的文字列の組み合わせ。 たとえば、「Hey Jane Doe、ようこそ!」

    "comp": "page-title", "attributes": { "pageTitle": "こんにちは、{$STORE.agent.agentName}さん、ようこそ!" }

    文字列の動的な部分を閉じた中括弧 {} で囲み、その前に構造 $ を付ける必要があります。

ページ > ページサブヘッダー

デスクトップに表示されるサブヘッダーを必ず追加してください。 ユーザはサブヘッダーに「 アナライザーに移動 」を追加できます。

  • サブヘッダーのコードブロック

    "useFlexLayout": true、"pageSubHeader": { "comp": "div", "attributes": { "style": "display: flex; float:right;margin:16px 0px 16px 16px" }、"children": [ { "comp": "div", "children": [ { "comp": "md-label", "textContent": "$I18N.pageSubHeader.queueName", "attributes": { "style": "margin-bottom:8px;" }
  • サブヘッダーの「アナライザーに移動」のコードブロック

    { "comp": "div", "children": [ { "comp": "agentx-more-actions-wrapper", "properties": { "actionList": [ { "comp": "agentx-wc-goto-analyzer" } ] } }

ナビゲーション(カスタムページ)

このセクションでは、左側のナビゲーション バーに表示されるページを追加できます。 ナビゲーション バーに表示されるウィジェットのナビゲーション アイコンと一意の URL を指定します。 競合を避けるため、URL に特定のプレフィックスを使用することをお勧めします。 詳細については、 nav プロパティ セクションを参照してください。

このページに表示できるウィジェットのコレクションを持つこともできます。 ページには、画面上に表示される単一のウィジェット、またはグリッド内のウィジェットのコレクションを含めることができます。 グリッド配置の詳細については、 レイアウト プロパティ セクションを参照してください。

ウィジェット ツリーに動的領域ラッパーを追加する必要はありません。 つまり、このオプションを有効にすると、カスタム ページでウィジェットをドラッグ アンド ドロップしてサイズを変更できるようになります。

例:

{ "nav": { "label": "カスタムページ", "icon": "stored-info", "iconType": "momentum", "navigateTo": "dynamic-tabs", "align": "top", "isDefaultLandingPage": true }, "page": { "id": "my - custom - page", "useFlexLayout": true, "widgets": { " comp1": { "comp": "md-tabs", "children": [{ "comp": "md-tab", "textContent": "Shift Timer", "attributes": { "slot": "Tab" } }, { "comp": "md-tab-panel", "attributes": { "slot": "panel" }, "children": [{ "comp": "my - custom - timer", "source": http://my-cdn.com/my-custom-timer.js "wrapper": { "title": "Shift Timer", "maximizeAreaName": "app-maximize-area" } }] }, { "comp": "md-tab", "textContent": "株式市場", "responsive": "false" "attributes": { "slot": "Tab" }, }, { "comp": "md-tab-panel", "attributes": { "slot": "panel" }, "children": [{ "comp": "agentx-wc-iframe", "responsive": "false" "attributes": { "src": "https://widget-kad.s3.amazonaws.com/Trading.htm" }, "wrapper": { "title": "株式市場", "maximizeAreaName": "app-maximize-area" } }], }, { "comp": "md-tab", "textContent": "Widget3", "attributes": { "slot": "Tab" } }, { "comp": "md-tab-panel", "textContent": "Three Content", "attributes": { "slot": "panel" } } ] }, "comp2": { "comp": "my - google - map - components", "source": "https://my-cdn.com/my-google.maps.js "wrapper": { "title": "Google Map", "maximizeAreaName": "app-maximize-area" } } }, "layout": { "areas": [ ["left", "right"] ], "size": { "cols": [1, 1], "rows": [1] } } } },

次の表は、 ナビ そして ページ プロパティとその子プロパティ:

表 3. nav 物件詳細

財産

説明とコード

ナビ > ラベル

このプロパティは、ページ ナビゲーション識別子を示します。 スクリーン リーダーはこのプロパティを読み取り、ツールヒントに表示されます。

これらのパラメータは、ナビゲーション バーにカスタム ページを表示するために必要です。

type Navigation.Item = { label: string; iconType: "momentum" | "other"; icon: string; align: "top" | "bottom"; navigateTo: string; iconSize? : 数値; 応答性がありますか? : ブール値; };

その ラベル プロパティはカスタム ページのタイトルです。

ナビ > アイコンタイプ

このプロパティは、カスタム ページのナビゲーション バーに表示されるアイコンの種類を表します。

使用できるアイコンの種類は次のとおりです。

  • 勢い: コレクション内の利用可能なアイコンを自由に選択できます。 https://momentum.design/icons。 Momentum を使用する利点は、「アクティブ」バージョンのアイコンがいくつか提供されることです。

    アクティブバージョンの使用例:

    例えば、Momentum アイコンタイプを選択した場合 発表、ナビゲーション バーにデフォルトのアイコンが表示されます。 カスタムページ(アイコンにリンクされている)に移動すると、アイコンが アナウンスメントアクティブ バージョンを自動的に更新します。 必ず、 アクティブ アイコン ライブラリ内の同じアイコンのバージョン。

  • その他: ナビゲーション バーに表示されるカスタム画像 URL (CDN でホスト) を提供できます。 黒または白のカスタム アイコンを使用すると、ライト モードとダーク モードを切り替えてもアイコンは表示されません。

ナビゲーション > アイコン

このプロパティは、Momentum ライブラリまたは CDN URL 内のアイコンの名前を表します。

type Navigation.Item ={ icon:"announcement"; }; // または // type Navigation.Item ={ icon:"https://my-cdn.com /my-navigation-icon.png"; };

ナビゲーション > 整列

このプロパティを使用すると、アイコンをナビゲーション バーの上部または下部に揃えることができます。

現在、このプロパティでは上揃えのみが許可されます。

ナビゲーション > isDefaultLandingPage

このプロパティは、Agent Desktop 内のエージェントのデフォルトのランディング ページを指定します。 このプロパティを true に設定すると、ナビゲーション バー ページが、Agent Desktop にログインした後にエージェントに表示されるデフォルトのランディング ページに設定されます。 複数のナビゲーション バー ページでこのプロパティが true に設定されている場合、システムは最初のナビゲーション バー ページをデフォルトのランディング ページと見なします。

ナビゲーション バー ページでこのプロパティが true に設定されていない場合は、Home ページがデフォルトのランディング ページとして機能します。

エージェント パフォーマンス統計レポートをデフォルトのランディング ページとして設定することはできません。

ナビ > ナビゲート先

このプロパティは、カスタム ページの名前を指定します。 この名前は、エージェントがナビゲートするときにアドレス バーに表示されます。

navigateTo には、images、fonts、css、build_info、help、app、i18n、icons、images-mfe-wc、sounds の値を含めることはできません。

タイプ Navigation.Item = { navigateTo: "my - custom - page"; };
表 4. ページプロパティの詳細

財産

説明とコード

ページ > id

イン ページ プロパティでは、カスタム ページ (動的ウィジェット) オブジェクトを指定します。

その id プロパティは一意のページ識別子を表します。 たとえば、my-custom-page-1 などです。 エージェントはデスクトップ上でこの識別子を表示できません。

type DynamicWidgets.Page = { id: string; widgets: Record < string, DynamicWidget.Options > ; layout: Layout; };

ページ > useFlexLayout

Flex レイアウトは新しい Web コンポーネントです。 既存のウィジェットは変更されません。 新しいフレックス レイアウトでは、同じレイアウト構成形式が簡略化された方法で使用されます。 下位互換性があり、既存のウィジェットに影響を与えません。 JSON レイアウトを構成する必要があります。 JSON レイアウトを構成するには、ウィジェットの高さと幅を指定します。 ウィジェットは、JSON レイアウト内で設定されているのと同じ順序でレンダリングされます。 ウィジェットのデフォルトのマージンは 8 ピクセルです。

JSON レイアウトは、ウィジェットの寸法 (幅 x 高さ) と座標 (X、Y、Z) に基づいています。

柔軟なレイアウトは、個々のウィジェットのサイズ変更、ウィジェットの最大化などの機能をサポートします。

個々のウィジェットの高さはピクセル単位で測定されます。 高さ 1 単位 = 40 ピクセル。 ウィジェットの幅は、コンテナ内の列の数と、コンテナの幅に基づいて変化する列の数によって決まります。

ウィジェットは左から右に表示されます。 高度なレイアウト エンジンは、カスタム ロジックを使用して、ウィジェットの水平方向と垂直方向の両方のスペース調整を適用します。 最初、レイアウトは水平に読み込まれます。 ウィジェットは水平方向に読み込まれた後、垂直方向に読み込まれ、スペースの使用が最適になることが保証されます。

画面サイズに基づいてウィジェットを構成します。 画面サイズに応じてウィジェットの幅を拡大または縮小することができます。 これにより、ウィジェットの読みやすさと使いやすさが向上します。

フレックス レイアウトでは、大、中、小、極小などの標準ブレークポイントが提供されます。

  • 大きなウィジェットの解像度は 1360 ピクセル以上です。 大きなウィジェットの場合は、列の値を 12 に指定します。

  • 中サイズのウィジェットの解像度は 1070 ~ 1360 ピクセルです。 中サイズのウィジェットの場合は、列の値を 10 に指定します。

  • 小さいウィジェットの解像度は 850 ~ 1070 ピクセルです。 小さいウィジェットの場合は、列の値を 6 に指定します。

  • 極小ウィジェットの解像度は 500 ピクセルです。 非常に小さいウィジェットの場合は、列の値を 4 に指定します。

これらのピクセルは、オペレーティング システムとブラウザによって異なる場合があります。

"page": { "id": "landing", "useFlexLayout": true, "widgets": { "comp1": { "comp": "div", "width": 4, "height": 4, "textContent": "ウィジェット 1", "attributes": { "style": "width: max-content; margin: 80px 240px; color: white;" } }, "comp2": { "comp": "div", "width": 4, "height": 4, "textContent": "ウィジェット 2", "attributes": { "style": "width: max-content; margin: 80px 240px;color: white;" } } } 

ページ > ウィジェット

ページ > コンプ

カスタム ウィジェットを定義するのに役立ちます。 複数のウィジェットを配置するには、ウィジェット オプションを順番に指定します。 各ウィジェットに一意のエリア名を付けてください。このエリア名は、後ほどレイアウトセクションで使用します。

"ウィジェット": { "comp1": { ... } "comp2": {... } }

このプロパティは、カスタム HTML 要素 (Web コンポーネントまたはラッパーとして使用する場合はその他の要素と呼ばれる) の名前を表します。 詳細については、 サンプルユースケース例。 ここに、山括弧 (「<」または「>」) なしでカスタム要素名を入力します。 たとえば、「my-custom-element」などです。

ウィジェット セクションの各エントリは、次の形式をサポートしています。

type Options = { comp: string; script? : 文字列; プロパティ? : レコード < 文字列、任意 > ; 属性? : Record < 文字列、文字列 > ; children? : オプション []; テキストコンテンツ? : 文字列; スタイル? : 部分的な < CSSStyleDeclaration > ; ラッパー? : { title: 文字列; maximizeAreaName: 文字列; }; };

ページ > スクリプト

(オプション) このプロパティは、ウィジェットまたはコンポーネントを CDN などのリモートの場所から読み込む場合にのみ必要です。

"comp1": { "comp": "widget-one", "script": "http:/my-cdn.com / ダイナミック - ウィジェット / ウィジェット - one.js ", }

同じコンポーネントのスクリプト URL を変更しないでください。 同じコンポーネントのスクリプト URL を変更する必要がある場合は、次のいずれかを実行します。

  • エージェントにブラウザのキャッシュをクリアして Agent Desktop をリロードするよう通知します。

  • 既存の URL を保持します。 既存の URL でホストされている JavaScript を使用して、新しいバンドル URL を動的にインポートします。

    例:

    (function() { var script = document.createElement("script"); script.src = <JS スクリプトの URL> script.type = "text/javascript"; script.async = true; document.getElementsByTagName ("head").item(0).appendchild(script); } ) ()

ページ > プロパティ

Web コンポーネントに渡す必要があるプロパティを指定できます。

「プロパティ」: {「ユーザ」:「管理者」},

ページ > 応答性の高い

カスタムレイアウトに追加される Web コンポーネントまたは iFrame ベースのウィジェットが ページ レベルまたは コンプ レベルは応答性があります。 レスポンシブ Web コンポーネントを使用すると、Web ページはあらゆるデバイスで視覚的に魅力的になり、使いやすくなります。 レスポンシブな iFrame ウィジェットを使用する必要があります。

このプロパティを次のいずれかの値で構成します。

  • True: ウィジェットの応答を有効にします。 デフォルトでは、すべてのウィジェットは、使用中のデバイスの段階的な画面サイズ、向き、表示領域に基づいて応答します。

  • False: ウィジェットの応答を無効にします。 ウィジェットがさまざまなデバイスでの表示をサポートしていない場合は、非応答としてマークします。

{ "comp": "md-tab", "responsive": true, "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "slot", "attributes": { "name": "SCREEN_POP_TAB" } }], "visibility": "SCREEN_POP" }, { "comp": "md-tab-panel", "responsive": false, "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "slot", "attributes": { "name": "CALL_GUIDE" } }], "visibility": "CALL_GUIDE" },

レスポンシブでないウィジェットでは、最高のユーザ エクスペリエンスを確保できず、小さいビューには表示されません。 エージェントは、応答なしとして設定されているウィジェットを表示するには、ブラウザ ウィンドウのサイズを大きくする必要があります。

ページ > 属性

このセクションでは Web コンポーネントの属性を指定できます。

"属性": { "無効": "false", },

ページ > 可視性

ページ レベルまたは コンポーネント レベルでカスタム レイアウトに追加されたシスコ提供のウィジェットを表示するかどうかを指定します。

Cisco が提供するウィジェットは、連絡先履歴、Cisco Webex Experience Management, IVR トランスクリプト、キャンペーン コール ガイドのプレビュー、スクリーン ポップです。

  • visibility プロパティの値は、デスクトップ レイアウトのデフォルトの JSON ファイルに組み込まれ、定義されています。 管理者は、シスコが提供するウィジェットの 可視性 プロパティ値を変更できません。

  • visibility プロパティ値 NOT_RESPONSIVE は非推奨です。 下位互換性のためだけに引き続き使用できます。 以前に NOT_RESPONSIVE として設定された値は、機能が同じままであるため、変更する必要はありません。

    新しく作成されたウィジェットをレスポンシブまたは非レスポンシブとして設定するには、 responsive プロパティを使用する必要があります。 詳細については、 レスポンシブ プロパティ を参照してください。

ページ > 子供

このプロパティはレイアウトの中核部分です。 の中で 子供たち セクションでは、Web コンポーネント ベースのウィジェットで子要素を渡すことができる場合は、必要な数だけレベルをネストできます。 これを可能にするには、開発者はプログラム的に スロット付き コンテンツ。 詳細については、 Cisco Webex Contact Center デスクトップ開発者ガイドを参照してください。

STORE 値をプロパティとして渡す方法については、「 デスクトップからウィジェットにデータを共有する」を参照してください。

"children": [{ "comp": "div", "textContent": "Test" }, { "comp": "div", "textContent": "Test" }, { "comp": "div", "textContent": "Test" }, { "comp": "div", "textContent": "Test" }, { "comp": "div", "children": [{ "comp": "div", "textContent": "テスト" }, { "comp": "div", "textContent": "テスト" }, { "comp": "div", "textContent": "テスト" } ] } ],

「children」配列セクションの利点は、既にデスクトップ バンドルの一部となっている既存の Web コンポーネントをレイアウト仕様で使用できることです。 デスクトップ バンドルの Web コンポーネントには次のものが含まれます。

  • agentx-wc-iframe: 任意の Web ページをウィジェットとして iFrame に配置できるウィジェット。

  • dynamic-area: カスタム ページ以外の場所でエージェントのドラッグ アンド ドロップ機能を有効にできるコンポーネント。 ドラッグ アンド ドロップをデフォルトで有効にすると、カスタム ページでもこの機能を使用できるようになります。

  • momentum-ui-web-component ライブラリ内の任意のコンポーネント。 詳細については、 GitHub を参照してください。 次に例を示します。

    • md-tabs: タブコンテナラッパー

    • md-tab: 単一の Tab ヘッダー

    • md-tab-panel: 単一の Tab コンテンツ

永続的な Tab の属性の詳細については、 「永続タブの属性」を参照してください。

ページ > テキストコンテンツ

テキスト コンテンツを追加するのに役立ちます。

"textContent": "私のテキストコンテンツ",

ページ > スタイル

コンポーネントに特定の CSS スタイルを割り当てるのに役立ちます。

"スタイル": { "背景色": "#CBD", "オーバーフロー": "スクロール" },

ページ > ラッパー

ウィジェット ラッパーを使用すると、ウィジェットの上にツールバーを追加できます。 ツールバーにはタイトルと 最大化アイコン ウィジェットの上部にある (最大化) アイコンをクリックします。 ウィジェットがページ上の小さなスペースを占めている場合、最大化アイコンを使用すると、エージェントはウィジェットをワークスペース全体で表示できます。

デフォルト値「app-maximize-area」を使用するようにしてください。 現在はデフォルト値のみが利用可能です。

"wrapper": { "title": ウィジェットのタイトル ", "maximizeAreaName": "app-maximize-area" }

ページ > ラッパー> ID

(オプション) Web コンポーネント ウィジェット ラッパーを使用すると、一意の識別子を使用して動的なウィジェット タイトルを更新できます。 ウィジェット ラッパーの id プロパティ値として unique-id-to-update-title を入力します。

"wrapper": { "title": ウィジェットのタイトル ", "id": "タイトルを更新するための一意の ID", "maximizeAreaName": "アプリの最大化領域" } 

JavaScript CustomEvent に同じ一意の識別子を使用していることを確認してください。 詳細については、 非同期イベント セクションの エージェントコンタクトモジュール の章 Cisco Webex Contact Center デスクトップ開発者

iFrame ベースのウィジェットのタイトルを更新するには、同じドメインの iFrame コンテンツを使用します。 以下にサンプル例を示します。

< script type = "text/javascript" >var title = ""; window.addEventListener("update-title-event", function(e) { title = e.detail.title; }); document.querySelector('#customEvent').onclick = function() { const e = new CustomEvent("update-title-event", { bubble: true, detail: { title: "新しいタイトル" } }); window.parent.dispatchEvent(e); }; < /script>< button id = "customEvent" > 新しいタイトル< /button>< iframe src = "https://blog.logrocket.com/the-ultimate-guide-to-iframes/" >< /iframe>

ページ > エージェント x-WC-iframe

デスクトップ上のウィジェットとして表示される iFrame に Web ページを埋め込むことができます。 「agentx-wc-iframe」という iFrame ウィジェットを使用できます。

"comp1": { "comp": "agentx-wc-iframe", "attributes": { "src": "https://blog.logrocket.com / iframe の究極ガイド / " }, "wrapper": { "title": "AgentX iFrame", "maximizeAreaName": "app-maximize-area" } },

ページ > レイアウト

ページ上のウィジェットを配置できます。

次の形式はグリッド レイアウトを表します。

type Layout = { areas: string[][]; size: { rows: number[]; cols: number[]; }; };

ここでは、 ウィジェット セクションで定義したエリア名を使用してグリッドを定義できます。

次の例は、3 行 3 列のレイアウトを指定する方法を示しています。

"レイアウト": { "エリア": [ [ "comp1", "comp1", "comp3" ], [ "comp2", "comp2", "comp3" ], [ "comp4", "comp4", "comp4" ] ], "サイズ": { "列": [1, 1, 1], "行": [1, 1, 1] } }
3x3 レイアウトの均等配分
Equal distribution of a 3x3 layout for Webex contact Center Desktop layout configuration.

サイズ セクションでは、数字はウィジェットが占めることができるスペースの割合を他のウィジェットと比較して表します。 3 つの列はすべて、均等に 1 つのスペースを占めます。 使用可能な幅が 100% の場合、各ウィジェットは水平方向のスペースの 33.33% を占めます。

列幅を均等にする
Equal column width layout for Webex Contact Center Desktop layout configuration.

別の使用例として、"cols": [1, 2, 2] と設定すると、全体のスペースが 5 (1+2+2) で分割され、最初のウィジェットが水平スペースの 20% を占めることを意味します。 2 番目と 3 番目のウィジェットはそれぞれ 40% を占めます。 詳細については、 「グリッド レイアウトの基本概念」を参照してください。

Unequal column width layout for Webex Contact Center Desktop layout configuration.
列幅を変更した後

ページ > ルート

レイアウトのネストはサブレイアウトと呼ばれます。 レイアウト構成にネストされたレイアウトがある場合は、サブレイアウトの親として単一の「ROOT」オブジェクトが必要です。 それ以外の場合、ネストが必要ない場合は、レイアウト構成をフラットにすることができます。

このサブレイアウトは、レイアウトのサイズ変更の動作をより詳細に制御できます。 ページ レイアウト プロパティは、Record<string, Layout> 型である必要があります。 レイアウト プロパティを使用すると、ページ上のウィジェットを配置できます。

{ "id": "some-id", "widgets": { "c1": { "comp": "div", "textContent": "c1" }, "c2": { "comp": "div", "textContent": "c2" }, "c3": { "comp": "div", "textContent": "c3" }, "c4": { "comp": "div", "textContent": "c4" }, "c5": { "comp": "div", "textContent": "c5" } }, "layout": { "ROOT": { "areas": [ ["c1", "sub1"], ["c2", "sub2"], ], "size": { "cols": [1, 1], "rows": [1, 1] } }, "sub1": { "areas": [ ["c3", "c4"] ], "size": { "cols": [1, 1], "rows": [1] } }, "sub2": { "areas": [ ["c1"], ["c5"] ], "size": { "cols": [1], "rows": [1, 1] } } } }

この設定により、ROOT レイアウトに、個別にサイズを変更できる 2 つのサブグリッドを含むグリッドが作成されます。

Sub-layout appearance for Webex Contact Center Desktop layout configuration.
サブレイアウトの外観

コンポーネントのサイズを変更すると、そのサブレイアウト内のコンポーネントに影響します。

Sub-layout appearance, after resizing both sub-layouts, for Webex Contact Center Desktop layout configuration.
両方のサブレイアウトのサイズを変更した後

以下のケースに注意してください。

無限ループ: ROOT レイアウトを ROOT のサブレイアウトとして含めると、「呼び出しスタック超過」エラーが発生し、無限ループが発生します。

{ "レイアウト": { "ルート": { "エリア": [ ["c1", "c2"], ["c3", "ルート"], ], "サイズ": { "列": [1, 1], "行": [1, 1] } } }
Sub-layout appearance with infinite loop for Webex Contact Center Desktop layout configuration.
無限ループのあるサブレイアウト

同じサブレイアウト (N) 回: 同じ名前のサブレイアウトをグリッドに複数回含め、そのうちの 1 つのサイズを変更すると、すべてのサブレイアウトのサイズが自動的に変更されます。

これが望ましい動作でない場合は、各サブレイアウトの名前を一意の名前に変更します。

{ "layout": { "ROOT": { "areas": [ ["c1", "sub1"], ["c2", "sub1"], ], "size": { "cols": [1, 1], "rows": [1, 1] } }, "sub1": { "areas": [ ["c3", "c4"] ], "size": { "cols": [1, 1], "rows": [1] } } } }
Sub-layout appearance with N times for Webex Contact Center Desktop layout configuration.
N 回のサブレイアウト

永続タブの属性

カスタム ページとカスタム ウィジェット内のタブを永続的に設定するには、カスタム レイアウトで md-tabs の属性を入力します。

例: タブを永続的に設定

{ "comp": "md-tabs", "attributes": { "persist-selection": true, "tabs-id": "コンテナ内のすべてのタブの一意の ID" }, }

財産

説明

選択を持続する

md-tabs を永続的に設定するには。 デフォルト値は trueです。

タブ ID

コンテナー内のすべてのタブの一意の識別子。

md-tabs を永続的 (persist-selection: true) に設定すると、エージェントがデスクトップ内のページまたはウィジェットを切り替えても、Agent Desktop は Tab の選択を保持します。

  • persist-selection プロパティは、永続的な Tab 動作がすでにデスクトップに設定されているため、[補助情報] ペインと [エージェント パフォーマンス統計レポート] ページのタブには適用されません。
  • デスクトップからサインアウトするか、ブラウザを再読み込み/更新するか、ブラウザのキャッシュをクリアすると、Tab の選択はデフォルトの Tab にリセットされます。

永続ウィジェットの設定

任意のカスタム ウィジェットを永続的に設定できます。 永続ウィジェットはデスクトップのすべてのページに表示されます。 永続ウィジェットは、アクティブな連絡先リクエストまたは会話がある場合にのみ、補助情報ペインに新しい Tab として表示されます。 たとえば、 サンプル永続 ウィジェット。

永続ウィジェットは、他のページに表示されるのと同じように Home ページには表示されません。 ただし、アクティブなインタラクションがある場合は、永続的なウィジェットが [補助情報] ペインの一部として Home ページに表示されます。 たとえば、通話に応答すると、インタラクションコントロールペインが表示され、 サンプル永続 ウィジェットは補助情報ペインの一部として表示されます。

例:

"area": { "persistent": [{ "comp": "md-tab", "attributes": { "slot": "Tab" }, "children": [{ "comp": "md-icon", "attributes": { "name": "emoticons_16" } }, { "comp": "span", "textContent": "カスタムページウィジェット" } ] }, { "comp": "md-tab-panel", "attributes": { "slot": "panel" }, "children": [{ "comp": "dynamic-area", "properties": { "area": { "id": "dw-panel-two", "widgets": { "comp1": { "comp": "agentx-wc-iframe", "attributes": { "src": "https://blog.logrocket.com/the-ultimate-guide-to-iframes/" }, "wrapper": { "title": "AgentX iFrame", "maximizeAreaName": "app-maximize-area" } }, "comp2": { "comp": "uuip-widget-two", "script": "./dynamic-widgets/widget-two.js", "attributes": { "title": "ウィジェット 2 のコンテンツ" }, "wrapper": { "title": "ウィジェット 2 のタイトル", "maximizeAreaName": "app-maximize-area" } } }, "layout": { "areas": [ ["comp1", "comp2"] ], "size": { "cols": [1, 1], "rows": [1] } } } }] } ] }

ウィジェットをカスタマイズするときは、次のいずれかのオプションを選択できます。

  • Iframe 内に埋め込むことができる Web ページ上でアプリケーションをホストします。

  • カスタム ウィジェットを構築します。

技術的なウィジェットの要件については、 デスクトップウィジェット開発ドキュメント。 レイアウト エディターとして、次の詳細があることを確認してください。

  • カスタム HTML 要素 (Web コンポーネントとも呼ばれます) の名前は何ですか?

  • JavaScript バンドルをホストするコンテンツ配信ネットワーク (CDN) ソースへの URL は何ですか?

ヘッダーウィジェット

ヘッダーは、インライン情報を表示したり、ドロップダウン メニューを追加したりするために使用されます。 ヘッダー コンテナーの垂直方向のスペースは限られているため、ヘッダー全体の高さは 64 ピクセルのみです。 レイアウトの配置の詳細については、 レイアウト プロパティ セクションを参照してください。

例:

"header":{ "id":"header", "widgets":{ "head1":{ "comp":"header-widget-one", "script":"https://my-cdn.com/dynamic-widgets/header-widget-one.js", }, "head2":{ "comp":"header-widget-two", "script":"https://my-cdn.com/dynamic-widgets/header-widget-two.js", } }, "layout":{ "areas":[[ "head1", "head2" ]], "size": { "cols": [1, 1], "rows": [1] } } }

ヘッダー ウィジェットにツールチップを追加するには、コンポーネントを md-tooltip でラップしますmessage プロパティにツールチップ情報を入力します。

例:

"ヘッダー": { "id": "dw-header", "ウィジェット": { "head1": { "comp": "md-tooltip", "属性": { "message": "Netlify" }, "children": [{ "comp": "agentx-wc-iframe", "属性": { "src": "https://keen-jackson-8d352f.netlify.app" } }] }, }, }

ヘッダーのカスタマイズ可能なウィジェット領域で iFrame を通じてウィジェットを構成するには、スタイル属性 displayheight を追加する必要があります。 高さ 属性の最適な値は 64 ピクセルです。

既存のヘッダー ウィジェットが iFrame 内で期待どおりに読み込まれるように、スタイル属性を既存のヘッダー ウィジェットに追加してください。

例:

"head1": { "comp": "agentx-wc-iframe", "attributes": { "src": "https://widget-kad.s3.amazonaws.com/Headers/Timer/Timer.htm", "style": "height:64px;display:flex;" } },

ヘッダーの高さは 64 ピクセルしかないため、ヘッダーには複数の列を持つ 1 行のみを使用することをお勧めします。 配置の詳細については、 レイアウト プロパティ セクションを参照してください。

補助情報ペイン

デスクトップの補助情報ペインには、シスコが提供する (デフォルトの) ウィジェットとカスタム ウィジェットを含むタブが表示されます。 事前定義されたタブには、Cisco が提供する次のウィジェットが表示されます。

  • 問い合わせの履歴

  • IVR トランスクリプト

  • 顧客体験の旅

  • スクリーンポップアップ

補助情報ペインを使用すると、次のことができます。

  • タブを追加する

  • Tab の順序を変更する

  • 定義済みのタブを削除する

  • カスタムタブをドラッグ可能としてマークする

  • カスタムタブにツールチップを追加する

  • 「Tab 注文をリセット」 オプションを追加します

例:

"panel": { "comp": "md-tabs", "attributes": { "class": "widget-tabs" }, "children": [{ "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "slot", "attributes": { "name": "CONTACT_HISTORY_TAB" } }] }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "slot", "attributes": { "name": "CONTACT_HISTORY" } }] }, { "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "md-icon", "attributes": { "name": "pop-out_16" } }, { "comp": "span", "textContent": "スクリーンポップ" } ], "visibility": "SCREEN_POP" }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "#SCREEN_POP" }], }, { "comp": "md-tab", "attributes": { "slot": "Tab" }, "children": [{ "comp": "md-icon", "attributes": { "name": "emoticons_16" } }, { "comp": "span", "textContent": "カスタムウィジェット" } ] }, { "comp": "md-tab-panel", "attributes": { "slot": "panel" }, "children": [{ "comp": "dynamic-area", "properties": { "area": { "id": "dw-panel-two", "widgets": { "comp1": { "comp": "agentx-wc-iframe", "attributes": { "src": "https://blog.logrocket.com/the-ultimate-guide-to-iframes/" }, "wrapper": { "title": "AgentX iFrame", "maximizeAreaName": "app-maximize-area" } }, "comp2": { "comp": "widget-one", "script": "https://my-cdn.com/dynamic-widgets/widget-one.js", "wrapper": { "title": "ウィジェットのタイトル", "maximizeAreaName": "app-maximize-area" } } }, "レイアウト": { "エリア": [ ["comp1"], ["comp2"] ], "サイズ": { "列": [1], "行": [1, 1] } } } } }] } ] },

管理ポータルでカスタマー エクスペリエンス管理メトリックを有効にした後、カスタマー エクスペリエンス ジャーニー ウィジェットを構成できます。

補助情報ペインで、カスタム ウィジェットを配置するための新しいタブを追加します。 ここでは特別なルールは適用されず、コンポーネントのネストも予想どおりで、 children セクションで説明されています。 詳細については、ページの Children プロパティを参照してください。

以下は、Tab ヘッダーをカスタマイズするための具体的な例です。

Children プロパティにアイコンとラベルを配置する例

{ "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "md-icon", "attributes": { "name": "transcript_16" } }, { "comp": "span", "textContent": "My Widget Tab" } ], },

Children プロパティに画像(CSS 付き)とラベルを配置する例

{ "comp": "md-tab", "attributes": { "slot": "Tab" }, "children": [{ "comp": "span", "attributes": { "style": "align-items: center; display: flex;" }, "children": [{ "comp": "img", "attributes": { "src": "http://my-cdn.com/icon.svg", "width": 16, "height": 16, "style": "margin-right: 0.5rem;" } }, { "comp": "span", "textContent": "私のウィジェット Tab" } ] }], },

補助情報ペインに複数のタブが含まれている場合は、 その他のタブ ドロップダウン リストが自動的に表示されます。

読みやすさとアクセシビリティのために、カスタム Tab ツールヒントを追加する必要があります。 カスタム Tab のツールチップを追加するには、コンポーネントを md-ツールチップ。 ツールチップ情報を入力します。 メッセージ プロパティを適用し、 スタイル 次の例に示すようにプロパティ値を指定します。

"comp": "md-tooltip", "attributes": { "class": "widget-tabs", "message": "サンプル Tab 1", "style": "max-width: 252px; min-width: 110px; Overflow: Hidden; Text-overflow: ellipsis; White-space: Nowrap; Display: Inline-block; margin-bottom: -10px;" },

カスタム Tab の場合、最大幅 252 ピクセル、最小幅 110 ピクセルにすることをお勧めします。

カスタム Tab 内でドラッグアンドドロップ機能を有効にするには、次のプロパティを追加します。 属性

"comp": "md-tabs", "attributes": { "class": "widget-tabs", "draggable": true, "comp-unique-id": "sample-dynamic-custom-tabs" },
  • ドラッグ可能: 設定 ドラッグ可能 不動産価値を 真実

  • コンピュータ固有 ID : コンポーネントを識別するための一意の値を入力します。

    例:

    "comp-unique-id": "sample-dynamic-custom-tabs" 

カスタム Tab のドラッグ アンド ドロップを有効にすると、エージェントは Tab を [補助情報] ペイン内の必要な位置にドラッグ アンド ドロップできます。 タブをデフォルトの Tab 順序にリセットするには、次のプロパティを追加します。

"comp": "agentx-wc-more-actions-widget", "attributes": { "slot": "settings", "class": "widget-pane", "tabs-unique-id": "sample-dynamic-custom-tabs" },
  • agentx-wc-その他のアクションウィジェット: 表示されるコンポーネントを入力します。 その他のアクションその他のアクションアイコン) アイコンをクリックします。

  • スロット="設定" : コンポーネント内で表示される属性を入力します。 Tab 注文をリセット オプションの その他のアクション ドロップダウンリスト。 エージェントは、補助情報ペインのタブをデフォルトの順序にリセットするには、 その他のアクションアイコン > Tab 注文をリセット

  • タブの固有 ID : に定義されているのと同じ一意の値を入力します。 コンピュータ固有 ID プロパティをマップしてリセットする md-タブ コンポーネント。

次のサンプル コードでは、 その他のアクション および Tab 順序のリセット 機能を使用しています。

"comp": "agentx-wc-more-actions-widget", "attributes": { "slot": "settings", "class": "widget-pane", "tabs-unique-id": "sample-dynamic-custom-tabs" }, "children": [{ "comp": "div", "attributes": { "textContent": "custom action", "slot": "custom-action" }, "children": [{ "comp": "agentx-wc-notes-header-widget" }, { "comp": "agentx-wc-menu-notification" } ] }], }
Webex Contact Center more actions menu example, showing the 'Reset Tab Order' option.

デフォルトでは、定義済みタブのツールヒント、省略記号アイコン、および Tab 順序リセットが定義されています。

[その他のアクション] ドロップダウン リストを拡張して、 [Tab 順序をリセット] オプションの後に、追加のカスタム コンポーネントまたはウィジェットを追加できます。 以下は、追加のコンポーネントに適用できる スタイル プロパティ値のサンプル セットです。

"comp": "md-tooltip", "attributes": { "class": "widget-tabs", "message": "サンプル要素", "style": "max-width: 252px; min-width: 110px; Overflow: Hidden; Text-overflow: ellipsis; White-space: Nowrap; Display: Inline-block; margin-bottom: -10px;" },
Webex Contact Center more actions menu example, showing additional, custom options that can be added after the 'Reset Tab Order' option.

ドラッグ アンド ドロップ機能は、 [その他のアクション] ドロップダウン リストに追加された追加のカスタム コンポーネントまたはウィジェットではサポートされません。

ヘッドレスウィジェット

ヘッドレス セクションでは、Agent Desktop に表示されない非表示のウィジェットを追加できます。 これらのウィジェットは、バックグラウンドでロジックを実行するために使用されます。 このセクションは、デスクトップで発生するイベントをトリガーし、ウィジェット固有のロジックを実行するのに役立ちます。 たとえば、SMS が到着すると、カスタム CRM スクリーン ポップが開きます。

例:

"headless":{ "id":"headless", "widgets":{ "comp1":{ "comp":"headless-widget-one", "script":"https://my-cdn.com/dynamic-widgets/headless-widget-one.js", }, "comp2":{ "comp":"headless-widget-two", "script":"https://my-cdn.com/dynamic-widgets/headless-widget-two.js", } }, "layout":{ "areas":[[ "comp1", comp2" ]], "size": { "cols": [1, 1], "rows": [1] } } }

デスクトップからウィジェットにデータを共有する

カスタム ウィジェット内のプロパティまたは属性を通じてリアルタイム データを受信するには、レイアウト JSON 構成で適切な STORE 値を割り当てます。

さらに、JavaScript SDK サブスクライバーを通じてデータにアクセスするには、プロパティまたは属性を通じてデータを渡すこともできます。 コンポーネントがプロパティまたは属性の変更に反応するように構築されている場合は、データ プロバイダーと呼ばれる Agent Desktop からリアルタイムのデータ更新が取得されます。

現在、キー STORE の下に 1 つのデータ プロバイダーがあります。 詳細については、『 Cisco Webex Contact Center デスクトップ開発者ガイド 』の「 データプロバイダー - ウィジェットのプロパティと属性」セクションを参照してください。

プレビューキャンペーンコール

管理者はキャンペーンを作成し、ダイヤル モード (プレビュー) を構成し、キャンペーンをチームに割り当てます。 エージェントがキャンペーンが割り当てられているチームの一員である場合、エージェントはアウトバウンド プレビュー キャンペーン コールを発信できます。 詳細については、 「Webex Contact Center の音声アウトバウンド キャンペーン モードの構成」 を参照してください。

管理者は、エージェントのプレビュー キャンペーン コンタクトを有効にするために、カスタム レイアウトで次の設定を行います。

キャンペーン連絡先

管理者は、カスタム レイアウトのヘッダー コンテナーにキャンペーン コンタクト ウィジェットを追加します。 キャンペーン連絡先には、定義されたプロパティに基づいて顧客の連絡先情報が表示されます。 レイアウトの配置の詳細については、「プロパティの詳細」ページの表の「レイアウト プロパティ」の行を参照してください。

例:

 "advancedHeader": [ { "comp": "agentx-preview-campaign", "properties": { "isCampaignManagementEnabled": "$STORE.agent.isCampaignManagementEnabled", "agentDbId": "$STORE.agent.acqueonAgentId", "lcmUrl": "$STORE.agent.lcmUrl", "isCallInProgress": "$STORE.agentContact.isActiveCall", "outdialEntryPointId": "$STORE.agent.outDialEp", "teamId": "$STORE.agent.getAcqueonTeamId", "campaignManagerAdditionalInfo": "$STORE.agent.campaignManagerAdditionalInfo", "orgId": "$STORE.agent.orgId", "dialerProxyHost": "$STORE.envVaribles.serviceUrls.dialerProxyHost", "isProgressiveCampaignEnabled": "$STORE.app.featuresFlags.isProgressiveCampaignEnabled" } }, { "comp": "agentx-webex" }, { "comp": "agentx-outdial" }, { "comp": "agentx-notification" }, { "comp": "agentx-state-selector" } ] 

通話ガイド

通話ガイド ウィジェットは、デスクトップの補助情報ペインに表示されます。 通話ガイドには、キャンペーン レベルで質問と回答が表示されます。 エージェントは、通話ガイド内の一連の質問を読み、回答を送信するように求められます。

例:

"panel":{ "comp":"md-tabs", "attributes":{ "class":"widget-tabs" }, "children":[ { "comp":"md-tab", "attributes":{ "slot":"Tab", "class":"widget-pane-tab" }, "children":[ { "comp":"md-icon", "attributes":{ "name":"icon-note_16" } }, { "comp":"span", "textContent":"通話ガイド" } ], "visibility":"CALL_GUIDE" }, { "comp":"md-tab-panel", "attributes":{ "slot":"panel", "class":"widget-pane" }, "children":[ { "comp": "acqueon-call-guide", "script": "http://localhost:5555//index.js", // CDN を含めるリンクはこちら "wrapper":{ "title":"通話ガイド", "maximizeAreaName":"app-maximize-area" }, "properties":{ "lcmKey":"$STORE.agentContact.getCallGuideProps.LCMKey", "agentDbId":"$STORE.agent.acqueonAgentId", "lcmUrl":"$STORE.agent.lcmUrl", "campaignManagerAdditionalInfo":"$STORE.agent.campaignManagerAdditionalInfo" "orgId": "$STORE.agent.orgId", "dialerProxyHost": "$STORE.envVaribles.serviceUrls.dialerProxyHost", "isProgressiveCampaignEnabled": "$STORE.app.featureFlags.isProgressiveCampaignEnabled" } } ], "visibility":"CALL_GUIDE" } ] }
  • 次の コンプ プロパティ参照が変更されました。 エージェント x プロパティ値が次のように置き換えられます アクエオン
    • エージェント X プレビューキャンペーン は次のように改名されます アクエオン プレビュー キャンペーン
    • エージェント X コールガイド は次のように改名されます アクエオンコールガイド
  • リストとキャンペーンマネージャ(LCM)を CDN でホストし、URL を スクリプト 財産。

スクリーンポップアップ

デスクトップ レイアウトでは、次のいずれかの方法でスクリーン ポップを構成できます。

  • カスタムページとして

  • カスタムページのウィジェットの 1 つとして

  • [Auxiliary Information]ペインのタブとして

スクリーン ポップは、次の要素に基づいてデスクトップに表示されます。

音声チャネルの場合:

  • デスクトップレイアウトで定義された構成

  • フローデザイナーで定義されたスクリーンポップアクティビティ

新しいデジタルチャネルの場合:

  • デスクトップレイアウトで定義された構成

  • Connect Flow Builder で定義されたスクリーンポップノード

スクリーンポップの設定の詳細については、 スクリーンポップ

ナビゲーションバーのスクリーンポップの設定

スクリーン ポップをカスタム ページとして、またはカスタム ページ内のウィジェットの 1 つとして構成できます。 スクリーンポップのカスタムページにアクセスするには、 スクリーンポップ ナビゲーション バーのアイコン。 カスタム ページのスクリーン ポップ ウィジェットにアクセスするには、ナビゲーション バーのカスタム アイコンをクリックします。 詳細については ナビ プロパティについては、 ナビゲーション(カスタムページ)

例: カスタムページとしてのスクリーンポップ

{ "nav": { "label": "スクリーンポップ", "icon": "ポップアウト", "iconType": "momentum", "navigateTo": "/screenpop", "align": "top" }, "page": { "id": "agentx-wc-screen-pop", "widgets": { "comp1": { "comp": "agentx-wc-screen-pop", "properties": { "screenPopUrl": "$STORE.session.screenpop.screenPopSelector" } } }, "layout": { "areas": [ ["comp1"] ], "size": { "cols": [1], "rows": [1] } } }, "visibility": "SCREEN_POP" }

例: カスタムページのウィジェットとしてのスクリーンポップ

"comp1": { "comp": "agentx-wc-screen-pop", "properties": { "screenPopUrl": "$STORE.session.screenpop.screenPopSelector" }

フロー デザイナーでスクリーン ポップが構成されていない場合、カスタム ページは空白で表示されます。 フロー デザイナーでスクリーン ポップを構成する方法の詳細については、 「スクリーン ポップ」を参照してください

補助情報ペインでのスクリーンポップの設定

スクリーン ポップを補助情報ペインに Tab として表示するように設定できます。

デフォルトでは、スクリーン ポップがフロー デザイナーで デスクトップ内 として表示されるように構成されている場合、スクリーン ポップは補助情報ペインの スクリーン ポップ Tab に新しいサブ Tab として表示されます。

panel セクションに次の属性を追加して、補助情報ペインに Tab として Screen Pop を含めます。 パネルの詳細については、「補助情報ペイン」を参照してください。

例: 補助情報ペインに Tab としてスクリーンポップする

 { "comp":"md-tab", "attributes":{ "slot":"Tab", "class":"widget-pane-tab" }, "children":[ { "comp": "md-icon", "attributes": { "name": "pop-out_16" }}, { "comp": "span", "textContent": "スクリーンポップ" }], "visibility": "SCREEN_POP" }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "#SCREEN_POP" } ], }

フロー デザイナーで定義されたスクリーン ポップ表示オプションは、デスクトップ レイアウトで定義された構成よりも優先されます。

たとえば、次のスクリーン ポップ設定を構成したとします。

  • フローデザイナー - 表示設定を 新しいブラウザで Tab
  • デスクトップレイアウト - 補助情報ペインの Tab として

スクリーン ポップが設定されているイベントが発生すると、スクリーン ポップはデスクトップの外部、つまり新しいブラウザーに表示されます Tab。

サンプルユースケース例

次のセクションでは、参考としていくつかの例を示します。

ナビゲーション バーからカスタマー エクスペリエンス管理メトリック ウィジェットを構成してアクセスする

例:

{ "nav": { "label": "カスタマーエクスペリエンス管理メトリクス", "icon": "/app/images/wxm.bcd45cc3.svg", "iconType": "other", "navigateTo": "wxm-metrics", "align": "top" }, "page": { "id": "wxm-metrics", "widgets": { "comp1": { "comp": "agentx-wc-cloudcherry-widget", "attributes": { "metrics": true }, "properties": { "userModel": "$STORE.app.userModel", "spaceId": "", "metricsId": "", "teamId": "$STORE.agent.teamName", "ani": "$STORE.agentContact.taskSelected.ani", "isDarkMode": "$STORE.app.darkMode" }, "wrapper": { "title": "カスタマーエクスペリエンスジャーニー", "maximizeAreaName": "app-maximize-area" } } }, "layout": { "areas": [ ["comp1"] ], "size": { "cols": [1], "rows": [1] } } } },

spaceId と metricsId を取得するには、 Webex Experience Management ドキュメントを参照してください。

カスタムページでのタブの使用

例:

{ "nav": { "label": "ダイナミックタブ", "icon": "stored-info", "iconType": "momentum", "navigateTo": "dynamic-tabs", "align": "top" }, "page": { "id": "page-id-tabs", "widgets": { "comp1": { "comp": "md-tabs", "children": [{ "comp": "md-tab", "textContent": "One", "attributes": { "slot": "Tab" } }, { "comp": "md-tab-panel", "attributes": { "slot": "panel" }, "children": [{ "comp": "widget-two", "script": "http:/my-cdn.com/dynamic-widgets/widget-two.js" }] }, { "comp": "md-tab", "textContent": "Two", "attributes": { "slot": "Tab" } }, { "comp": "md-tab-panel", "textContent": "2 つのコンテンツ", "attributes": { "slot": "panel" } } ] }, "comp2": { "comp": "widget-two", "script": " http:/my-cdn.com/dynamic-widgets/widget-two.js" } }, "layout": { "areas": [ ["comp1", "comp2"] ], "size": { "cols": [1, 1], "rows": [1] } } } }

連絡先履歴とスクリーンポップを備えたデフォルトの補助情報パネル

例:

"panel": { "comp": "md-tabs", "attributes": { "class": "widget-tabs" }, "children": [{ "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "slot", "attributes": { "name": "CONTACT_HISTORY_TAB" } }] }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "slot", "attributes": { "name": "CONTACT_HISTORY" } }] }, ] }, { "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, { "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "slot", "attributes": { "name": "SCREEN_POP_TAB" } }], "visibility": "SCREEN_POP" }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "slot", "attributes": { "name": "SCREEN_POP" } }], "visibility": "SCREEN_POP" } },

カスタマーエクスペリエンスジャーニーウィジェットを備えた補助情報パネル

例:

"panel": { "comp": "md-tabs", "attributes": { "class": "widget-tabs" }, "children": [{ "comp": "md-tab", "attributes": { "slot": "Tab" }, "children": [{ "comp": "slot", "attributes": { "name": "WXM_JOURNEY_TAB" } }], "visibility": "WXM_JOURNEY" }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "agentx-wc-cloudcherry-widget", "properties": { "userModel": "$STORE.app.userModel", "spaceId": "", "metricsId": "", "teamId": "$STORE.agent.teamName", "ani": "$STORE.agentContact.taskSelected.ani", "isDarkMode": "$STORE.app.darkMode" }, "wrapper": { "title": "カスタマーエクスペリエンスジャーニー", "maximizeAreaName": "app-maximize-area" } }], { "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": { "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "slot", "attributes": { "name": "CONTACT_HISTORY_TAB" } }] }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "slot", "attributes": { "name": "CONTACT_HISTORY" } }] }, { "comp": "md-tab", "attributes": { "slot": "Tab", "class": "widget-pane-tab" }, "children": [{ "comp": "slot", "attributes": { "name": "SCREEN_POP_TAB" } }], "visibility": "SCREEN_POP" }, { "comp": "md-tab-panel", "attributes": { "slot": "panel", "class": "widget-pane" }, "children": [{ "comp": "slot", "attributes": { "name": "SCREEN_POP" } }], "可視性": "SCREEN_POP" } "可視性": "SCREEN_POP" }, },

ローカリゼーション

デスクトップ UI は 29 の言語へのローカライズをサポートしています。

次の言語がサポートされています。

ブルガリア語、カタロニア語、中国語(中国)、中国語(台湾)、クロアチア語、チェコ語、デンマーク語、オランダ語、英語英語(イギリス)、英語(米国)、フィンランド語、フランス語、ドイツ語、ハンガリー語、イタリア語、日本語、韓国語、ノルウェー語、ポーランド語、ポルトガル語ポルトガル語(ブラジル)、ポルトガル語(ポルトガル)、ルーマニア語、ロシア語、セルビア語、スロバキア語、スロベニア語、スペイン語、スウェーデン語、トルコ語。

デスクトップ UI の言語は、ブラウザの言語設定に基づきます。 たとえば、Firefox ブラウザで優先言語をフランス語として選択したとします。 Firefox ブラウザでデスクトップを起動すると、デスクトップ UI が Français (フランス語) で表示されます。 ただし、デスクトップ レイアウトに追加された水平ヘッダー、ナビゲーション バー、その他のコンポーネントは、ブラウザーの言語設定に基づいてローカライズされません。

デスクトップコンポーネントのローカライズ

デスクトップコンポーネントをローカライズするには、

  • 既存のローカリゼーションキーを使用する アプリ.json ファイル。 ローカリゼーション キーが設定されていない場合は、デフォルトの言語である英語 (米国) が使用されます。 app.json ファイルにローカリゼーション キーを追加するには、Cisco サポートにサービス リクエストを送信します。

    例: ローカリゼーションキー

    { "common": { "buttonTitle": "タイマーを停止" } }
  • コンポーネントをローカライズするには、デスクトップ レイアウト JSON ファイルに次の大文字と小文字を区別するプロパティを入力します。

    "textContent": "$I18N.<key>", 

    ここで、 <key> は、 app.json ファイル内の対応するローカリゼーション キーを参照します。

例: ヘッダーコンポーネントのローカライズ

"header": { "id": "header", "widgets": { "head1": { "comp": "md-button", "attributes": { "slot": "menu-trigger", "style": "height: 64px" }, "children": [{ "comp": "span", "textContent": "$I18N.common.buttonTitle", } }, }, }

例: 補助情報ペインで Tab コンポーネントをローカライズする

"パネル": { "comp": "md-tab", "属性": { "スロット": "Tab" }, "子供": [{ "comp": "span", "textContent": "$I18N.panelTwo.screenPopTitle" }] }