Habilitación de la vinculación profunda para acceder a Automation Co-Pilot en Microsoft Teams

Este tema explica cómo obtener los identificadores requeridos y armar un vínculo profundo de Microsoft Teams que abre Automation Co-Pilot directamente en una solicitud específica dentro de Microsoft Teams.

Antes de empezar

Para crear un vínculo profundo funcional, necesita lo siguiente:
ID de la aplicación
El ID de la aplicación Microsoft Teams (a veces llamada ID de la aplicación de Microsoft en la configuración de la aplicación de Teams).
ID de entidad
El identificador de la pestaña Personal (la pestaña que desea abrir dentro de Microsoft Teams).
ID de solicitud
La referencia de solicitud Automation Co-Pilot que desea que el vínculo abra.

Procedimiento

  1. Cree o abra su aplicación de Teams (ID de la aplicación).
    1. Abra Portal para desarrolladores de Microsoft Teams.
    2. Seleccione Aplicaciones.
      Si ya tiene una solicitud para Automation Co-Pilot, ábrala. De lo contrario, seleccione Crear una nueva aplicación e ingrese los datos requeridos, como el nombre, la descripción y la información del desarrollador.
    3. Copie el ID de la aplicación que se muestra para la aplicación (esto se utiliza en la URL de enlace profundo).
    Obtuvo un ID de aplicación.
    Por ejemplo:
    https://teams.microsoft.com/l/app/96bfc9ea-ffac-410d-96ca-df449bl83cl3?source=manage-apps-copy-link
    Aquí, 96bfc9ea-ffac-410d-96ca-df449bl83cl3 (la parte después de app/ es el ID de la aplicación.
    El <APP_ID> ha sido creado.
  2. Configure una pestaña Personal y capture el ID de entidad.
    1. En la misma aplicación dentro de Teams Developer Portal, vaya a Características de la aplicación.
    2. Ubique Aplicación personal (o la pestaña Personal dependiendo de la vista del portal).
    3. Agregue una pestaña Personal (o edite si ya tiene una) e ingrese los siguientes detalles, por ejemplo:
      • Nombre: Automation Co-Pilot
      • URL de contenido: la URL web que carga la pestaña (proporcionada por la configuración de Automation Co-Pilot)
      • Sitio web URL (opcional pero recomendado): una URL compatible con navegadores
    4. Guarde la configuración.
    5. Copie el ID de entidad para esa pestaña de Personal.
    Obtuvo un ID de entidad. Por ejemplo, 0eff0783-9304-4daa -9f6e-dfe0e8d0cfb3
  3. Obtenga el ID de solicitud (Automation Co-Pilot).

    Puede usar uno de los siguientes métodos para capturar el ID de solicitud que representa la solicitud que desea que el enlace profundo abra.

    • Copiar desde la página de solicitud
      • Abra Automation Co-Pilot y vaya a la solicitud.
      • Copie la referencia de la solicitud desde la interfaz de usuario (por ejemplo, Solicitar referencia)

        o

      • cópiela de la URL si la referencia de la solicitud aparece en la ruta.

      Los formatos típicos que se ven en las rutas son requests/ref/<REQUEST_ID>. Por ejemplo, requests/ref/62-152

    • Copiar desde un contenido de notificación (si corresponde)

      Si el proceso envía un mensaje o notificación que contiene una referencia de solicitud, copie la referencia de solicitud directamente de ese contenido.

    Obtuvo el ID de la solicitud. Por ejemplo, requests/ref/62-152
  4. Genere el vínculo profundo.
    El enlace profundo de la pestaña Personal de Teams utiliza este formato:
    https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<DEEP_LINK_PARAMETER>

    Para abrir una solicitud específica dentro de la pestaña, pase un parámetro context de Teams con un subEntityId que apunte a la ruta de la solicitud. Para generar el vínculo profundo,

    1. defina la ruta de subentidad como subEntityId = "requests/ref/<REQUEST_ID>". Por ejemplo, requests/ref/62-152.
    2. Cree el JSON de contexto como {"subEntityId":"requests/ref/<REQUEST_ID>"}.
    3. Codifique el parámetro de contexto en URL.

      Teams espera que la cadena de consulta esté codificada. El parámetro normalmente es context=<JSON>. Por ejemplo, (antes de codificar): context={"subEntityId":"requests/ref/62-152"}.

      Codifique todo este valor en URL y agréguelo después de ?.

    4. El enlace profundo de ejemplo final (plantilla) es https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<URL_ENCODED_CONTEXT> donde <URL_ENCODED_CONTEXT> es la forma codificada de: context={"subEntityId":"requests/ref/<REQUEST_ID>"}
  5. Pruebe el vínculo profundo en Microsoft Teams.
    1. Pegue el enlace directo en un mensaje de chat o canal de Teams.
    2. Seleccione el enlace.
    Teams abre la pestaña de la aplicación Automation Co-Pilot y navega directamente a la solicitud prevista.