--- sourceDocument: Yokohama 対話型インターフェース sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama 対話型インターフェース ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # ストアリリース 2.0.x で利用可能な仮想エージェント API 機能 # ストアリリース 2.0.x で利用可能な仮想エージェント API 機能 {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：24分 仮想エージェント API バージョン 2.0.x では、仮想エージェントおよびエージェントチャットで利用可能な同じ機能の多くにアクセスできます。これには、リッチコントロールのサポートや通知が含まれます。 ## 追加のリッチコントロールのサポート {#va-api-features-v2__section_bcd_4k1_kqb} 仮想エージェント API は、次のリッチコントロールをサポートするようになりました。 ブールコントロール : ブールコントロールは、ローカリゼーションを容易にするために応答を文字列 (Yes または No のいずれか) として返します。 トピックのローカリゼーションの詳細については、「[仮想エージェントの会話のローカライズ](https://servicenow-prod.fluidtopics.net/DjHK~kwfK5v58oZDllRs8w "ServiceNow プラットフォームには、ニーズに応じて、仮想エージェントの会話をローカライズする方法が複数用意されています。ローカリゼーションフレームワーク を使用して、機械翻訳、サードパーティプロバイダー、またはその両方を使用しているかにかかわらず、翻訳プロセスのすべての要素を管理します。")」を参照してください。 仮想エージェント API は、ブールコントロール用の次の JSON 例を送信します。 { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "7a36412253a13010ff59ddeeff7b12fb", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "Boolean", "group": "DefaultPicker", "required": true, "nluTextEnabled": false, "label": "Sample Response for boolean control", "options": [ { "label": "Yes" }, { "label": "No" } ] } ], "score": 1 } カスタムコントロール : カスタムコントロールを使用するトピックがサポートされるようになりました。カスタムコントロールの詳細については、「[カスタムコントロールを使用した仮想エージェントのカスタマイズ](https://servicenow-prod.fluidtopics.net/rq4~Q3epFsxdCZgvZmwAnw "カスタムコントロールは、ServiceNow 開発者が仮想エージェントのトピックまたはトピックブロックで使用するために作成できるコンポーネントです。このようなコントロールには、スライダーやビデオプレーヤーが含まれます。カスタムコントロールは、仮想エージェントデザイナーで提供されるコントロールを補完します。")」を参照してください。 テーブルボット応答コントロール : テーブルボット応答コントロールを使用するトピックがサポートされるようになりました。詳細については、「[テーブルボット応答コントロール](https://servicenow-prod.fluidtopics.net/nlmKfaKLDJkuzoo3orWukQ "仮想エージェントトピックでテーブルボット応答コントロールを使用して、ボット応答をテーブルとして表示します。")」を参照してください。 すべてのレコードが仮想エージェント API から一度に返されます。仮想エージェントは、API クライアントからの応答を待って次のコントロールを送信します。paginationBreak プロパティを使用して、レコードをチャンクでユーザーに表示します。たとえば、paginationBreak が 10 に設定されている場合、ユーザーには一度に 10 件のレコードが表示されます。クライアントが次のコントロールに移動する準備ができたら、「DONE」を送信する必要があります。 仮想エージェント API は、テーブルボット応答コントロール用の次の JSON 例を送信します。 { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Yes", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputTable", "group": "DefaultOutputTable", "label": "Sample Table Rich control", "headers": [ "Number", "Short description" ], "data": [ [ "INC0000005", "CPU load high for over 10 minutes" ], [ "INC0000015", "I can't launch my VPN client since the last software update" ], [ "INC0000025", "Need to add more memory to laptop" ], [ "INC0000035", "Reset my password" ], [ "INC0000055", "SAP Sales app is not accessible" ], [ "INC0009005", "Email server is down." ] ], "paginationBreak": 10, "totalSearchResultsCount": 6, "navigationBtnLabel": "Click for more" } ], "score": 1 } HTML ボット応答コントロール : HTML ボット応答コントロールを使用するトピックがサポートされるようになりました。詳細については、「[HTML ボット応答コントロール](https://servicenow-prod.fluidtopics.net/JKFU4xOHdi1WvoPsZCAZvA "HTML ボット応答コントロールを使用して、仮想エージェントボット応答で静的 HTML テキストを表示します。")」を参照してください。 仮想エージェント API は、HTML ボット応答コントロール用の次の JSON 例を送信します。 { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Yes", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputHtml", "group": "DefaultOutputHtml", "style": "inline", "height": 100, "width": 100, "value": " Sample Response for Html control ", "imageUrl": null, "imageHeight": 0, "imageWidth": 0, "links": null }, { "uiType": "InputText", "group": "DefaultText", "required": true, "nluTextEnabled": false, "label": "some text", "maskType": "NONE" } ], "score": 1 } 複数回答ボット応答コントロール : 複数回答ボット応答コントロールを使用するトピックがサポートされるようになりました。詳細については、「[複数回答ボット応答コントロール](https://servicenow-prod.fluidtopics.net/uCzKHmD7ii~ZpRKkXq64pQ "仮想エージェント トピックで複数回答ボット応答コントロールを使用し、2 つ以上の出力を順次表示します。出力は、テキスト、画像、リンク、または HTML にすることができます。ユーザーは、用意されたナビゲーションボタンを使用して、ある出力から次の出力に移動できます。")」を参照してください。 仮想エージェントAPI は、複数回答ボット応答コントロールに次の JSON 例を送信します。 { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "MultiPartOutput", "group": "DefaultMultiPartOutput", "navigationBtnLabel": "Click for more", "content": { "uiType": "OutputText", "value": "Text response from multiflow control example", "maskType": "NONE" } } ], "score": 1 } リッチテキストのサポート : リッチテキストを使用するトピックがサポートされるようになりました。リッチテキストには、太字または斜体のテキスト、ハイパーリンク、箇条書き、絵文字が含まれます。 ## その他の エージェントチャット の機能 {#va-api-features-v2__section_tbg_mg1_kqb} 仮想エージェント API は、エージェントチャットへの転送時に次の機能をサポートするようになりました。 エージェント名とアバターを渡す : プライマリボットがライブエージェントにチャットを転送すると、仮想エージェントは、エージェント名とアバターをプライマリボットに送信できます。これをアクティブにするには、エージェントチャット設定で \[エージェントの名前とアバター\] をアクティブ化します。 メッセージペイロードの例は次のようになります。 { "requestId":"f42f3550-5b44-4cde-aa52-9b6756b3131c", "clientSessionId":"U94CSJLEN", "message":{ "text":"Live Agent support.", "typed":true }, "userId":"U94CSJLEN", "body":[ { "uiType":"OutputText", "group":"DefaultText", "agentInfo":{ "sentFromAgent":true, "agentName":"Beth Anglin", "agentAvatar":"ee4eebf30a0004d963b5c5ac0d734dc4.iix?t=small" }, "value":"Thank you for contacting support. I am looking into your question now and will be with you shortly." } ], "agentChat":true, "score":1 } 詳細については、「[エージェントチャットの構成](https://servicenow-prod.fluidtopics.net/j80dhuZtH7GJM_Zze11_lQ "エージェントチャット を設定して、ライブエージェントが顧客とチャットし、エージェントとエンドユーザーのさまざまな会話機能を管理できるようにします。エージェントチャット を介して、エージェントはエンドユーザーと対話したり、インシデントまたはケースのレコードを作成したり、チャットを別のエージェントまたはキューに転送したりします。")」を参照してください。 ライブエージェント待機時間 : ライブエージェントへの転送時、プライマリボットは待機時間を受信してユーザーに表示できます。これを有効にするには、エージェントチャット設定の \[ライブチャットの待機ステータス\] フィールドで \[待機時間\] を選択します。spinnerType の値が wait_time に設定されます。\[ライブチャットの待機ステータス\] が \[なし\] に設定されている場合、spinnerType の値は none になります。 仮想エージェント API は、ペイロードの body パラメーターで次の JSON 例を送信します。 { "uiType":"ActionMsg", "actionType":"StartSpinner", "spinnerType":"wait_time", "message":"Routing you to a live agent...", "waitTime":"8 Seconds" } 詳細については、「[エージェントチャットの構成](https://servicenow-prod.fluidtopics.net/j80dhuZtH7GJM_Zze11_lQ "エージェントチャット を設定して、ライブエージェントが顧客とチャットし、エージェントとエンドユーザーのさまざまな会話機能を管理できるようにします。エージェントチャット を介して、エージェントはエンドユーザーと対話したり、インシデントまたはケースのレコードを作成したり、チャットを別のエージェントまたはキューに転送したりします。")」を参照してください。 プライマリボットから仮想エージェントへのチャット履歴の送信 : プライマリボットは、チャット履歴をライブエージェントに渡して、エージェントによる会話のコンテキストの確認を可能にできます。 仮想エージェントは、メッセージ履歴を HTML に変換してから画像に変換します。 * 変換された画像は、チャットの最初のメッセージとしてライブエージェントに送信されます。 * プライマリボットは、最初の要求でメッセージ履歴を送信する必要があります。最初の要求の後の他の要求では、メッセージ履歴ペイロードは無視されます。 * テキストメッセージのみがサポートされます。 * プライマリボットは任意の URL をテキストメッセージの値として渡すことができますが、ライブエージェントはそれを画像の一部としてのみ表示できます。ライブエージェントではリンクをクリックできなくなります。 {#va-api-features-v2__ul_thk_p31_kqb} メッセージ ペイロードの例： {​       "value": "Help me with password reset",​       "displayName": "able",​       "type": "text"​       "isBotMessage": false,​     } 注: 前の例で、type は大文字と小文字を区別するため、text の値を指定する必要があります。 ## プライマリボットからの強化された要求 {#va-api-features-v2__section_xcn_f41_kqb} 仮想エージェント API は、プライマリボットからの次の要求をサポートするようになりました。 システムパラメーターとコンテキスト変数 : プライマリボットはシステムパラメーターとコンテキスト変数を入力として渡すことができ、仮想エージェントはこれらのパラメーターを受け入れます。liveagent_devicetype、liveagent_requester_session_language、liveagent_topic、topic、live_agent_only、liveagent_devicetimezone などのシステムパラメーターがサポートされます。カスタムコンテキスト変数とエージェントチャットコンテキスト変数もサポートされます。 メッセージ ペイロードの例： {​ "requestId": "f42f3550-5b44-4cde-aa52-xxxxxxxxxx",​ "clientSessionId": "xxxxxxxxxx",​ "token": "abcd",​ "message": {​     "text": "Test",​     "typed": true​ },​ "contextVariables": {​        "requester_session_language": "es"​ },​ "userId": ""abel.tuter",​ "emailId": "abel.tuter@example.com"​ }​ 詳細については、「[ライブエージェントチャットのコンテキスト変数](https://servicenow-prod.fluidtopics.net/p7gv_1R6bBpVRyDQofap3w "チャットコンテキスト変数を使用して、トピックから特定の情報を渡してライブエージェントと共有したり、ボット会話をライブエージェントにルーティングする方法を制御します。仮想エージェント には一部のデフォルト変数が含まれ、新しい変数を定義できます。")」と「[チャット関連情報を保存するためのコンテキスト変数を設定](https://servicenow-prod.fluidtopics.net/_nOBVAYenyYvTeo5JnQfLA "チャット前のサーベイ応答などのチャット関連情報を保存するために、チャットコンテキスト変数 (ライブエージェント チャット変数とも呼ばれる) を指定します。これらの変数には、トピックのインテントを決定したり、チャットをライブエージェントにルーティングする方法をコントロールするために使用できる、コンテキスト情報が含まれています。また、変数を定義して 仮想エージェント トピックスクリプトに渡されたコンテキスト情報をキャプチャし、それをライブエージェントと共有することもできます。")」を参照してください。 ユーザーのタイムゾーン : ユーザーのタイムゾーンを要求ペイロードに渡して設定します。一度設定すると、そのタイムゾーン設定はリセットされるまで保持されます。 メッセージ ペイロードの例： {​     "requestId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxxxxxx",​     "clientSessionId": "xxxxxxxx-xxxx",​     "token": "xxxxx",​     "action" : "SET_USER_TIMEZONE",​     "userId": "able.tuter",​     "emailId": "abel.tuter@example.com",​      "timezone":"Asia/Kolkata"​ } この機能を使用する場合は、次の点を考慮してください。 * 日付と時刻をユーザーのタイムゾーンに変換するには、会話がオープン (現在) である必要があります。 * プライマリボットは、次のいずれかの形式で日付と時刻を送信する必要があります。 * タイムゾーン名。たとえば、Asia/Kolkata、America/New_York などです。 * 日時 24 時間形式。例： YYYY-MM-DD HH:MM:SS {#va-api-features-v2__ul_wjl_qjb_kqb} * 仮想エージェント API は、設定するタイムゾーンが \[sys_user\] テーブルに格納されている値と異なる場合でも、プライマリボットによって指定されたタイムゾーンを使用します。 * ユーザーのタイムゾーンを設定するには、SET_TIMEZONE アクションを送信します。タイムゾーン名が有効でない場合、タイムゾーン値はデフォルトで UTC 時間に設定されます。2021-02-16 20:13:13 など。 {#va-api-features-v2__ul_vjl_qjb_kqb} ## ノードスキップのサポート {#va-api-features-v2__section_b13_zry_3qb} トピックでそのように設定されている場合、仮想エージェント API はノードのスキップをサポートします。たとえば、 仮想エージェントデザイナーでは、ユーザー入力コントロールをスキップ可能として指定できます 詳細このノードを非表示またはスキップ プロパティシートの領域。 図 : 1. ユーザーがノードをスキップできる条件またはスクリプト ノードをスキップ可能として定義する詳細については、「[仮想エージェントデザイナーユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/JIOzvnuMtkVwYtyoJhwixg "仮想エージェントデザイナーに用意されている一連の入力コントロール使用して、会話中のユーザーからの情報を求めてキャプチャします。")」を参照してください。 ノードがスキップ可能としてマークされている場合、ボットはそのオプションをユーザーに提示します。ユーザーがスキップした場合、次の例に示すように、プライマリボットがスキップコマンドを渡します。 { "requestId": "f42f3550-5b44-4cde-aa52-9b6756b3131c", "clientSessionId": "835607", "token": "snow", "message": { "text": "_skip_", "typed": false }, "emailId": "beth.anglin@example.com", "userId": "beth.anglin" } ## 同期ハンドシェイクのサポート {#va-api-features-v2__synchronous_support} 注: これらの要件は、仮想エージェント API のバージョン 2.0.x に適用されます。同期ハンドシェイク機能を強化するには、ライブエージェント転送やその他の拡張機能をサポートするバージョン 3.0.x にアップグレードします。詳細については、「[同期ハンドシェイクの機能拡張](https://servicenow-prod.fluidtopics.net/2BqwMTO0N4ljizhf0Udcsw#va-api-features-v3__synchronous_support_enhancements)」を参照してください。 有効にすると、仮想エージェントはプライマリボットに応答を同期的に配信します。同期モードで仮想エージェントとの通信を有効にするには、ハンドシェイクを機能させるために次の機能を手動でオフにする必要があります。 * エージェントチャット * 通知 * 入力インジケーター {#va-api-features-v2__ul_p3g_33j_gqb} 注: 次の機能を使用するトピックは、同期モードではサポートされていません： [ファイルアップロード](https://servicenow-prod.fluidtopics.net/JIOzvnuMtkVwYtyoJhwixg "仮想エージェントデザイナーに用意されている一連の入力コントロール使用して、会話中のユーザーからの情報を求めてキャプチャします。")、 [アクション ユーティリティ](https://servicenow-prod.fluidtopics.net/UOej~UXFDFc3osi50PzPBw "仮想エージェント トピックのアクションユーティリティを使用して、ノードが作成する必要があるフローアクションプロパティを選択します。アクションユーティリティは 仮想エージェント を ServiceNow ワークフロースタジオ 製品と統合します。")、および[一時停止トピックブロック](https://servicenow-prod.fluidtopics.net/~4gSTq36qptUdFe0X4qoOg "仮想エージェントは、トピック作成者またはアドミニストレーターがボットの会話で特定のプラットフォーム関連の機能またはタスクを実行するために使用できる、ビルド済みのトピックブロックを提供します。たとえば、特定のトピックブロックを使用すると、エージェントの可用性を確認したり、AI 検索 結果を生成したりできます。")。 これらの機能を無効にして同期サポートを有効にするには、次の手順を実行します。 1. エージェントチャットからボット間チャネルを除外します。 1. \[すべて\] に移動してから、フィルターに「sys_properties.list」と入力します。 2. com.glide.cs.exclude.liveagent.support システムプロパティを選択して開きます。 3. 「Bot To Bot」を \[値\] フィールドに追加します。 図 : 2. エージェントチャットからのボット間チャネルの除外 4. \[更新\] をクリックします。 {#va-api-features-v2__ol_fv2_jr4_kqb} 2. \[すべて\] に移動し、ナビゲーションフィルターに「sys_cs_channel.list」と入力します。 3. \[ボット間 (Bot to Bot)\] レコードを選択します。 4. 無効にするには、\[通知の有効化\] チェックボックスをオフにします。 5. 無効にするには、\[入力インジケーターをサポート\] チェックボックスをオフにします。 6. \[同期\] チェックボックスをオンにします。 図 : 3. 同期サポートを有効にしたボット間チャネル 注: \[同期\] フィールドが非表示の場合は、[フォームレイアウトを設定](https://www.servicenow.com/docs/access?context=configure-form-layout&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)して表示することができます。 7. \[更新\] をクリックします。 {#va-api-features-v2__ol_icm_x3j_gqb} ## 通知サポート {#va-api-features-v2__section_u3d_gcs_2qb} 非同期モードで有効になっている場合、仮想エージェント API を使用して、ボット間チャネルで次のタイプの通知を送信します。 * 簡易：テキストのみの通知。簡易通知は、到着するとすぐに配信されます。 * 画像カード：サーバーにアップロードされた画像、または URL で指定された画像。 * レコードカード：テーブル内のレコードから指定された列。 * アクション可能：ユーザーに特定のアクションを実行する機会を提供します。アクション可能な通知がキューに格納されます。ユーザーは Show Notification コマンドを送信することで、オンデマンドでそれらを取得できます。 {#va-api-features-v2__ul_rrg_2ks_2qb} 詳細については、「[仮想エージェント通知の設定](https://servicenow-prod.fluidtopics.net/bHOaLQ~b39PVzyzKCW2NNw "サポートされているメッセージングチャネルの仮想エージェントチャットボット経由で ServiceNow の通知をユーザーに直接送信します。通知は、レビュー用のシンプルな情報メッセージにすることも、ユーザーが特定のアクションを実行するために選択できるボタン付きのアクション可能なメッセージにすることもできます。")」を参照してください。 仮想エージェント API は、簡易通知用に次の JSON の例を送信します： { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Notification", "data": "{\"sys_id\":null,\"recordDisplayValue\":null,\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":null,\"tableLabel\":null,\"enableLink\":false,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[],\"table_name\":null,\"url\":\"http://192.168.1.9:8080/null.do?sys_id=null\"}" } ], "completed": true, "score": 1 } 仮想エージェント API は、画像カード通知用に次の JSON の例を送信します： { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Notification", "data": "{\"sys_id\":null,\"recordDisplayValue\":null,\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":\"http://xxxxxx.service-now.com/2b2d0d2653a13010ff59ddeeff7b120d.iix\",\"tableLabel\":null,\"enableLink\":false,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[],\"table_name\":null,\"url\":\"http://192.168.1.9:8080/null.do?sys_id=null\"}" } ], "completed": true, "score": 1 } 仮想エージェント API は、レコードカード通知用に次の JSON の例を送信します： { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Notification", "data": "{\"sys_id\":\"552c48888c033300964f4932b03eb092\",\"recordDisplayValue\":\"INC0010112\",\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":null,\"tableLabel\":\"Incident\",\"enableLink\":true,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[{\"fieldLabel\":\"Number\",\"fieldValue\":\"INC0010112\"},{\"fieldLabel\":\"Short description\",\"fieldValue\":\"Assessment : ATF Assessor\"}],\"table_name\":\"incident\",\"url\":\"http://192.168.1.9:8080/incident.do?sys_id=552c48888c033300964f4932b03eb092\"}" } ], "completed": true, "score": 1 } ボット間チャネルの通知はデフォルトで無効になっています。これらを有効にするには、次の操作を実行します。 1. \[すべて\] に移動し、ナビゲーションフィルターに「sys_cs_channel.list」と入力します。 2. ボット間レコードを開きます。プロンプトが表示されたら、レコードの編集を有効にします。 3. \[通知を有効にします\] チェック ボックスをオンにします。 4. \[更新\] をクリックします。 {#va-api-features-v2__ol_mx2_5ps_2qb} アドミニストレーターは、com.glide.cs.per_notification_user_limit プロパティを変更することで、通知ごとの受信者数を制限できます。デフォルト値は 1,000 です。 ## トピック名を使用したトピックの切り替え {#va-api-features-v2__section_h3z_v2l_2qb} トピック ID またはトピックインテント ID を使用してトピックを切り替えるだけでなく、トピックまたはトピックインテント名を使用することもできます。トピック ID またはトピック名のいずれかのみを送信することをお勧めします。現在、いずれかが正しくない場合、またはボットが指定されたトピックに既に存在する場合、仮想エージェントは応答を送信しません。使用法は、使用しているモードによって次のように異なります。 * NLU トピックディスカバリー：トピックインテント名または ID を使用します。 * キーワードトピックディスカバリー：トピック名または ID を使用します。 {#va-api-features-v2__ul_j1k_pgl_2qb} プライマリボットは、トピック名とともに SWITCH アクションを送信して、特定のトピックに直接切り替えることができます。 メッセージペイロードの例： {​   "requestId": "xxxx-xxxx-xxxx-xxxx",   "clientSessionId": "xxx-xxx-xxx-xxx",   "action":"SWITCH",   "topic":{ ​     "name": "Topic Name"​  },​   "userId": "beth"​ } ## 入力インジケーターのサポート {#va-api-features-v2__section_mfv_mrd_gqb} ユーザーおよびライブエージェントの入力インジケーターを有効にすることができます。現在、入力インジケーターは次のように表示されます。 * ユーザーが入力しているときにエージェントに表示される * ボットが応答を準備しているときにユーザーに表示される {#va-api-features-v2__ul_zld_llb_kqb} 入力インジケーターが有効な場合、仮想エージェント API は StartTypingIndicator および EndTypingIndicator アクションを応答ペイロードで送信します。たとえば、次のようになります： {​         "uiType":"ActionMsg",​         "actionType":"StartTypingIndicator"​ } ​ ユーザー入力インジケーターをライブエージェントに送信するには、クライアントが TYPING アクションを送信する必要があります。ユーザーが入力を終えたら、クライアントは VIEWING アクションを送信する必要があります。例： {​     "requestId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxxxxxx",​     "clientSessionId": "xxxxxxxx-xxxx",​     "action": "TYPING/VIEWING",​     "userId": "able.tuter",​     "emailId": "abel.tuter@example.com",​     "timezone":"Asia/Kolkata"​ }​ 入力インジケーターを有効にするには、次の手順に従います。 1. \[すべて\] に移動し、ナビゲーションフィルターに「sys_cs_channel.list」と入力します。 2. \[ボット間 (Bot to Bot)\] レコードを選択します。 3. \[入力インジケーターをサポート\] チェックボックスをオンにします。 4. \[更新\] をクリックします。 {#va-api-features-v2__ol_nrn_tsd_gqb}