In diesem Thema wird erläutert, wie Sie die erforderlichen Bezeichner erhalten und einen Microsoft Teams Deep Link erstellen, der Automation Co-Pilot direkt zu einer bestimmten Anfrage in Microsoft Teams öffnet.

Vorbereitungen

Um einen funktionierenden Deep Link zu erstellen, benötigen Sie
App-ID
Die ID der Microsoft Teams App (manchmal als Microsoft-App-ID in der Teams-Anwendungskonfiguration bezeichnet).
Entitäts-ID
Die Kennung des Persönlichen Tabs (des Tabs, den Sie innerhalb von Microsoft Teams öffnen möchten).
Anforderungs-ID
Die Automation Co-Pilot-Anforderungs-ID, die der Link öffnen soll.

Prozedur

  1. Erstellen oder öffnen Sie Ihre Teams-App (App-ID).
    1. Öffnen Sie Microsoft Teams Developer Portal.
    2. Wählen Sie Apps aus.
      Wenn Sie bereits einen Antrag für Automation Co-Pilot haben, öffnen Sie ihn. Andernfalls wählen Sie Neue App erstellen und geben Sie die erforderlichen Details wie Name, Beschreibung und Entwicklerinformationen ein.
    3. Kopieren Sie die App-ID, die für die App angezeigt wird (diese wird in der Deep-Link-URL verwendet).
    Sie haben eine App-ID erhalten.
    Beispiel:
    https://teams.microsoft.com/l/app/96bfc9ea-ffac-410d-96ca-df449bl83cl3?source=manage-apps-copy-link
    Hier, 96bfc9ea-ffac-410d-96ca-df449bl83cl3 (Teil nach app/ ist die App-ID.
    <APP_ID> wird erstellt.
  2. Konfigurieren Sie den Tab Persönlich und erfassen Sie die Entitäts-ID.
    1. Im selben App innerhalb von Teams-Entwicklerportal gehen Sie zu App-Funktionen.
    2. Suchen Sie Persönliche App (oder den Tab Persönlich , je nach Portalansicht).
    3. Fügen Sie den Tab Persönlich hinzu (oder bearbeiten Sie diesen, falls bereits vorhanden), und geben Sie zum Beispiel die folgenden Details ein:
      • Name: Automation Co-Pilot
      • Inhalts-URL: die Web-URL, die Ihr Tab lädt (bereitgestellt durch Ihr Automation Co-Pilot-Setup)
      • Website-URL (optional, aber empfohlen): eine browserfreundliche URL
    4. Speichern Sie die Konfiguration.
    5. Kopieren Sie die Entitäts-ID für diesen Persönlich-Tab.
    Sie haben eine Entitäts-ID erhalten. Zum Beispiel 0eff0783-9304-4daa -9f6e-dfe0e8d0cfb3
  3. Erhalten Sie die Anforderungs-ID (Automation Co-Pilot).

    Sie können eine der folgenden Methoden verwenden, um die Anforderung-ID zu erfassen, die die Anforderung darstellt, die Sie mit dem Deep Link öffnen möchten.

    • Kopieren Sie von der Anforderungsseite
      • Öffnen Sie Automation Co-Pilot und navigieren Sie zur Anforderung.
      • Kopieren Sie die Anforderungsreferenz aus der Benutzeroberfläche (zum Beispiel Request Ref),

        oder

      • Kopieren Sie sie aus der URL, wenn die Anforderungsreferenz in der Route erscheint.

      Typische Formate, die in Routen zu sehen sind, sind requests/ref/<REQUEST_ID>. Zum Beispiel requests/ref/62-152

    • Von einer Benachrichtigungsnutzlast kopieren (falls zutreffend)

      Wenn Ihr Prozess eine Nachricht oder Benachrichtigung mit einer Anforderungsreferenz sendet, kopieren Sie die Anforderungsreferenz direkt aus dieser Nutzlast.

    Sie haben die Anforderungs-ID erhalten. Zum Beispiel requests/ref/62-152
  4. Erstellen Sie den Deep Link.
    Teams-Deep-Link für den Tab Persönlich verwendet dieses Format:
    https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<DEEP_LINK_PARAMETER>

    Um eine bestimmte Anfrage innerhalb des Tabs zu öffnen, übergeben Sie einen Teams context-Parameter mit einer subEntityId, die auf die Anforderungsroute verweist. Um den Deep Link zu erstellen,

    1. Definieren Sie die Sub-Entitätsroute als subEntityId = "requests/ref/<REQUEST_ID>". Zum Beispiel requests/ref/62-152.
    2. Erstellen Sie das Kontext-JSON als {"subEntityId":"requests/ref/<REQUEST_ID>"}.
    3. Kodieren Sie die Kontextparameter URL.

      Teams erwartet, dass die Abfragezeichenfolge kodiert ist. Der Parameter ist typischerweise context=<JSON>. Zum Beispiel, (vor der Kodierung): context={"subEntityId":"requests/ref/62-152"}.

      Kodieren Sie diesen gesamten Wert als URL und fügen Sie ihn nach ? an.

    4. Letztes Beispiel für einen Deep Link (Vorlage) ist https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<URL_ENCODED_CONTEXT>, wobei <URL_ENCODED_CONTEXT> die kodierte Form von: context={"subEntityId":"requests/ref/<REQUEST_ID>"} ist.
  5. Testen Sie den Deep Link in Microsoft Teams.
    1. Fügen Sie den Deep Link in eine Teams-Chat- oder Kanalnachricht ein.
    2. Wählen Sie den Link aus.
    Teams öffnet den Automation Co-Pilot App-Tab und navigiert direkt zur gewünschten Anfrage.