使用可能なエージェントがない場合はチャット・アイコンを非表示

管理者は、指定されたキューの少なくとも1つに対してエージェント(おそらく人間ですが、必ずしもそうではない)が使用可能な場合にのみ表示されるようにチャット起動アイコンを構成できます。使用可能なエージェントがない場合、チャット・アイコンは非表示になります。また、チャットを構成する際には、wcfsCdnPathやi18nなどの多くの値がデフォルトで設定されるため、これらの属性が明示的に定義されていない場合、エラーは発生しません。

これにより、従業員がチャット開始ページを起動し、ライブ・エージェントに接続すると予想されるが、ヒューマン・エージェントが使用できない場合、チャットは無期限にキューに入れられるという状況を回避できます。

有効化および構成ステップ

Visual Builder Studioを活用して、アプリケーションを公開します。 Visual Builderを使用したアプリケーションの拡張の詳細は、Oracle Help Center→関心のあるアプリケーション・サービス領域→「Books」→「Configuration and Extension」を参照してください。

注意: 「wcfsCdnPath」を明示的に定義する必要はなくなり、削除することをお薦めします。ただし、これを明示的に定義する場合は、条件付きチャットはバージョン25.10以上でのみ機能するため、この値を次のように変更する必要があります。
"wcfsCdnPath": "https://ee.channels.ocs.oraclecloud.com/wcfs/25.10.0/wcfs-sdk.js"

条件付きチャットを構成するには:

ナビゲータから、「構成」→「Visual Builder」に移動し、適切なプロジェクトおよびワークスペースを開きます。
Visual Builder Studioで、左側のパネルにあるアプリケーションUI ->カスタマ・エクスペリエンス(CX) ->ヘルプ・デスク->ヘルプデスクにナビゲートします。
「変数」タブをクリックします。
chatSetup変数をクリックし、JSONを置き換えて、条件付きチャット起動属性を含めるようにenableChat変数を設定し、エージェントが使用可能かどうかを考慮するときに考慮する必要があるキューを指定します。

"conditionalLaunchButton":"liveAgent","conditionalLaunchButtonDetails":{"queueId":"<queueId1>, <queueId2>"},

1つのデフォルト・チャット・キュー(指定する必要がある値)のみでチャットを最初に設定するときに、直接使用できる例は、次のとおりです。

{
    "enableChat": true,
    "conditionalLaunchButton": "liveAgent",
    "conditionalLaunchButtonDetails": {
        "queueId": "<queueId>"
    },
    "launchForm": [
         {
            "name": "subject",
            "required": false,
            "relaunchValue": "clear"
        }
    ]
}

次に、キューIDに例の値が使用されている、より複雑な例を示します。

{
    "enableChat": true,
    "position": {
        "bottom": "10px",
        "right": "10px"
    },
    "conditionalLaunchButton": "liveAgent",
    "conditionalLaunchButtonDetails": {
        "queueId": "300100714595596,300100721412398,30100714595611,300100714595599,300100714595602"
    },
    "launchForm": [
        {
            "name": "serviceRequestNumber",
            "required": false,
            "relaunchValue": "keep"
        },
        {
            "name": "subject",
            "required": false,
            "relaunchValue": "clear"
        },
        {
            "name": "stripeCode",
            "required": true,
            "relaunchValue": "default",
            "options": [
                {
                    "value": "ORA_SVC_HRHD",
                    "text": "Personnel/Personal Issue (HRHD)"
                },
                {
                    "value": "ORA_SVC_ISR",
                    "text": "Business Issue (ISR)"
                }
            ]
        },
        {
            "name": "queueId",
            "required": true,
            "relaunchValue": "clear",
            "options": [
                {
                    "value": "300100714595596",
                    "text": "Benefits"
                },
                {
                    "value": "300100714595602",
                    "text": "Complaint/Grievance"
                },
                {
                    "value": "300100714595599",
                    "text": "Payroll"
                },
                {
                    "value": "300100714595605",
                    "text": "Employment Changes"
                },
                {
                    "value": "300100714595611",
                    "text": "Maintenance Requests"
                },
                {
                    "value": "300100721412398",
                    "text": "Sales Support"
                },
                {
                    "value": "300100714595608",
                    "text": "Other HR Question"
                }
            ]
        }
    ],
    "i18n": {
        "en": {
            "chatTitle": "Live Chat Agent\nAvailable M-F,\n 6AM-11PM ET",
            "postConversationMessage": "What's Next?",
            "postConversationPrintButtonLabel": "Save Chat Transcript"
        }
    },
    "postConversationMessageOptions": {
        "type": "message",
        "enablePrintButton": true
    }
}

ヒントと考慮事項

属性を追加する前に、「ヘルプ・デスクのライブ・チャットを構成するにはどのようにするのですか。」の手順を使用して、まずチャットを有効にして作業することを強くお薦めします。

主なリソース

ライブ・チャットの一般的な構成方法の例は、「ヘルプ・デスクのライブ・チャットはどのようにして構成するのですか。」および「複数キューによるライブ・チャット(WN 24B)」- 「Oracle Video Hub」を参照してください。

アクセス要件

従業員がエージェントとチャットできるようにするには、ヘルプ・デスク・ユーザー・ロールが必要です。

チャット・エージェントには「チャット・エージェント機能の使用」権限が付与されている必要があります。この権限は、デフォルトで職務ロール「チャット・エージェント」に付与されます。

即時利用可能なすべてのエージェント・ロールには、「チャット・トランスクリプトの表示」権限も付与されます。

最初にチャットを構成している管理者は、「サービス・リクエスト管理者」ジョブ・ロール(少なくともチャットの設定中に一時的に)と、「HRサービス・リクエスト管理」または「内部サービス・リクエスト管理」ロール、あるいは「サービスの設定」権限を持つ同様のロールを持っている必要があります。