service-itsm-teams-debug

従業員サービス向け Microsoft Teams のトラブルシューティング（ITSM）

Microsoft Teams for Employee Service の障害（ログインできない、タブが読み込まれない、機能が表示されない、Agentforce エージェントが応答しない、スウォーミングや SSO が機能しないなど）が報告された場合、このスキルは組織に接続し、該当する問題に応じた合否チェックリストを実行して、各設定の実際の値と、誤っている設定を修正するための正確な設定パスを報告します。「すべての設定を手作業で確認する」代わりに、対象を絞って検証済みの診断を行います。

すべての読み取り処理は headless-360 経由で実行します（クエリには dispatch_readonly を使用し、任意のスウォーミングトークンのクリアに限り dispatch を使用します）。組織のパスワードは不要です。

対象範囲

• 対象: すでに設定を試したものの、失敗している Teams ITSM の診断。報告された症状に適したチェックリストを選び、必要な設定（CORS、External Client App、機能の切り替え、PSL、プロファイルのセッション設定、認証プロバイダー、名前付き認証情報、メッセージングチャネル、Agentforce エージェントなど）を確認します。
• 対象外: 初回の有効化（service-itsm-teams-configure / -itservice-configure / -itdesk-configure を使用）、埋め込みエージェントをゼロから作成する作業（service-itsm-teams-employee-agent-configure を使用）、および Teams 以外の Salesforce のデバッグ。

デフォルトでは読み取り専用です。 すべての確認は dispatch_readonly クエリで実行されるため、チェックリスト全体を実行しても何も変更されません。状態を変更する操作は、最後に任意で行うスウォーミング OAuth トークンのクリアのみで、ユーザーの明示的な確認がある場合に限られます。

---

ステップ 1 — 問題を特定して入力情報を収集する

ユーザーから問題の説明がまだ提供されていない場合は、確認してください。問題を references/configuration-checklists.md の機能マップに照らして、該当するチェックリストを選びます。

問題によっては追加情報が必要です。あらかじめ確認してください。

問題の種類	収集する追加情報
一般的な「ログイン」の問題（アプリ名が不明）	どのアプリか（IT Desk または IT Service）を確認する
IT Desk へのログイン	エンドユーザーの Salesforce ユーザー名（ログインできない本人）
IT Service へのログイン	CCP ユーザーか UEL ユーザーかを確認してから、該当するエンドユーザーの Salesforce ユーザー名
Agentforce が応答しない	Employee Experience サイトの URL
スウォーミング	エンドユーザーのユーザー名。Azure AD の テナント ID（任意。Azure アプリの確認が可能になります）
SSO	Azure AD の テナント ID（任意）。必要に応じて、アプリとエンドユーザーのユーザー名も確認する

そのチェックリストに必要な必須情報が揃うまでは、エージェント固有の確認を実行しないでください（たとえば、ログインの問題でエンドユーザーのユーザー名を確認せずに進めないでください。ユーザーごとの確認は、ユーザー名がない場合 MANUAL_CHECK_REQUIRED になります）。

ステップ 2 — チェックリストを選ぶ

機能マップからチェックリストを選び、references/configuration-checklists.md に記載された順に確認を実行します。

症状	チェックリスト
IT Desk へのログイン	LOGIN_DESK
IT Service へのログイン — UEL ユーザー	LOGIN_SERVICE_UEL
IT Service へのログイン — CCP ユーザー	LOGIN_SERVICE_CCP
一般的なログインの問題（アプリ不明）	LOGIN（その後、アプリを確認する）
機能が表示されない／有効になっていない	MSTEAMS_CORE
タブが読み込まれない（CI Hub、Service Catalog、Employee Enablement、My Assets）	TAB_LOADING
Lightning アプリが埋め込まれない／タブが空白になる	LIGHTNING_OUT
Agentforce エージェントが応答しない	AGENTFORCE
スウォーミング	SWARMING
シングルサインオン	SSO（アプリが特定されている場合は、アプリ固有のログインチェックリストも実行）

SSO の問題でアプリが特定されている場合は、SSO チェックリストと、該当するログインチェックリスト（LOGIN_DESK / LOGIN_SERVICE_CCP / LOGIN_SERVICE_UEL）の両方を実行します。重複する確認は省略してください。

