カスタム パネルを設定する

カスタム パネルには、外部リソースの 1 つ以上の URL が表示されます。ドキュメント、ツール、その他のリソースなどがあります。複数のリンクを含むカスタム URL のパネルまたはカスタムリンクのパネルを構成できます。これらのパネルタイプの構成オプションは若干異なります。たとえば、カスタムリンク パネルでリンク テキストを指定できます。

カスタム URL のパネルを構成する

外部リソースへの URL を含むカスタム パネルを構成できます。必要に応じて、パネルにナビゲーション バーを含めることができます。認証などの目的で HTTP ヘッダーを追加することもできます。

カスタム URL のパネルを構成する手順は次のとおりです。

  1. CCAI Platform ポータルで、[設定] > [運用管理] をクリックします。[設定] メニューが表示されない場合は、 [メニュー] をクリックします。

  2. [Agent Desktop] ペインに移動します。

  3. [カスタム パネルの管理] で、[カスタム パネルのリストを管理] をクリックします。[カスタム パネル] ペインが表示されます。

  4. [カスタム パネルを追加] > [カスタム URL] をクリックします。[カスタム URL を追加] ペインが表示されます。

  5. カスタム パネルの名前を追加する手順は次のとおりです。

    1. [言語を選択] フィールドをクリックし、カスタム パネル名の言語をクリックします。

    2. [カスタム パネル名を入力] フィールドに、パネルの名前を入力します。

  6. 省略可: 別の言語でパネル名を追加するには、[カスタム パネル名を追加] をクリックし、別の言語で上記の手順を繰り返します。

  7. パネル名を複数の言語で追加した場合は、デフォルトの言語を選択します。

  8. [表示 URL] フィールドに、外部リソースの URL を入力します。URL で変数関数を使用できます。

  9. 省略可: エージェントの割り当てられた地域または言語の選択に基づいてカスタムパネルの言語を動的に制御するには、カスタムパネルの言語を動的に制御するをご覧ください。

  10. このパネルにナビゲーション バーを表示する場合は、[カスタム パネルにナビゲーション バーを表示する] チェックボックスをオンにします。

  11. HTTP ヘッダーを追加する手順は次のとおりです。

    1. [HTTP ヘッダー] で、[フィールドを追加] をクリックします。

    2. HTTP ヘッダーのキーと値を入力します。値には変数関数を使用できます。

  12. 別の HTTP ヘッダーを追加するには、[フィールドを追加] をクリックして、これらの手順を繰り返します。

  13. [カスタム URL パネルを追加] をクリックします。カスタム パネルが [カスタム パネル] リストに表示されます。

外部リソースへのリンクのリストを含むカスタム パネルを構成できます。このパネルを使用すると、エージェントは通話セッションやチャット セッションの処理中に必要なリソースにすばやくアクセスできます。

カスタムリンク パネルを設定する手順は次のとおりです。

  1. CCAI Platform ポータルで、[設定] > [運用管理] をクリックします。[設定] メニューが表示されない場合は、 [メニュー] をクリックします。

  2. [Agent Desktop] ペインに移動します。

  3. [カスタム パネルの管理] で、[カスタム パネルのリストを管理] をクリックします。[カスタム パネル] ペインが表示されます。

  4. [カスタム パネルを追加] > [カスタムリンク] をクリックします。[カスタムリンクの追加パネル] ペインが表示されます。

  5. カスタム パネルの名前を追加する手順は次のとおりです。

    1. [言語を選択] フィールドをクリックし、カスタム パネル名の言語をクリックします。

    2. [カスタム パネル名を入力] フィールドに、パネルの名前を入力します。

  6. 省略可: 別の言語でパネル名を追加するには、[カスタム パネル名を追加] をクリックし、別の言語を使用して新しい行を入力します。

  7. パネル名を複数の言語で追加した場合は、デフォルトの言語を選択します。

  8. リンクを追加する手順は次のとおりです。

    1. [リンクを追加] をクリックします。[リンクを追加] ペインが表示されます。

    2. [URL] フィールドに、外部リソースの URL を入力します。URL では、変数関数を使用できます。

    3. 省略可: エージェントの割り当てられた地域または言語の選択に基づいてカスタムパネルの言語を動的に制御するには、カスタムパネルの言語を動的に制御するをご覧ください。

  9. URL のリンクテキストを追加する手順は次のとおりです。

    1. [言語を選択] フィールドをクリックし、リンクテキストの言語をクリックします。

    2. [リンクテキスト] フィールドに、リンクのリンクテキストを入力します。

  10. 省略可: 別の言語でリンクテキストを追加するには、[リンクテキストを追加] をクリックし、別の言語を使用して新しい行を入力します。

  11. 複数の言語でリンクテキストを追加した場合は、デフォルトの言語を選択します。

  12. [リンクの表示先] で、リンクを新しいタブで開くか、パネルで開くかを指定します。

  13. HTTP ヘッダーを追加する手順は次のとおりです。

    1. [HTTP ヘッダー] で、[フィールドを追加] をクリックします。

    2. HTTP ヘッダーのキーと値を入力します。値には変数関数を使用できます。

  14. 別の HTTP ヘッダーを追加するには、[フィールドを追加] をクリックして、これらの手順を繰り返します。

  15. [追加] をクリックします。

  16. [カスタム URL パネルを追加] をクリックします。カスタム パネルが [カスタム パネル] リストに表示されます。

