仮想エージェントの URL パラメーター

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:4分
  • 仮想エージェントには、アドミニストレーターがインスタンス URL に追加して、ページコンテンツのレンダリング方法を制御できるさまざまなシステムパラメーターが用意されています。

    仮想エージェントの URL 構造

    インスタンスに対して表示されるページを制御するには、URL パラメーターをインスタンス URL (https://<instancename>.service-now.com) に追加します。

    仮想エージェント Web クライアントのシステムパラメーター

    仮想エージェント Web クライアントは、ポータルでの使用またはサードパーティのページへの埋め込みでサポートされています。次のシステムパラメーターは、仮想エージェント Web クライアントに表示される会話コンテンツを制御します。
    パラメーター 説明
    sysparm_branding_key

    チャットの自社用カスタム設定構成を Web チャットクライアントに適用します。

    値:構成の自社用カスタム設定キー

    • 宛先ページに自社用カスタム設定構成を適用します:https://<instancename.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=acme
    • 埋め込み Web クライアントに自社用カスタム設定構成を適用します:https://<instancename.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=acme
    sysparm_default_topic トピック sys_ID を使用して起動時にデフォルトのトピックを設定します。 https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=1f5ac6dfc34020105a61d7de76400001
    sysparm_domain_id チャットをドメインの指定された Sys ID に制限します。 https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=c90d4b084a362312013398f051272c0d
    sysparm_live_agent_only 可能であれば、ユーザーをライブエージェントに直接誘導します。 https://<instancename.service-now.com/$sn-va-web-client-app._embed.do?sysparm_live_agent_only=true
    sysparm_load_active_only 現在のアクティブな会話をロードします。
    値:
    • true:アクティブな会話のみをロードします。
    • false:アクティブな会話をロードしません。
    注:
    sysparm_skip_load_history および sysparm_load_active_only パラメーターが両方とも true に設定されている場合、既存の sysparm_skip_load_history パラメーターが優先されます。
    https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_load_active_only=true
    sysparm_nowassist 仮想エージェントクライアントに Now Assist をロードします。 https://<instancename>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_nowassist=true
    sysparm_search_text 会話の検索テキストを設定します。 https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_search_text=request&laptop
    sysparm_skip_load_history 前のメッセージ履歴をスキップし、新しい会話を開始します。
    値:
    • true:メッセージ履歴をロードしません。
    • false:メッセージ履歴をロードします。
    注:
    sysparm_skip_load_history パラメーターが false に設定され、sysparm_load_active_only が true に設定されている場合、sysparm_load_active_only は現在のアクティブな会話をロードします。
    https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_skip_load_history=true
    sysparm_ preview_mode 会話をテストモードで表示します。 //https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_preview_mode=true
    sysparm_requester_session_language 会話セッションの要求者の言語を指定します。 https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_requester_session_language=<two-letter language code>