Vínculo profundo a un flujo de trabajo en Teams

  • Artículo

Puede crear un vínculo profundo para realizar una tarea específica en Teams, como crear un nuevo chat, abrir un cuadro de diálogo de programación y navegar a la llamada de audio y vídeo.

En este artículo, aprenderá a crear un vínculo profundo:

Las aplicaciones pueden iniciar un nuevo chat con una lista de usuarios y proporcionar información adicional, como el nombre del chat y el borrador de mensaje, con el siguiente formato:

https://teams.microsoft.com/l/chat/0/0?users=<user1>,<user2>,...&topicName=<chat name>&message=<precanned text>

Ejemplo: https://teams.microsoft.com/l/chat/0/0?users=joe@contoso.com,bob@contoso.com&topicName=Prep%20For%20Meeting%20Tomorrow&message=Hi%20folks%2C%20kicking%20off%20a%20chat%20about%20our%20meeting%20tomorrow

Los parámetros de consulta son:

  • users: lista separada por comas de identificadores de usuario que representan a los participantes del chat. El usuario que realiza la acción siempre se incluye como participante. Actualmente, el campo Id. de usuario admite el Microsoft Entra UserPrincipalName, como solo una dirección de correo electrónico.
  • topicName: un campo opcional para el nombre para mostrar del chat si un chat tiene tres o más usuarios. Si no se especifica este campo, el nombre para mostrar del chat se basa en los nombres de los participantes.
  • message: un campo opcional para el texto del mensaje que quiere insertar en el cuadro de redacción del usuario actual mientras el chat está en un estado de borrador.

Para usar este vínculo profundo con el bot, especifique el vínculo profundo como destino de dirección URL en el botón de la tarjeta o pulse la acción a través del openUrl tipo de acción. Las aplicaciones también pueden usar la biblioteca cliente JavaScript de Teams (TeamsJS) v.2.0 o posterior para crearla sin tener que preparar manualmente el vínculo profundo. En el ejemplo siguiente se usa TeamsJS para comprobar si se admite la funcionalidad de chat:

if(chat.isSupported()) {
    const chatPromise = chat.openGroupChat({ users: ["joe@contoso.com","bob@contoso.com"], topic: "Prep For Meeting Tomorrow", message: "Hi folks kicking off chat about our meeting tomorrow"});
    chatPromise.
      then((result) => {/*Successful operation*/}).
      catch((error) => {/*Unsuccessful operation*/});
}
else { /* handle case where capability isn't supported */ }

Nota:

Si ya existe un vínculo profundo en ese chat.

Puede crear un vínculo profundo en las aplicaciones de Teams para abrir un cuadro de diálogo de programación de reuniones y proporcionar información, como el título de la reunión y los participantes mediante los métodos siguientes:

Aunque se recomienda el uso de API con tipo de TeamsJS, es posible crear manualmente vínculos profundos al cuadro de diálogo de programación integrado de Teams.

Use el siguiente formato para configurar un vínculo profundo que puede usar en un bot, conector o tarjeta de extensión de mensaje:

https://teams.microsoft.com/l/meeting/new?subject=<meeting subject>&startTime=<date>&endTime=<date>&content=<content>&attendees=<user1>,<user2>,<user3>,...

Nota:

Los parámetros de búsqueda no admiten la señal + en lugar de espacios en blanco (``). Asegúrese de que el código de codificación uri devuelve %20 espacios. Por ejemplo, ?subject=test%20subject es bueno, pero ?subject=test+subject es malo.

Los parámetros de consulta son:

  • attendees: una lista opcional separada por comas de identificadores de usuario que representan a los asistentes de la reunión. El usuario que realiza la acción es el organizador de la reunión. El campo id. de usuario solo admite el Microsoft Entra UserPrincipalName, normalmente una dirección de correo electrónico.
  • startTime: parámetro opcional para la hora de inicio del evento. La hora de inicio debe estar en formato ISO 8601 largo, por ejemplo , 2018-03-12T23:55:25+02:00.
  • endTime: parámetro opcional para la hora de finalización del evento, también en formato ISO 8601.
  • subject: parámetro opcional para el asunto de la reunión.
  • content: parámetro opcional para el campo de detalles de la reunión.

