ディープ リンクを構成する

  • [アーティクル]

ディープ リンクは、ユーザーをアプリ内の特定のコンテンツに直接誘導する URL として機能するため、複数の画面を移動する必要がなくなります。 Microsoft Teams では、ディープ リンクを使用して、アプリ内の特定のチャット、メッセージ、またはタブに移動できます。 ディープ リンクを使用して新しいチャットを開始したり、会議中にコンテンツを呼び出したり共有したりすることもできます。

Teams では、次の方法でディープ リンクを使用できます。

  • アプリへのディープ リンク
  • チャットへのディープ リンク
  • チームとチャネルへのディープ リンク
  • ワークフローへのディープ リンク

図は、ディープ リンクのさまざまなシナリオを示しています。

  • アプリへのディープ リンク: ディープ リンクを使用してタブ内のコンテンツを参照し、アプリのインストール ダイアログを開きます。 たとえば、アプリには、ユーザーに重要なアクティビティを通知するメッセージを送信するボットを含めることができます。 ユーザーが通知を選択すると、ディープ リンクがタブに移動し、ユーザーはアクティビティの詳細を表示できます。

    詳細については、「 アプリへのディープ リンク」を参照してください。

    グラフィカルな表現は、タブ アプリのディープ リンクのユーザー エクスペリエンスを示しています。

  • チャットへのディープ リンク: ディープ リンクを使用して、チャネル内のチャネル会話、チャット メッセージ、またはファイルに移動します。

    詳細については、「 チャットへのディープ リンク」を参照してください。

    グラフィカルな表現は、チャット内のディープ リンクのユーザー エクスペリエンスを示します。

  • チームとチャネルへのディープ リンク: ディープ リンクを使用して、特定のチームまたはチャネルに移動します。 詳細については、「 チャネルへのディープ リンク」を参照してください。

    グラフィカルな表現は、チャネル内のディープ リンクのユーザー エクスペリエンスを示しています。

  • ワークフローへのディープ リンク: ディープ リンクを使用して新しいチャットを作成したり、スケジュール ダイアログを開いたり、音声ビデオ通話に移動したりできます。 アプリ ユーザーは、簡略化されたユーザー タスクまたは自動化されたユーザー タスクを利用することで、アプリエクスペリエンスの向上を享受できます。 これらのタスクには、新しいチャットの開始や、必要なパラメーターを使用してディープ リンクを事前設定することで簡単に行うことができる会議のスケジュール設定が含まれます。

    詳細については、「 ワークフローへのディープ リンク」を参照してください。

    グラフィカルな表現は、会議のスケジュール 設定ダイアログを起動するためのディープ リンクのユーザー エクスペリエンスを示しています。

Microsoft Teams JavaScript クライアント ライブラリ (TeamsJS) を使用して、タブ内を移動できます。コンテンツや情報への移動やチャット ダイアログの起動などのシナリオでは、TeamsJS の型指定された API によってエクスペリエンスが向上します。 Outlook または Microsoft 365 アプリで実行される可能性がある Teams アプリには、TeamsJs 型の API を使用することをお勧めします。 また、ホストが使用する機能をサポートしているかどうかをチェックする方法も提供します。

注:

、などのtel:mailto:webex:プロトコルを使用したディープ リンクを介して Teams アプリからネイティブ エクスペリエンスにユーザーをリダイレクトするには、 メソッドを呼び出window.openすか、 でアンカー タグtarget="_blank"を使用して、新しいウィンドウでディープ リンクを起動します。

Teams ディープ リンクでは、次の 2 種類のプロトコル ハンドラーがサポートされています。

  1. HTTPS: https:// プロトコル ハンドラーは、ほとんどの URL の既定のハンドラーです。 Teams ディープ リンクでこのプロトコル ハンドラーを使用すると、ブラウザー ウィンドウで開き、次の 3 つのオプションが表示されます。

    1. Teams デスクトップ クライアントがインストールされている場合は、ディープ リンクを開きます
    2. Teams デスクトップ クライアントがインストールされていない場合はダウンロードします
    3. Teams Web クライアントでディープ リンクを開く

    ブラウザーで開かれたディープ リンクを示すスクリーンショット。

    注:

    ディープ リンクは、Teams によって正しく処理されるように、最初から始める https://teams.microsoft.com/l/ 必要があります。 ブラウザーのアドレス バーからコピーされた Teams URL は、新しい Teams クライアントのディープ リンクとして機能しません。

  2. MSTEAMS: プロトコル ハンドラーは msteams:// 、ブラウザーのクライアント選択画面をスキップし、Teams デスクトップ クライアントで直接ディープ リンクを開きます。 Teams デスクトップ クライアントを持っていないユーザーは、 を使用してディープ リンク msteams://にアクセスできない可能性があります。 アプリのユーザーがデバイスにデスクトップ クライアントを持っていることが確実でない限り、ディープ リンクで常に使用 https:// します。

    注意

    Teams でこのディープ リンクを有効な https:// URL オブジェクトとして解析できないなどmsteams:https://teams.microsoft.com/l/call/0/0、ディープ リンクに追加msteams:しないでください。

関連項目