Microsoft TeamsでAutomation Co-Pilotにアクセスするためのディープリンクを有効にする

このトピックでは、必要な識別子を取得し、Microsoft Teams内の特定のリクエストに直接Automation Co-Pilotを開くMicrosoft Teamsディープリンクを構築する方法について説明します。

前提条件

動作するディープリンクを構築するには、次が必要です
アプリ ID
Microsoft Teamsアプリの ID（Teams アプリケーションの設定で Microsoft App ID と呼ばれることもあります）。
エンティティ ID
Microsoft Teamsの中で開きたいタブであるPersonalタブの識別子。
リクエスト ID
リンクを開くためのAutomation Co-Pilotリクエスト参照。

手順

  1. Teams アプリ（アプリ ID）を作成または開きます。
    1. Microsoft Teams Developer Portalを開く。
    2. アプリを選択します。
      Automation Co-Pilotのアプリケーションがすでに開いている場合は、それを開いてください。 そうでなければ、新しいアプリを作成を選択し、名前、説明、開発者情報などの必要な詳細を入力してください。
    3. アプリに表示されている App ID をコピーしてください（これはディープリンク URL で使用されます）。
    あなたは App ID を取得しました。
    例えば、
    https://teams.microsoft.com/l/app/96bfc9ea-ffac-410d-96ca-df449bl83cl3?source=manage-apps-copy-link
    ここで、96bfc9ea-ffac-410d-96ca-df449bl83cl3 (app/ の後の部分は App ID です。
    <APP_ID> が作成されました。
  2. パーソナルタブを設定し、エンティティ IDを取得します。
    1. 同じアプリ内の Teams Developer Portal に移動し、アプリ機能 に行きます。
    2. パーソナル app（またはポータルビューに応じてパーソナルタブ）を見つけてください。
    3. パーソナル タブを追加する（すでにある場合は編集）し、以下の詳細を入力してください。例えば：
      • 名前: Automation Co-Pilot
      • コンテンツ URL: タブが読み込むウェブ URL（あなたのAutomation Co-Pilot設定によって提供されます）
      • ウェブサイト URL（任意ですが推奨）：ブラウザで利用可能な URL
    4. 構成を保存します。
    5. そのパーソナルタブのためにエンティティ IDをコピーしてください。
    エンティティ ID を取得しました。 例えば、0eff0783-9304-4daa -9f6e-dfe0e8d0cfb3
  3. リクエスト ID (Automation Co-Pilot) を取得します。

    以下のいずれかの方法を使用して、ディープリンクを開くリクエストを表す リクエスト ID をキャプチャできます。

    • リクエストページからコピー
      • Automation Co-Pilot を開き、リクエストに移動します。
      • UI からリクエスト参照をコピーします（例えば、Request Ref）、

        または

      • ルートにリクエスト参照が表示されている場合は、URL からコピーしてください。

      ルートで見られる典型的なフォーマットは requests/ref/<REQUEST_ID> です。 例えば、requests/ref/62-152

    • 通知ペイロードからコピーする（該当する場合）

      プロセスがリクエスト参照を含むメッセージまたは通知を送信する場合は、そのペイロードからリクエスト参照を直接コピーしてください。

    リクエスト IDを取得しました。 例えば、requests/ref/62-152
  4. ディープリンクを作成します。
    Teams Personal タブのディープリンクはこの形式を使用します:
    https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<DEEP_LINK_PARAMETER>

    タブ内の特定のリクエストを開くには、リクエストルートを指す subEntityId を持つ Teams context パラメータを渡してください。 ディープリンクを作成するには、

    1. subEntityId = "requests/ref/<REQUEST_ID>"としてサブエンティティルートを定義します。 例: requests/ref/62-152。
    2. コンテキスト JSON を次のように作成します: {"subEntityId":"requests/ref/<REQUEST_ID>"}。
    3. コンテキストパラメータを URL エンコードします。

      Teams はクエリ文字列がエンコードされることを期待しています。 パラメータは通常 context=<JSON> です。 例えば、（エンコード前）：context={"subEntityId":"requests/ref/62-152"}。

      この全体の値を URL エンコードし、?の後に追加してください。

    4. 最終的な例のディープリンク（テンプレート）は https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<URL_ENCODED_CONTEXT> であり、<URL_ENCODED_CONTEXT> は次のエンコード形式です: context={"subEntityId":"requests/ref/<REQUEST_ID>"}
  5. Microsoft Teamsでディープリンクをテストしてください。
    1. Teams のチャットまたはチャネル メッセージにディープリンクを貼り付けてください。
    2. リンクを選択します。
    Teams はAutomation Co-Pilotアプリタブを開き、目的のリクエストに直接移動します。