ServiceNow メッセージアプリ統合を使用した Microsoft Teams での仮想エージェントアクセスの構成Summary<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Messaging Apps Integration モジュールを使用して、Microsoft Teams で Virtual Agent を利用できるように構成します。 この記事では、Microsoft 側の前提条件、ServiceNow インスタンスの構成手順、および Microsoft Teams に Virtual Agent アプリを追加する方法について説明します。 Release<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } サポートされるすべてのリリース Instructions<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } 前提条件 Microsoft 側の要件 統合を構成する前に、Microsoft 側で以下の要件を満たしていることを確認してください。 管理者向け開発者アクセス権を持つ Microsoft 365 アカウント（個人用または法人用）Microsoft 365 E5 Developer サブスクリプションMicrosoft Teams 環境に追加された 少なくとも 1 人のテストユーザーユーザー名と完全なドメイン名（例: User1@Domain.onmicrosoft.com）を控えておいてください。この情報は、ServiceNow インスタンス上に対応するユーザーを作成する際に必要です。 これらの Microsoft 側の前提条件の設定方法については、以下の Microsoft ドキュメントを参照してください。 Microsoft 365 テナントを準備するMicrosoft 365 Developer Program開発者サブスクリプションを設定する 注: 新しい Microsoft アカウントを作成した場合、登録が完了するまで数時間待つ必要がある場合があります。また、テストユーザーの作成には最大で約 1 時間かかることがあります。作成後は、E5 開発者アカウントの資格情報を使用して 365 管理センターからアクセスできます。 ServiceNow 側の必要ロール Virtual Agent の Microsoft Teams 統合をインストールするには、以下のロールが必要です。 ServiceNow: virtual_agent_admin および external_app_install_admin（または admin）Microsoft Teams: Global Admin 注: この統合は Microsoft Office 365 アカウントを持つユーザーのみ をサポートしています。Microsoft Teams のフリーミアムアカウントはサポートされていません。 ServiceNow インスタンスの構成 Microsoft Teams と連携する ServiceNow インスタンス に移動します。インスタンス上で新しいユーザーレコードを作成します。 User ID に Microsoft ユーザー名（ドメイン部分を除く）を設定します。Email にドメインを含む完全なユーザー名を設定します（例: User1@Domain.onmicrosoft.com）。 このユーザーに admin ロール を割り当てます。新しく作成したユーザーとしてログインし、Messaging Apps Integration に移動します。Microsoft Teams の横にある [Install] を選択します。Microsoft アカウントへのサインインを求められます。前の手順で作成したユーザー（現在代理操作しているユーザー）の Microsoft アカウントでサインインしてください。ユーザー名が表示されない場合は、[Use another account] を選択します。サインイン後、接続を承認するために [Accept] を選択します。 注:この Microsoft アカウントが、Microsoft Teams メッセージング統合用として既に別の ServiceNow インスタンスに関連付けられている場合は、既存の接続を上書きするかどうか確認するメッセージが表示されます。[Override] を選択し、その後再度アカウントの選択を求められた場合は、同じアカウントを選択してください。正常に完了すると、統合がインストールされたことを示す確認メッセージが表示されます。 Microsoft Teams に Virtual Agent を追加 https://www.office.com へ移動し、手順 4 で代理操作したユーザーとしてサインインします。Microsoft Teams を選択します。[Apps] を選択し、Virtual Agent を検索して [Add] を選択します。 構成したインスタンスの Microsoft Teams で Virtual Agent を利用できるようになりました。 Microsoft Teams での Virtual Agent コマンド Microsoft Teams で Virtual Agent を利用する際は、次のコマンドを使用できます。 新しい会話を開始する hi と入力します。 ボットは、[End conversation]、[Chat with agent]、[Cancel] などのオプションを表示します。 [End conversation] を選択すると、現在の会話を終了します。新しい会話を開始するには、再度 hi と入力します。[Cancel] を選択すると、前の質問に戻ります。[Chat with agent] を選択すると、ライブエージェントに接続します（ライブエージェントが構成されている場合のみ利用可能です）。 hi が機能せず先に進めない場合は、restart と入力します。 hi と restart の両方が機能しない場合、ユーザーがライブエージェントとのチャット中である可能性があります。その場合は bye と入力します。 注: hi および restart コマンドは Virtual Agent チャットでのみ機能します。ライブエージェントチャットでは機能しません。 ライブエージェントに接続する 次のいずれかの方法で接続できます。 Live Agent Support トピックを実行する。agent と入力し、表示された [Chat with agent] を選択する。 ライブエージェントチャットを終了する bye と入力します。 ボットは [End Chat] と [Cancel] のオプションを表示します。 [End Chat] を選択すると、ライブエージェントセッションが終了します。 注: ライブエージェントセッション中は、bye 以外のコマンドは認識されません。 トラブルシューティング 通知が機能しない Global アプリケーションスコープで Messaging Apps Integration ページに移動し、Enable notifications フラグが有効になっていることを確認します。 すべてのユーザーでボットが応答しない Paris およびそれ以前のリリースの場合 sys_cs_adapter_configuration_page_teams テーブルに、該当する Tenant ID の構成レコードが存在することを確認します。レコードが存在しない場合は、Messaging Apps Integration ページから再インストールし、Microsoft Teams から再試行します。sys_cs_vendor_client_adapter_configuration テーブルに、該当する Tenant ID のレコードが存在することを確認します。レコードが存在しない場合は、sys_cs_adapter_configuration_page_teams テーブルで構成名を変更します（例: 末尾にピリオド「.」を追加します）。この変更によってビジネスルールが実行され、sys_cs_vendor_client_adapter_configuration にレコードが作成されます。レコードが作成されたことを確認した後、構成名からピリオドを削除します。Microsoft Teams から再試行します。 特定のユーザーでボットが応答しない sys_cs_client_adapter テーブルに移動します。次の条件でフィルタリングします。Client type = Microsoft TeamsGroup ID = Tenant ID（sys_cs_adapter_configuration_page_teams レコードで確認）Consumer = 影響を受けているユーザー作成日または更新日で並べ替えます。最初のレコードを開き、adapter state 内の conversationId を確認します。その ID をコピーし、sys_cs_conversation テーブルで sys_id を使用して検索します。会話レコードが faulted 状態である場合、またはレコードが存在しない場合は、sys_cs_client_adapter レコードを削除してから Microsoft Teams で再試行します。 OIDC 認証構成の問題 以下のエラーが表示される場合があります。 Get for non-existent record: oidc_provider_configuration: initializing... WARNING *** WARNING *** No record found in oidc_provider_configuration for sysId= 対応方法: アプリケーションレジストリ (oauth_entity.list) に移動します。ServiceNow Virtual Agent Teams App を選択します。OAuth OIDC Provider Configuration にエントリが存在することを確認します。エントリが存在しない場合は、Microsoft Teams を選択して保存します。Microsoft Teams から再試行します。 Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Integrating Virtual Agent with messaging appsImprove Your Conversations with Microsoft Teams — Virtual Agent AcademyPrepare your Microsoft 365 tenantMicrosoft 365 Developer ProgramSet up a developer subscriptionManage and monitor Teams