ステップ 3 — チェックを実行する

各チェックのクエリを dispatch_readonly 経由で実行します（クエリと API フィールドはリファレンスに記載されています）。各チェックについて、ステータスと、組織から実際に読み取った設定値を記録します。

ステータス	表示	意味
OK	OK	正しく設定されています
MISCONFIGURED / MISSING / DISABLED / ERROR	FAIL	修正が必要です — リファレンスに記載された正確な Setup パスを含めてください
MANUAL_CHECK_REQUIRED	MANUAL	手動での確認が必要です（または Tenant ID／ユーザー名などの任意の入力値が不足しています）— 決して FAIL と表示しないでください

ステップ 4 — レポート

4 列すべて（#、Check、Status、Configured Value）を含む表を表示し、失敗したチェックの修正方法を記した Action Required の注記も加えます（設定値を省略しないでください）。最後に、次の形式で 1 行の概要を記載します：N passed | N failed | N require manual verification。

• すべて合格： Salesforce バックエンドが正しく設定されていることをユーザーに伝えます。問題が解決しない場合は、Teams アプリを再読み込みするよう案内します（IT Desk／IT Service アプリの ⋯ → Reload app）。
• 失敗あり： 再読み込みに関する注記は追加しないでください。修正方法は各チェックの Action Required に記載します。

レポートの全表示ルール、特別な場合の注記、レポートの出力例、および任意のスワーミング OAuth トークンのクリアについては、 references/report-generation.md を参照してください。

---

注意点（検証済み）

問題	詳細
Teams の ECA の DeveloperName は ServiceCloudTeamsEca です	ログインチェックで参照する External Client App は ServiceCloudTeamsEca です。（組織ごとにパッケージ化されたインスタンスは、ServiceCloudMSTeamsEca などの関連名で表示される場合があります。Teams ログインを担う ECA を照合し、アプリが見つからない場合は「機能をオフにして、もう一度オンにする」として扱います。）
「従業員の OAuth を許可」は、読み取りには Metadata API のみ、変更には Setup UI のみを使用します	SOAP の listMetadata(ProfileSessionSetting) → readMetadata を使い、unified を含む fullName を指定して読み取ります。フィールドは allowOauthForEmployees です（true=有効、false=無効、値なし=未設定）。Profile の describe にはなく、REST／Tooling クエリでも読み取れません。設定するには、Setup → Profiles → (従業員プロファイル) → Session Settings に移動します。UEL ユーザーのみ。
CORS チェックでは IsOauthCorsPolicyEnabled を読み取り、許可するオリジンは CorsWhitelistEntry.UrlPattern から読み取ります	https://cdn.scs.static.lightning.force.com と https://teams.cloud.microsoft の両方が必要です。
機能の切り替え設定は、FulfillerApp permissions Connect API 経由で読み取ります	GET /connect/it-service/permissions/FulfillerApp は、組織／ユーザーの機能フラグを返します。FUNCTIONALITY_NOT_ENABLED エラーは、組織レベルで IServiceItsmTeamsFamily ファミリーがオフになっていることを意味します。
Agentforce のユーザー検証フィールドには SOAP v62 以降が必要です	MessagingChannel.embeddedConfig（authMode、messagingAuthorizations.*）は SOAP v60 では通知なく省略されます。v62 以降を使用してください。
バージョンプレフィックスが必要です	headless-360 の dispatch／dispatch_readonly は API バージョンを解決しません。必ず完全な /services/data/vXX.0/... プレフィックスを渡してください。

関連スキル

スキル	代わりに使用する場面
service-itsm-teams-configure	Teams の基本 Go ページ切り替え、Azure／Entra アプリ、Named Credential、拡張機能の登録を初めて有効にするとき
service-itsm-teams-itservice-configure	IT Service（従業員）有効化チェックリストを完了するとき
service-itsm-teams-itdesk-configure	IT Desk（対応担当者）有効化チェックリストとスワーミングコラボレーションツールを設定するとき
service-itsm-teams-employee-agent-configure	Teams で応答する埋め込み Agentforce エージェントをゼロから作成するとき
service-itsm-channels-coordinate	Teams、Slack、Swarming、Notifications、Portal を横断するトップレベルメニュー