カスタムパネルの言語を動的に制御する

カスタム URL で {AGENT_LOCATION_LANGUAGE} または {AGENT_LANGUAGE} 変数を使用して、カスタム パネルの言語を動的に制御できます。

  • エージェントのロケーションの言語: URL に {AGENT_LOCATION_LANGUAGE} 変数を追加すると、エージェントの割り当てられたロケーションの言語でカスタム パネルが表示されます。例: https://YOUR_CCAAS_HOST/lang={AGENT_LOCATION_LANGUAGE}。詳細については、変数をご覧ください。

  • エージェントの言語: URL に {AGENT_LANGUAGE} 変数を追加して、エージェント デスクトップの言語セレクタでエージェントが選択した言語でカスタム パネルを表示します。エージェントが言語セレクタで言語を変更すると、カスタム パネルが再読み込みされ、新しく選択された言語が表示されます。(例: https://YOUR_CCAAS_HOST/lang={AGENT_LANGUAGE})。詳細については、変数をご覧ください。

変数

URL と HTTP ヘッダー フィールド値には、次の変数を含めることができます。これらの変数は、エージェント、エンドユーザー、セッションの情報を取得します。

エージェント変数

  • {AGENT_ID}: エージェント ID

  • {AGENT_CUSTOM_ID}: エージェントのカスタム ID

  • {AGENT_EMAIL}: エージェントのメールアドレス

  • {AGENT_ALIAS}: エージェントのエイリアス

  • {AGENT_LOCATION_LANGUAGE}: エージェントの割り当てられた場所の言語の言語コード(例: en-US)。この変数を使用するには、エージェントに言語が割り当てられた場所が割り当てられている必要があります。詳細については、地域と言語を構成するをご覧ください。

  • {AGENT_LANGUAGE}: エージェントがエージェント デスクトップの言語セレクタで選択する表示言語の言語コード(例: en-US)。エージェントが言語セレクタで言語を変更すると、カスタムパネルが再読み込みされ、新しく選択された言語が表示されます。詳しくは、表示言語を変更するをご覧ください。

エンドユーザー変数

  • {UJET_ID}: エンドユーザー ID

  • {ANI}: エンドユーザーの電話番号

  • {DEVICE_TYPE}: エンドユーザーのデバイスタイプ

セッション変数

  • {SESSION_TYPE}: セッション タイプ

  • {PHONE_NUMBER}: エンドユーザーの電話番号

  • {SESSION_ID}: 通話 ID またはチャット ID

  • {MENU_PATH}: メニューの URL パス

  • {QUEUE_NAME}: キューの名前

  • {QUEUE_ID}: 内部キュー ID

  • {LANGUAGE}: キューの言語

  • {OUTBOUND_PHONE_NUMBER}: 発信電話番号

  • {SUPPORT_PHONE_NUMBER}: エンドユーザーが電話をかけているサポートの電話番号

関数

次の表の関数は、URL と HTTP ヘッダー フィールド値に含めることができます。

関数 構文 説明
デフォルト値 =DEFAULT_VALUE(value_1, value_2) null または空でない限り value_1 を使用し、それ以外の場合は value_2 を使用します。
連結 OR =CONCAT_OR(value_1, value_2, value_3) OR で連結された複数の値。例: value_1 OR value_2 OR value_3
連結 AND =CONCAT_AND(value_1, value_2, value_3) 複数の値を AND で連結します。例: value_1 AND value_2 AND value_3
JSON =JSON({"key_1":"value_1", "key_2":"[value_2]"}) JSON を文字列に変換します。例: {"key_1":"value_1","key_2":"value_2"}
JSON 配列 =JSON_ARRAY({"key_1":"value_1"},{"key_2":"value_2"}) JSON 配列を文字列に変換します。例: [{"key_1":"value_1"},{"key_2":"value_2"}]