Nota:

No se puede especificar la ubicación, ya que no se admite. Debe especificar el desplazamiento UTC, que incluye zonas horarias, al generar las horas de inicio y finalización.

Para usar este vínculo profundo con el bot, puede especificar el vínculo profundo como destino de dirección URL en el botón de la tarjeta o como una acción de pulsación a través del openUrl tipo de acción.

Ejemplo: https://teams.microsoft.com/l/meeting/new?subject=test%20subject&attendees=joe@contoso.com,bob@contoso.com&startTime=10%2F24%2F2018%2010%3A30%3A00&endTime=10%2F24%2F2018%2010%3A30%3A00&content=​​​​​​​test%3Acontent​​​​​​​​​​​​​​

También puede usar TeamsJS v.2.0 o posterior en la aplicación teams para abrir el cuadro de diálogo de programación de reuniones sin tener que preparar manualmente el vínculo. Para abrir el cuadro de diálogo de programación en Teams, debe seguir usando el método original basado en direcciones URL de vínculo profundo, ya que Teams aún no admite la funcionalidad de calendario:

// Open a scheduling dialog from your tab
if(calendar.isSupported()) {
   const calendarPromise = calendar.composeMeeting({
      attendees: ["joe@contoso.com", "bob@contoso.com"],
      content: "test content",
      endTime: "2018-10-24T10:30:00-07:00",
      startTime: "2018-10-24T10:00:00-07:00",
      subject: "test subject"});
   calendarPromise.
      then((result) => {/*Successful operation*/}).
      catch((error) => {/*Unsuccessful operation*/});
}
else { /* handle case where capability isn't supported */ }

Para obtener más información sobre cómo trabajar con el calendario, consulte el espacio de nombres del calendario en la documentación de referencia de la API.

Puede configurar las aplicaciones de Teams para preparar un vínculo profundo para que los usuarios inicien una llamada uno a uno, una llamada grupal o una videollamada. Puede invocar solo audio o audio-vídeo a un único usuario o grupo de usuarios especificando el tipo de llamada y los participantes. Antes de que Teams coloque la llamada, el cliente solicita una confirmación. Si hay una llamada de grupo, puede llamar a un conjunto de usuarios VoIP y RTC en la misma invocación de vínculo profundo.

En una videollamada, el cliente de Teams solicita confirmación antes de activar el vídeo del autor de la llamada para la llamada. El receptor de la llamada tiene la opción de responder solo a través de audio o con audio y vídeo, a través de la ventana de notificación de llamadas de Teams.

Nota:

Este método no se puede usar para invocar una reunión.

Puede configurar vínculos profundos de una de las dos maneras siguientes:

Aunque se recomienda el uso de las API con tipo de TeamsJS v.2.0 o posterior, también puede usar un vínculo profundo configurado manualmente para iniciar una llamada. Consulte los siguientes formatos:

Vínculo profundo Formato Ejemplo
Realizar una llamada de audio https://teams.microsoft.com/l/call/0/0?users=<user1>,<user2> https://teams.microsoft.com/l/call/0/0?users=joe@contoso.com
Realizar una llamada de audio y vídeo https://teams.microsoft.com/l/call/0/0?users=<user1>,<user2>&withVideo=true https://teams.microsoft.com/l/call/0/0?users=joe@contoso.com&withVideo=true
Realizar una llamada de audio y vídeo con un origen de parámetros opcional https://teams.microsoft.com/l/call/0/0?users=<user1>,<user2>&withVideo=true&source=demoApp https://teams.microsoft.com/l/call/0/0?users=joe@contoso.com&withVideo=true&source=demoApp
Realizar una llamada de audio y vídeo a una combinación de usuarios de VoIP y RTC https://teams.microsoft.com/l/call/0/0?users=<user1>,4:<phonenumber> https://teams.microsoft.com/l/call/0/0?users=joe@contoso.com,4:9876543210

