次の方法で共有

Teams 統合に関する考慮事項

  • [アーティクル]

Web アプリを Teams と適切に統合することで、Microsoft Teamsのソーシャル機能やコラボレーション機能に適した Web アプリを作成できます。

Teams と統合できるさまざまな種類のアプリは次のとおりです。

  • スタンドアロン アプリ: スタンドアロン アプリは、単一ページまたは大規模で複雑なアプリです。 ユーザーは Teams でその一部の側面を使用できます。
  • コラボレーション アプリ: Teams 固有のソーシャル機能とコラボレーション機能用に既に構築されたアプリ。
  • Microsoft SharePoint: Teams で表示する SharePoint ページ。

統合シナリオに適用される適切なガイドラインをマップして従うことができます。 このドキュメントでは、Teams の機能、ファイルとデータストレージの SharePoint 要件、API 要件、認証、アプリと Teams とのディープ リンクの概要について説明します。

プラットフォーム機能 Teams 理解する

重要

Microsoft 365 コネクタ (以前は Office 365 コネクタ) は非推奨に近づいています。新しい Microsoft 365 コネクタの作成は間もなくブロックされます。 スケジュールの詳細と、ワークフロー アプリがより柔軟で安全なエクスペリエンスを提供する方法については、 Microsoft Teams内の Microsoft 365 コネクタの廃止に関するページを参照してください。

Teams で Webhook を作成するにはどうすればよいですか?

  • Webhook 要求の受信時にチャットまたはチャネルに自動的に投稿するには、定義済みのワークフロー テンプレートを使用するか、[ Teams Webhook 要求が受信されたとき ] トリガーを使用してワークフローを最初から作成します。 詳細については、「 webhook 要求がMicrosoft Teamsで受信されたときにワークフローを投稿する」を参照してください。

  • Teams Webhook 要求が受信されたときのトリガーの詳細については、「Microsoft Teams - Webhook」を参照してください。

Office 365 コネクタを既に構築している場合:

  • Power Automate コネクタを作成する: Power Automate は、Teams で広く使用されているワークフロー アプリを強化します。 これは、Teams との間でプログラムによってデータを送信するためのスケーラブルで安全なアプローチです。 この方法を採用する場合は、製品から Teams チャネルにアラートを投稿するためのワークフロー テンプレートを作成できます。 この方法により、新しい方法のユーザーの導入が簡略化されます。 詳細については、 エンタープライズ開発者、ISV、パートナー向けの Power Automate に関するページを参照してください。

  • Teams アプリを更新する: 現在の Teams アプリを強化できます。 たとえば、ユーザーがシステム内のトリガー イベントに基づいてプロアクティブ メッセージを設定できるようにします。 詳細については、ボットが プロアクティブ メッセージを通じてチャネルに投稿する方法に関するページを参照してください。

既知の問題

  • ワークフロー アプリは、プライベート チャネルでフロー ボットとして投稿できません。 ただし、ユーザーに代わって投稿することはできます。
  • ワークフローでは、アダプティブ カードのみがサポートされます。 コネクタで使用される古いメッセージカード形式Office 365サポートされていません。 ワークフローでは、メッセージ カード形式の使用はサポートされていません。 詳細については、コネクタ メッセージカード形式をアダプティブ カードに変換する方法に関するページを参照してください。
  • ワークフローには、DataDog や Jenkins などのサードパーティ製コネクタは用意されていません。
  • ワークフローは、既定の環境でのみ作成できます。

限界事項

ワークフローは、特定のユーザー (ワークフローの所有者と呼ばれます) にのみリンクされ、Teams チームまたはチャネルにはリンクされません。 共同所有者が割り当てられていない場合、ワークフローは所有者が存在しない場合に孤立フローになる可能性があります。 フローによって自動化されたビジネス プロセスの継続性を維持するために、管理者は 1 人以上の共同所有者を追加し、ワークフローを完全に制御できます。 また、接続の認証 (存在する場合) を追加し、フローが無効になっている場合はフローを有効にすることもできます。 詳細については、「 孤立フローの管理」を参照してください。

統合シナリオ: スタンドアロン アプリ、コラボレーション アプリ、SharePoint

Teams アプリには、必要で想定される共同作業機能が含まれている必要があります。 アプリ統合を使用するには、Teams 開発の用語について理解することが重要です。

アプリの一般的な機能 Teams プラットフォーム機能
埋め込み Web ページ、ホームページ、または Web ビュー タブ
Microsoft 365 全体で拡張されたタブ
ショートカットと拡張機能を共有する メッセージの拡張機能
Outlook のメッセージ拡張機能
アクションのショートカットと拡張機能 メッセージの拡張機能
Chatbots ボット
チャネル通知 ボット
受信 Webhook
Microsoft 365 グループ用コネクタ
メッセージ外部サービス ボット
送信 Webhook
モーダル ダイアログ (TeamsJS v1.x のタスク モジュールと呼ばれます)
コンテンツリッチ カード アダプティブ カード

機能のサブセットを決定する

統合シナリオ: スタンドアロン アプリ

既存のアプリケーションのすべての機能を Teams に統合すると、多くの場合、特に大規模なアプリでは、強制的または不自然なユーザー エクスペリエンスにつながります。 最もインパクトのある機能と、より自然に Teams と統合する機能から始めます。 ユーザーがメイン アプリを起動し、その機能の完全なセットにアクセスできるようにします。

アプリと Teams を統合するための前提条件を次に示します。

  1. ユース ケースを Teams アプリの機能にマッピングする。
  2. アプリのエントリ ポイントを決定します。 個人的な使用、コラボレーション、またはその両方に対してですか?

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)、21Vianet が運営する Teams では使用できません。 GCC では、サード パーティ製アプリは既定で無効になっています。 GCC のサード パーティ製アプリを有効にするには、「アプリのアクセス許可ポリシーを管理する」と「アプリの管理」を参照してください。

SharePoint ページでは、SSO のみを使用でき、ID が SharePoint アプリであるため、別のアプリで SSO を機能させる場合は、別の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 に生データを格納します。

関連項目