Microsoft Teams との対話型統合のインストールチェックリストSummaryこのドキュメントでは、「Now 仮想エージェント - Microsoft Teams」の本番ボットをインスタンスにインストールする際に従うべきチェックリストについて説明します。これは、エンドユーザーがインストールの問題を確認またはデバッグするのに役立ちます。ユーザーは、テーブルを使用してさまざまなパラメーターのデフォルト値を確認できます。これにより、ユーザーは既存の値が特定のインスタンスで正しいかどうかを検証できます。 以下は、MS Team 本番ボットのインストール時に従う手順であり、Quebec 以降のバージョンに適用されます。 これらの手順は、Teams アプリケーション「Now 仮想エージェント」にのみ適用され、「ServiceNow for Teams」アプリケーションには適用されません。 前提条件: インストールを開始する前に、ServiceNow admin ロールがあることを確認してください。(VA アドミンまたはアドミン)。 次のプラグイン [およびストアアプリケーションプラグイン] をインストールする必要があります プラグイン名 プラグイン ID バージョン Glide 仮想エージェント [Pro ライセンス] / Glide 仮想エージェント Lite [標準ライセンス] com.glide.cs.chatbot または com.glide.cs.chatbot.lite Microsoft Teams との対話型統合 (ストアプラグイン) sn_va_teams1.0.4 +Microsoft Teams Graph スポーク (ストアプラグイン)sn_msteams_ahv2 3.4.0 + MS Teams - アプリコアcom.snc.msteams.app.core ※ストアプラグインについては、ストアで最新バージョンを確認し、ストアから最新バージョンをインストールしてください。 ストアアプリプラグインのインストール中に、以下のようなエラーが発生した場合は、TSEに連絡し、iHUBスポークプラグインをインストールしてください(KB0993169参照)。 Instructionsインストール手順: ユーザーが Paris などの以前のバージョンでボットを既にインストールしていて、Quebec などの新しいバージョンにアップグレードしている場合は、インストール手順をスキップできます。 1.プラグインのインストール後、[メッセージングアプリの統合] に移動すると、[Microsoft Teams] インストールボタンが有効になっていることがわかります。(プラグインがインストールされていない場合、ボタンはグレー表示されます。[インストール] をクリックします。[下図のように] 2.ServiceNow によってサードパーティのサイトに移動します。これにより、Microsoft ログインページが表示されます。Microsoft 認証情報でログインします。次に、次のページで [同意する] をクリックします (下図を参照)。 3。インストール中にエラーが発生した場合は、以下のようにURLとエラーコードを含む完全なスクリーンショットを撮ると、根本原因を見つけるのに役立ちます。コラボレーションプロキシログのエラーも確認します。コラボレーションプロキシは、ServiceNow データセンターで実行されるネットワークサービスであり、インスタンスとサードパーティのチャット/コラボレーションサービス間の通信を容易にし、双方向 HTTP プロキシとして機能します。顧客はプロキシとログにアクセスできません。このような場合は、ServiceNow サポートにお問い合わせください。 4.インストールが成功したら、[メッセージングアプリの統合] ページに戻り、MS Teams テナント名が含まれていることを確認することもできます。[下図のように] #タスクはいいいえ1ユーザーは必要なロールを持っています:VA アドミンまたはアドミン 2必要なプラグインがインストールされています 3MS チームボットが正常にインストールされました 認証チェックリスト: 1.必要な認証レコードが作成/更新されたことを確認します。 # テーブル名 列名 検証する値 1 provider_auth 名前 「ServiceNow 仮想エージェント Teams アプリ – XXX」でレコードが作成されました (XXX はテナント ID) グループ名 これはテナント ID である必要があります プロバイダー Microsoft Teams 2 oauth_oidc_entity 名前 「ServiceNow 仮想エージェント Teams アプリ」でレコードが作成されました クライアント ID クライアント ID は「49471a10-fdbc-4ffb-b0b8-944f3df985d9」です 3 message_auth 名前 「ServiceNow 仮想エージェント Teams アプリ – XXX」でレコードが作成されました (XXX はテナント ID) プロバイダー Microsoft Teams グループ名 これはテナント ID である必要があります 着信メッセージの検証 ServiceNow 仮想エージェント Teams アプリ受信トークン:アプリ 送信メッセージの検証 ServiceNow 仮想エージェント Teams アプリ送信トークン - ServiceNow 4 token_verification 名前 ServiceNow 仮想エージェント Teams アプリ送信トークン - ServiceNow トークン teams_va_xxxx 2.Teams のスクリプト化された拡張ポイントが「sys_extension_point」テーブルに存在することを確認してください。 3。次のレコードが API 名で作成されたことを確認します MSTeamsInboundRequestHandlerVATeamsExtensionPointVATeamsInstallationExtension 注:これは、Paris バージョンから Quebec + へのアップグレードインスタンスで重要です ·インスタンスで、[Connection & Credential Aliases] に移動し、作成された認証情報レコードを確認します。 Microsoft Teams スポークMSTeamsGraph-BotCredentials仮想エージェント MS Teams 認証情報 ストアアプリインストールのチェックリスト: Microsoft Team に必要なフローアクションが利用可能であることを確認する [フローデザイナー] - [>アクション] に移動し、[名前] が「仮想エージェント - MS Teams アダプタ」で始まるアクションを確認します 例： 仮想エージェント：MS Teams アダプターのデフォルトのテキスト着信トランスフォーマー仮想エージェント：MS Teams アダプターのデフォルトのテキスト送信トランスフォーマー ·フローアクションまたはサブフローのいずれかが欠落した場合は、プラグインのインストールログまたはアップグレードログでスキップまたはエラーがないか確認します。 基本操作チェックリスト: 基本コマンド "Hi" が機能することを確認する[ServiceNow へのリンク]を含む応答を取得し、ゲストとして続行ServiceNow へのリンクトピックが検出されましたトピックはエラーなしで実行されました。 注意: 自動リンクを有効にすると、ユーザーには [ServiceNow にリンク] のオプションが表示されません。詳細については、 KB0964438 を参照してください。 システムログにエラーがないか確認し、エラーがある場合は詳細を収集します。トランザクションレコードが作成されたかどうかを確認/api/now/v1/proxy/cs/adapter/va/teams で URL を検索します トランザクションレコードが作成された場合 会話が「sys_cs_conversation」テーブルに作成されているかどうかを確認し、以下を確認します デバイスタイプ = Teams会話状態 = オープン。--- 会話が進行中であることを意味します会話状態 = 会話が正常に完了した---完了。会話状態 = 障害 トランザクションレコードが作成されていない場合 要求が届いていないか、要求がインスタンスに到達する前に何らかの問題があります。プロキシ認証に問題がある可能性があります。コラボレーションプロキシログで詳細を確認してください。 Splunkクエリの例:source=/var/log/nginx/error.log sourcetype="nginx:plus:error" tenant="95d1d810-50cf-4169-8565-6bfba279a0cd" |逆 注意: 顧客はコラボレーションプロキシサーバーにアクセスできません。サポートが必要な場合は ServiceNow サポートにお問い合わせください。 会話ステータス = 障害の場合 システムログにエラーがないか確認する対応する会話レコードを「sys_cs_conversation」で開く個々のタスクまたは会話メッセージのステータスを確認し、エラーを特定します 送信認証、メッセージの順序などに問題がある可能性があります。送信 http ログにエラーがないか確認してください。 [システムログ - >送信 HTTP 要求] に移動し、URL ホスト名 = teamsproxy.service-now.com を検索します 注: 上記の手順で問題が発生した場合は、 1.システムログにエラーがないか確認します。エラーの詳細を取得します。 2.[sys_cs_conversation] テーブルに作成された会話レコード。 3。送信 HTTP ログのエラー 4.プラグインのインストール中に発生したエラー。 5.アップグレード中にスキップされたものすべて:カスタマイズがある場合、アップグレード中にスキップされます。 参照:CSTASK201190 6.会話の合間にボットが応答しない場合は、「再起動」コマンドを試してください。 7.インスタンスがクローンされた場合、認証レコードはクローンされない可能性があります。 参照: CSTASK204075 /DEF0221119 8.ボット名を変更することはお勧めしません。問題を引き起こす可能性があります と MS Team ボットが期待どおりに機能しない場合があります。 参照:CSTASK202029 Related Linksインストールを検証する自動化: 概要： ユーザーは、[スクリプト - バックグラウンド] で提供されたスクリプトを実行することで、MS チームボットのインストールを検証できます。このスクリプトは、MS Teamsのインストールを自動的に検証し、最近のsys_plugin_log、syslog、sylog_transaction、およびsys_cs_conversationレコードの検証結果を提供します。 スクリプトは zip ファイルとしてこの KB に添付されています。使用する前に解凍してください。 名前: ms_teams_script.js.zip 実行方法: グローバルスコープでバックグラウンドスクリプトとして実行されます。スクリプトはこちらから入手できます。 [システム定義] - [>スクリプト] - [バックグラウンド] にスクリプトを貼り付け、[スクリプトを実行] をクリックします。 入力： 入力は必要ありません。スクリプトはユーザーからの入力を想定していません。 出力： 1.一連のテストとその結果。 2.sys_plugin_log、syslog、sylog_transaction、および sys_cs_conversation レコードからの最近の関連ログ。 サンプル出力は次のとおりです。 詳細については、 KB0995114を参照してください。