Estos son los parámetros de consulta:

  • users: lista separada por comas de identificadores de usuario que representan a los participantes de la llamada. El campo id. de usuario admite el Microsoft Entra UserPrincipalName, normalmente una dirección de correo electrónico o, en una llamada RTC, admite una MRI RTC 4:<phonenumber>.
  • withVideo: parámetro opcional que puede usar para realizar una videollamada. Al establecer este parámetro, solo se activa la cámara del autor de la llamada. El receptor de la llamada tiene la opción de responder a través de un audio o una llamada de audio y vídeo a través de la ventana de notificación de llamadas de Teams.

Las aplicaciones también pueden usar TeamsJS v.2.0 o posterior para iniciar llamadas sin tener que preparar manualmente estos vínculos profundos. En el código siguiente se muestra cómo usar TeamsJS para iniciar una llamada:

if(call.isSupported()) {
    const callPromise = call.startCall({ targets: ["joe@contoso.com","bob@contoso.com","4:9876543210"], requestedModalities: [call.CallModalities.Audio], source: "demoApp"});
    callPromise.
      then((result) => {/*Successful operation*/}).
      catch((error) => {/*Unsuccessful operation*/});
}
else { /* handle case where capability isn't supported */ }

Generación de un vínculo profundo para compartir contenido para realizar una fase en las reuniones

Puede generar un vínculo profundo para compartir la aplicación para realizar la fase e iniciar o unirse a una reunión.

Para obtener vínculos profundos para compartir contenido para realizar la fase, consulte vínculo profundo para compartir contenido en la fase de las reuniones.

Puede generar un vínculo profundo al panel lateral de la reunión en una reunión. Use el siguiente formato para un vínculo profundo al panel lateral de la reunión:

https://teams.microsoft.com/l/entity/<appId>/<entityId>?webUrl=<entityWebUrl>&label=<entityLabel>&context=<context>.

Ejemplo:

https://teams.microsoft.com/l/entity/fe4a8eba-2a31-4737-8e33-e5fae6fee194/tasklist123?webUrl=https://tasklist.example.com/123/456&label=Task 456&context={"chatId": "17:b42de192376346a7906a7dd5cb84b673@thread.v2","contextType":"chat"}

De forma predeterminada, se abre un vínculo profundo en un panel lateral de la reunión. Para abrir un vínculo profundo directamente en una aplicación en lugar del panel lateral de la reunión, agregue openInMeeting=false el formato de vínculo profundo:

https://teams.microsoft.com/l/entity/<appId>/<entityId>?webUrl=<entityWebUrl>&label=<entityLabel>&context=<context>&openInMeeting=false

Para obtener más información, consulte vínculo profundo a una pestaña.

El vínculo profundo no se abre en el panel lateral de la reunión en los siguientes escenarios:

  • No hay ninguna reunión activa.
  • La aplicación no tiene sidePanel el contexto declarado en el manifiesto de la aplicación.
  • openInMeeting se establece false en en el vínculo profundo.
  • El vínculo profundo se selecciona fuera de la ventana o componente de la reunión.
  • El vínculo profundo no coincide con la reunión actual, como un vínculo profundo creado en otra reunión.

La aplicación Teams puede leer la dirección URL para unirse a una dirección URL de reunión a través de graph API. Este vínculo profundo abre la interfaz de usuario para que el usuario se una a la reunión. Para obtener más información, vea Obtener onlineMeeting y obtener detalles de la reunión.

Ejemplo de código

Ejemplo de nombre Descripción .NET Node.js
Identificador de subentidad de consumo de vínculos profundos En este ejemplo se muestra cómo usar un vínculo profundo desde un chat de bot a una pestaña que consume el identificador de subentidad. También muestra vínculos profundos para:
- Navegar a una aplicación
- Navegar a un chat
- Abrir un cuadro de diálogo de perfil
- Abrir un cuadro de diálogo de programación		 View View