Teams 統合に関する考慮事項
Web アプリを Teams と適切に統合することで、Microsoft Teamsのソーシャル機能やコラボレーション機能に適した Web アプリを作成できます。
Teams と統合できるさまざまな種類のアプリは次のとおりです。
- スタンドアロン アプリ: スタンドアロン アプリは、単一ページまたは大規模で複雑なアプリです。 ユーザーは Teams でその一部の側面を使用できます。
- コラボレーション アプリ: Teams 固有のソーシャル機能とコラボレーション機能用に既に構築されたアプリ。
- Microsoft SharePoint: Teams で表示する SharePoint ページ。
統合シナリオに適用される適切なガイドラインをマップして従うことができます。 このドキュメントでは、Teams の機能、ファイルとデータストレージの SharePoint 要件、API 要件、認証、アプリと Teams とのディープ リンクの概要について説明します。
プラットフォーム機能 Teams 理解する
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ、SharePoint
Teams アプリには、必要で想定される共同作業機能が含まれている必要があります。 アプリ統合を使用するには、Teams 開発の用語について理解することが重要です。
| アプリの一般的な機能 | Teams プラットフォーム機能 |
|---|---|
| 埋め込み Web ページ、ホームページ、または Web ビュー |
タブ Microsoft 365 全体で拡張されたタブ |
| ショートカットと拡張機能を共有する |
メッセージの拡張機能 Outlook のメッセージ拡張機能 |
| アクションのショートカットと拡張機能 | メッセージの拡張機能 |
| Chatbots | ボット |
| チャネル通知 |
ボット 受信 Webhook Microsoft 365 グループのコネクタ |
| メッセージ外部サービス |
ボット 送信 Webhook |
| モーダル | ダイアログ (TeamsJS v1.x のタスク モジュールと呼ばれます) |
| コンテンツリッチ カード | アダプティブ カード |
機能のサブセットを決定する
統合シナリオ: スタンドアロン アプリ
既存のアプリケーションのすべての機能を Teams に統合すると、多くの場合、特に大規模なアプリでは、強制的または不自然なユーザー エクスペリエンスにつながります。 最もインパクトのある機能と、より自然に Teams と統合する機能から始めます。 ユーザーがメイン アプリを起動し、その機能の完全なセットにアクセスできるようにします。
アプリと Teams を統合するための前提条件を次に示します。
- ユース ケースを Teams アプリの機能にマッピングする。
- アプリのエントリ ポイントを決定します。 個人的な使用、コラボレーション、またはその両方に対してですか?
SharePoint の要件とオプションについて理解する
統合シナリオ: SharePoint
既存の [SharePoint ページ] を Teams タブとして統合するには、次の点を考慮する必要があります。
- 最新の SharePoint オンライン ページである必要があります。
- 現在、個人用連絡先しかサポートされていません。 ページをチャネル タブとして統合することはできません。
または、SharePoint Framework を使用して Teams タブを作成することもできます。
マルチテナントを目指す
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ、SharePoint
アプリが複数の組織で使用されている場合は、マルチテナント ホスティングを検討してください。 これにより、製品の拡張性が高くなり、配布が簡略化されます。
API を確認する
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ
アプリの API とデータ構造は、Teams と統合するときにアプリをサポートする必要があります。 サポートを拡張するには、ID マッピング、ディープ リンク サポート、Microsoft Graphの組み込みのための Teams に関するコンテキスト情報を使用して API とデータ構造を拡張する必要があります。
Teams タブまたはボットのコンテキストを取得する方法について説明します。
認証オプションについて
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ、SharePoint
Microsoft Entra ID は、Teams の ID プロバイダーです。 アプリで別の ID プロバイダーを使用する場合は、ID マッピング演習を実行するか、Microsoft Entra ID と組み合わせる必要があります。
Teams には、サード パーティ製アプリ用の Microsoft Entra ID を使用したシングル サインオン (SSO) メカニズムがあります。 また、OIDC と呼ばれる OAuth や OpenID Connect などの標準を使用して、他の ID プロバイダーへの認証フローのガイダンスも提供します。
重要
サード パーティ製アプリは Government Community Cloud (GCC) で利用できますが、GCC-High および国防総省 (DOD) では使用できません。 GCC では、サード パーティ製アプリは既定で無効になっています。 GCC のサード パーティ製アプリを有効にするには、「アプリのアクセス許可ポリシーを管理する」と「アプリの管理」を参照してください。
SharePoint ページでは、SSO のみを使用でき、別のアプリに対して SSO を機能させる場合は、その ID が SharePoint アプリであるため、別の Microsoft Entra ID を追加することはできません。
Teams での認証の詳細については、こちらを参照してください。
Teams ボットの設計ガイドライン
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ
アプリを Teams にネイティブにするには、Teams 設計ガイドラインに従ってください。 既存のアプリ コンテンツを [Teams] タブに移行することはできません。アプリの設計の詳細については、「 Fluent Design System」を参照してください。
ディープ リンクを最大化する
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ、SharePoint
Teams 内の情報や機能へのリンクを作成できます。 ディープ リンク を使用して、アプリを Teams にリンクします。アプリの複数の部分を結び付けて、よりネイティブな Teams エクスペリエンスを実現します。
ユーザーにメッセージを送信するときにスマートにする
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ、SharePoint
webhook よりも柔軟性が高いため、マルチスレッド会話には Teams アプリでボットを使用します。
ボットでは、個々のユーザーまたはチャネルに プロアクティブ メッセージ を送信することもできます。 プロアクティブ メッセージは、ボットに送信されるメッセージではなく、外部イベントによってトリガーされるプロンプトなしのメッセージです。 たとえば、ボットがインストールされたときにウェルカム メッセージを送信したり、新しいユーザーがチャネルに参加したりするとします。
プロアクティブ メッセージを送信するには、Teams 固有の識別子が必要です。 情報をキャプチャするには、名簿またはユーザー プロファイル データをフェッチするか、会話イベントをサブスクライブするか、Microsoft Graphを使用します。
過剰なメッセージでユーザーをスパムしないようにします。 Teams 機能でサポートされている場合、ユーザーはアプリの通知設定を構成できます。 通知メッセージの例を次に示します: プロンプトされていないメッセージを送信しないでください。
ファイルとデータ ストレージに SharePoint を使用する
統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ、SharePoint ページ
チームが作成されると、そのチームのファイルとデータストレージをサポートするために、[SharePoint サイト コレクション] もプロビジョニングされます。 アプリがファイルと対話する場合は、この機能を利用する必要があります。 サイト コレクションを使用して、SharePoint リストとMicrosoft Excel に生データを格納します。
関連項目
Platform Docs