Teams Toolkitで作成したTeamsボットは、zipをサイドロードして自分のTeamsで動くのに、組織のアプリカタログへ公開する段階で「管理者への公開依頼が届かない」ことがあります。原因はアプリ不具合ではなく、配布フローの違い・管理者側の通知設定・テナントのアプリポリシーにあるケースが大半です。
症状：サイドロードは成功するのに、組織公開だけ進まない
よくある状況は次のとおりです。
- Visual Studio の Teams Toolkit（現在は「Microsoft 365 Agents Toolkit」と呼ばれることもあります）でボットアプリを作成
- 生成されたアプリパッケージ（zip）をTeamsクライアントにアップロードして動作確認できた
- しかし「組織に公開」「管理者に依頼」といった操作をしても、管理者側が何も受け取れない／気付けない
このとき重要なのは、「サイドロードで動く＝組織カタログに載せる準備が完了」ではないという点です。Teamsの配布方法はスコープごとに審査・承認経路が異なり、特に「組織向け」は管理者の作業が必ず発生します。
まず理解する：サイドロードと「組織のアプリカタログ公開」は別ルート
混乱しやすいので、先に違いを整理します。
| 配布方法 | 目的 | 主な操作場所 | 管理者の関与 | よくある落とし穴 |
|---|---|---|---|---|
| カスタムアプリのアップロード（サイドロード） | 個人／少人数でのテスト・検証 | Teamsクライアント | 不要（ただし許可設定は管理者が制御） | 「動いた＝公開できる」と誤認しやすい |
| 組織への公開（提出→管理者が公開） | 組織のアプリストア（Built for your org）に掲載 | Teams Toolkit / 開発者ポータル → Teams管理センター | 必要（管理者が“公開”操作） | 通知が既定でOFFで、管理者が気付けない |
| 管理者がzipを直接アップロードして公開 | 最短で確実に組織配布 | Teams管理センター | 必要（アップロード・許可・公開） | 公開反映に時間がかかることがある |
Teams Toolkit（Agents Toolkit）側の「Publish to your organization（組織へ公開）」は、アプリをいきなり組織ストアへ載せる操作ではなく、管理者が確認・公開するための“提出（submit）”です。提出後、管理者がTeams管理センターで“公開（Publish）”しない限り、利用者側の「組織のアプリ」には出てきません。
結論：最短で確実なのは「管理者にzipを渡して管理センターで公開してもらう」
「公開依頼が届かない」問題を素早く解消する実務的な解は、管理者がTeams管理センターからアプリzipを手動アップロードし、公開することです。管理者がアップロードしたカスタムアプリは、承認フローに依存せず組織カタログで利用可能にできます。
管理者に依頼する手順（管理センターでの手動アップロード）
- Teams管理センターで「Teams アプリ」→「アプリの管理（Manage apps）」へ移動
- 画面の表示に応じて「新しいアプリのアップロード」または「アクション（Actions）→新しいアプリをアップロード」を選択
- 開発者から受け取ったアプリパッケージ（zip）をアップロード
- アプリの状態（許可/ブロック）や公開状況を確認し、必要に応じて公開
ポイント：アップロード直後に利用者側のストアへ即時反映されるとは限らず、組織で利用可能になるまで数時間かかる場合があります。公開したのに「見えない」「検索に出ない」ときは、まず反映時間を考慮しつつ、次章のポリシーと権限を確認します。
管理者が「依頼を受け取れない」主因は“通知されない”こと
実はここが盲点になりやすいのですが、提出（App submission）があっても、管理者へ通知が自動で飛ばない設定になっているテナントが多いです。通知を有効化していないと、管理者は「Teams管理センターのアプリ管理画面で気付く」しかありません。
管理者への通知を確実にする（App submissions ルールを有効化）
管理者が「通知とアラート（Notifications & alerts）」のルールで、App submissions をアクティブにすると、アプリ提出や更新提出を受け取れるようになります（既定はオフ）。通知は、Teams内の「Admin Alerts and Notifications」チームの専用チャネルに出す、または任意のチーム/チャネルへ配信する、といった構成ができます。
提出済みなのに“何も来ていない”と感じるときの確認ポイント
「管理者に届いていない」と言われた場合でも、実際には管理センター側に“提出済み（Submitted）”として存在していることがあります。通知が無効だと、管理者は気付きにくいだけです。
管理者が確認すべき場所（Pending approval / Publishing status）
- Teams管理センターの「アプリの管理（Manage apps）」上部にPending approvalが出ていないか
- 一覧のPublishing status が「Submitted」になっているアプリがないか（並べ替えで見つけやすい）
- 対象アプリの詳細画面で、公開（Publish）操作を実行しているか
提出直後は、アプリの状態が「Blocked」として表示されることがありますが、管理者が公開すると「Published / Allowed」へ変わります。
原因別：よくある詰まりどころと対処法
ここからは「管理者への公開依頼が届かない」ときに、現場で多い原因を“症状ベース”で整理します。
| ありがちな原因 | 開発者側の見え方 | 管理者側の見え方 | 対処の要点 |
|---|---|---|---|
| 通知（App submissions）が無効 | 依頼は出したつもりだが反応なし | メールもTeams通知も来ない | 通知とアラートの「App submissions」をActiveにし、配信先を設定 |
| 提出はされているが“公開”していない | いつまでも組織ストアに出ない | Manage appsにSubmittedが残っている | アプリ詳細のPublishing statusからPublishを実行 |
| 組織のポリシーでカスタムアプリ利用が制限 | 自分はサイドロードできるが他ユーザーが見えない | 許可/ブロックやポリシーで対象ユーザーが限定 | 組織全体の設定・アクセス許可ポリシー・セットアップポリシーを整合させる |
| 「ユーザー要求」機能と混同している | “リクエスト”を押したのに届かない | 想定の場所にリクエストが出ない | ユーザー要求は“ブロックされたストアアプリ向け”で、カスタムアプリには別フロー |
| マニフェストやパッケージ不備 | ローカルは動くが提出/公開で詰まる | 審査で止まる／公開しても動かない | マニフェスト検証、必須項目、HTTPS到達性、権限記述を見直す |
混同注意：「管理者への依頼」には2種類ある
Teamsには“管理者に依頼する”に見える動線が複数あり、ここを取り違えると「押したのに届かない」状態になります。
| 依頼の種類 | 対象 | 管理者が見る場所 | 注意点 |
|---|---|---|---|
| ユーザー要求（User requests） | ストアでブロックされているアプリの“許可依頼” | Teams管理センターのアプリ管理やダッシュボード等 | カスタムアプリは対象外。さらに、管理者が対応しても要求者に自動通知されない |
| カスタムアプリの提出（App submissions） | 組織内で配布したいカスタムアプリの“公開申請” | Teams管理センターのManage apps（Pending approval / Publishing status） | 通知は既定でオフ。管理者がPublishするまで組織ストアに出ない |
「ユーザー要求」は、Microsoftのドキュメント上でもカスタムアプリではサポートされないと明記されています。カスタムアプリを組織配布したい場合は、提出（App submissions）または管理者による直接アップロードの運用を前提に設計するのが安全です。
管理者側：組織公開を成立させる設定チェック（Teams 管理センター）
「管理者が依頼を受け取れない」問題は、結局のところ管理者が確認すべき画面に依頼が来ているか／公開できる状態かのチェックに集約されます。以下は現場で使いやすい確認順です。
確認順序（迷ったらこの順）
- Manage appsで対象アプリが「Submitted」になっていないか確認
- 「Submitted」なら、アプリ詳細でPublishを実行
- 公開したのに利用者が見えないなら、アクセス許可ポリシー（App permission policy）でブロックしていないか確認
- 必要なら、セットアップポリシー（App setup policy）でピン留め／インストールを配布
- 次回以降のために、Notifications & alertsでApp submissions通知を有効化
設定項目ごとのチェック表
| カテゴリ | 何を制御するか | 詰まりやすいポイント | 確認・対処の方向性 |
|---|---|---|---|
| 組織全体のアプリ設定（Custom apps） | 組織全体でカスタムアプリを操作できるか | 組織全体がオフだと利用者が使えない | 「ユーザーがプレビューでカスタムアプリを操作できるようにする」等の設定を確認 |
| アプリセットアップポリシー | 誰がカスタムアプリをアップロードできるか／ピン留め | 開発者だけONにして他ユーザーはOFFになりがち | 開発者・テストユーザーに適切なポリシーを割り当て |
| アプリのアクセス許可ポリシー | 誰がそのアプリを利用できるか | 公開後も特定ユーザーにだけ見えない原因になりやすい | Custom apps を許可する／対象アプリを許可リストに追加 |
| 通知とアラート（App submissions） | 提出時の通知 | 既定でオフのため「届かない」に直結 | ルールをActiveにして通知先チャネルを設定 |
なお、管理者がカスタムアプリをアップロードできるのは、グローバル管理者やTeams管理者などの管理者ロールが前提です。権限が足りない管理者アカウントで操作していると、画面上は見えていても処理できない（または操作が限定される）ことがあるため、ロールも併せて確認します。
開発者側：Teams Toolkit（Agents Toolkit）で“提出できているか”を見分ける
Teams Toolkit（Agents Toolkit）には「個人/チームで試す（サイドロード）」と「組織へ公開（提出）」があり、目的に合った操作を選ぶ必要があります。組織公開は提出がゴールではなく、管理者が公開して初めて組織ストアに出ます。
また、提出/公開に限らず、Teamsのアプリ配布は“正しいアプリパッケージ（zip）”が前提です。パッケージにはマニフェストやアイコンが含まれ、Teams自体がアプリのロジックをホストするわけではありません。テストはローカル、運用はHTTPSで到達できる場所（例：Azure）という切り分けが必要になります。
アプリパッケージ（zip）とマニフェストのチェックリスト
| チェック項目 | なぜ重要か | 確認のコツ | つまずくと起きること |
|---|---|---|---|
| マニフェストが最新スキーマで検証できる | 提出や公開で厳密にチェックされる | 開発者ポータル等の検証を通す | 提出時に失敗／審査で停止 |
| ボット設定（Bot ID、スコープ、コマンド等）が整合 | 組織配布後に動かない典型原因 | Botの登録IDとmanifestのIDが一致しているか | インストールできても応答しない |
| validDomains / 参照ドメインが妥当 | 外部アクセス先が許可されていないと動作不安定 | タブやSSOなどが参照するドメインを洗い出す | 画面が表示されない／認証が失敗 |
| SSO等が必要なら webApplicationInfo を正しく設定 | Azure AD連携に必須になるケースがある | AADアプリID・リソースURIの整合 | 組織環境でのみサインイン失敗 |
| 本番でHTTPS到達できるエンドポイント | TeamsはHTTPS経由で外部ホストへアクセス | localhostや社内限定URLのままになっていないか | 公開できても実運用で動かない |
「依頼が届かない」問題を潰すための実務フロー（おすすめ）
組織配布は技術だけでなく運用が絡むため、最初から“管理者が公開する前提”のフローにしておくとトラブルが減ります。
| フェーズ | 開発者がやること | 管理者がやること | ポイント |
|---|---|---|---|
| 開発・動作確認 | サイドロードで動作確認、マニフェスト検証 | （必要なら）開発者のカスタムアプリアップロードを許可 | 小さく試してから組織配布へ |
| 提出または共有 | 提出（Publish to org）またはzipを管理者へ共有 | 提出をManage appsで確認 | 通知がない前提で管理センター確認を運用に組み込む |
| 公開 | 公開後の動作確認に協力 | アプリをPublishし、必要なら許可/ブロックを調整 | 公開＝ユーザーが見える状態にする操作 |
| 展開・定着 | 利用ガイド、FAQ、更新計画 | アクセス許可ポリシーで段階展開、セットアップポリシーでピン留め | 「まず一部に配布→全社へ」が現実的 |
特に、公開後に「一部の人だけ見えない」場合は、アプリ自体の不具合よりもアクセス許可ポリシー（誰が使えるか）の設定が原因になりやすいです。Teamsでは、組織全体の設定・個別アプリの許可/ブロック・アクセス許可ポリシーが連携して最終的な可視性を決めます。
よくある質問
管理者が「承認した」と言うのに、利用者のTeamsにアプリが出ません
「提出（Submitted）」の状態では、まだ組織ストアに出ません。管理者がTeams管理センターでPublishまで行っているか、Manage appsのPublishing statusで確認してください。公開後は「Published / Allowed」へ変わります。
公開したのに、ユーザーの「組織向けアプリ」に反映されるまで時間がかかります
カスタムアプリのアップロードや公開が反映されるまで、環境によっては時間差が出ることがあります。管理者側で公開処理が完了していることを確認したうえで、数時間程度の反映待ちも視野に入れてください。
「管理者への依頼」ボタンを押したのに、管理者が見つけられません
その“依頼”が「ユーザー要求（ブロックされたストアアプリを許可してもらう機能）」の動線になっていないか確認してください。ユーザー要求はカスタムアプリではサポートされないため、カスタムアプリ配布には「提出（App submissions）」または「管理者の直接アップロード」を使う必要があります。
管理者が依頼に対応したのに、依頼者へ通知が来ません
少なくとも「ユーザー要求」については、管理者が対応してもTeamsが要求者へ自動通知しないことがあります。社内運用として、管理者から依頼者へ結果を連絡するルールを決めておくとトラブルを減らせます。
まとめ
Teams Toolkitで作成したTeamsボットがサイドロードで動作しているなら、アプリの基本部分は概ね正常です。組織のアプリカタログに載らない／管理者に公開依頼が届かない場合は、次の順で切り分けると解決が早くなります。
- 依頼（提出）自体はManage appsに「Submitted」として存在していないか
- 管理者がPublishまで実行しているか
- 通知がオフで管理者が気付けていないだけではないか（App submissionsルール）
- 公開後に見えない場合は、アクセス許可ポリシー／組織全体設定の整合性
- 急ぐなら、zipを渡して管理者に手動アップロードしてもらう
開発者が「提出を試す」→管理者が「公開する」までを一連の運用として組み立てれば、次回以降は“届かない問題”が再発しにくくなります。
コメント