Vínculo profundo al chat de Teams

Puede crear un vínculo profundo a un chat de Teamscomo iniciar un nuevo chatir a una conversación de canal y acceder a un archivo dentro de un canal.

Vínculo profundo para iniciar un nuevo chat

Puede navegar a o crear chats privados entre usuarios con la biblioteca cliente JavaScript de Microsoft Teams (TeamsJS) especificando el conjunto de participantes. Si no existe un chat con los participantes especificadosel vínculo lleva al usuario a un nuevo chat vacío.

Cuando un usuario crea un nuevo chat mediante un vínculo profundoTeams crea el nuevo chat en estado borrador hasta que el usuario envía el primer mensaje. También puede proporcionar el nombre del chat si aún no existejunto con el texto que se debe insertar en el cuadro de redacción del usuario. Considere este acceso directo para que el usuario realice la acción manual de navegar o crear el chat ya continuaciónredacte el mensaje.

Como ejemplo de caso de usosi está recuperando una información de perfil de usuario de Microsoft 365 del bot como una tarjetaeste vínculo profundo puede permitir que el usuario de la aplicación chatee fácilmente con esa persona.

Puede configurar vínculos profundos para iniciar un nuevo chat de una de las dos maneras siguientes:

• Configuración del vínculo profundo para iniciar un chat manualmente
• Configuración del vínculo profundo para iniciar un chat mediante la biblioteca teamsJS

Configuración del vínculo profundo para iniciar un chat manualmente

Aunque se recomienda el uso de las API tipeadastambién puede usar el siguiente formato para un vínculo profundo creado manualmente que puede usar en un botconector o tarjeta de extensión de mensaje:

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

Para usar este vínculo profundo con el botespecifique 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.

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. El parámetro User ID admite el Microsoft Entra UserPrincipalNamecomo solo una dirección de correo electrónico.
• topicName: parámetro opcional para el nombre para mostrar del chat si un chat tiene tres o más usuarios. Si no se especifica este campoel nombre para mostrar del chat se basa en los nombres de los participantes.
• message: un campo opcional para el texto del mensaje que desea insertar en el cuadro de redacción del usuario de la aplicación actual mientras el chat está en estado borrador.

Ejemplo: https://teams.microsoft.com/l/chat/0/[email protected],[email protected]&topicName=Prep%20For%20Meeting%20Tomorrow&message=Hi%20folks%2C%20kicking%20off%20a%20chat%20about%20our%20meeting%20tomorrow

Configuración del vínculo profundo para iniciar un chat mediante la biblioteca teamsJS

En el ejemplo siguiente se muestra cómo abrir un mensaje de chat a un grupo de participantes con un mensaje inicial. Puede dirigir el vínculo profundo a un chat existente o nuevo. Si ya existe un chatse abre el vínculo profundo en ese chat.

if(chat.isSupported()) {
    const chatPromise = chat.openGroupChat({ users: ["[email protected]","[email protected]"]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 */ }

Vínculo profundo para navegar a un chat

Para navegar a una conversación de chat específica en Teamsuse el siguiente formato de vínculo profundo:

https://teams.microsoft.com/l/chat/<chatId>/conversations

El parámetro de consulta es chatIdque representa el identificador de chat de la conversación. El formato admitido para chatId es 19:xxx.

Ejemplo: https://teams.microsoft.com/l/chat/19:[email protected]/conversations

Vínculo profundo para navegar a la conversación de canal

Puede usar el siguiente formato de vínculo profundo para ir a una conversación determinada dentro del subproceso del canal:

https://teams.microsoft.com/l/message/<channelId>/<messageId>?tenantId=<tenantId>&groupId=<groupId>&parentMessageId=<parentMessageId>&teamName=<teamName>&channelName=<channelName>&createdTime=<createdTime>

Los parámetros de consulta son:

• channelId: id. de canal de la conversación. Por ejemplo19:[email protected].
• tenantId: identificador de inquilinocomo 0d9b645f-597b-41f0-a2a3-ef103fbd91bb.
• groupId: id. de grupo del archivo. Por ejemplo3606f714-ec2e-41b3-9ad1-6afb331bd35d.
• parentMessageId: id. de mensaje primario de la conversación.
• teamName: nombre del equipo.
• channelName: nombre del canal del equipo.

Ejemplo: https://teams.microsoft.com/l/message/<channelId>/1648741500652?tenantId=<tenantId>&groupId=<groupId>&parentMessageId=1648741500652&teamName=<teamName>&channelName=<channelName>&createdTime=1648741500652

Vínculo profundo para navegar a mensajes de chat

Use el siguiente formato de vínculo profundo para navegar a un usuario a un mensaje en un chat personal o grupal en Teams:

https://teams.microsoft.com/l/message/{chatId}/{messageId}?tenantId=<tenantId>?context={"contextType":"chat"}

Los parámetros de consulta son:

• chatId: identificador de chat de la conversación. El formato admitido para chatId es 19: xxx. Por ejemplo19:253f5895-9a62-4362-8d38-43f0205c702c_f1b94dcf-0aa3-4989-bcdf-ef4a5ed00f86@unq.gbl.spaces.
  Las aplicaciones pueden leer un identificador de chat a través del contexto de la aplicación en Teamsla carga entrante al bot o a través de las API de Microsoft Graph.

  Nota:

  En el caso de los chats uno a uno con botla carga entrante al bot contiene el identificador de conversación en formato a:xxx.

• messageId: identificador de mensaje único de cada mensaje en un chat. Cuando un bot publica un mensaje en el messageId chatse devuelve . También puede obtener a través de las API de messageIdMicrosoft Graph. Por ejemplo1563480968434.
• context: especifique contextType como chat.

Ejemplo: https://teams.microsoft.com/l/message/19:253f5895-9a62-4362-8d38-43f0205c702c_f1b94dcf-0aa3-4989-bcdf-ef4a5ed00f86@unq.gbl.spaces/1563480968434?context=%7B%22contextType%22:%22chat%22%7D

Puede iniciar una conversación con un bot mediante un mensaje rellenado previamente a través de un vínculo profundo. Use el identificador de bot con 28: el prefijo en lugar de una dirección de correo electrónico. El formato del vínculo profundo es:

https://teams.microsoft.com/l/chat/0/0?users=28:[bot guid]&message=This%20message%20was%20triggered%20by%20a%20link!

El parámetro de consulta es bot guidque es el atributo bot ID en el manifiesto de la aplicación.

Ejemplo: https://teams.microsoft.com/l/chat/0/0?users=28:47345678-2134-6534-9143-65146789012&message=This%20message%20was%20triggered%20by%20a%20link!

El vínculo profundo proporcionado solo carga el mensaje en el cuadro de texto de chat del bot y no envía el mensaje automáticamente. Para enviar el mensajedebe seleccionar el botón Enviar o seleccionar Entrar.

Vínculo profundo para navegar a un equipo

Para navegar a un equipo determinadouse el siguiente formato de vínculo profundo:

https://teams.microsoft.com/l/team/<channelId>/conversations?groupId=<groupId>&tenantId=<tenantId>

Los parámetros de consulta son:

• channelId: id. de canal de la conversación (dirección URL codificada). Por ejemplo19%3ATWLPKo8lD4v8zDxyw4FnDYY-ovnBJG5CSjmrHUAoOz41%40thread.tacv2.
• groupId: id. de grupo del archivo. Por ejemplo72602e12-78ac-474c-99d6-f619710353a9.
• tenantId: identificador de inquilinocomo aaaabbbb-0000-cccc-1111-dddd222eeeeee.

Ejemplo: https://teams.microsoft.com/l/team/19%3ATWLPKo8lD4v8zDxyw4FnDYY-ovnBJG5CSjmrHUAoOz41%40thread.tacv2/conversations?groupId=72602e12-78ac-474c-99d6-f619710353a9&tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee

Vínculo profundo para navegar al canal

Puede usar los siguientes formatos de vínculo profundo para navegar a canales concretos:

• Standard canal:https://teams.microsoft.com/l/channel/<channelId>/<channelName>?groupId=<groupId>&tenantId=<tenantId>

  Ejemplo: https://teams.microsoft.com/l/channel/19%3A9be3de4e70874c71a608dee9ba803ed3%40thread.tacv2/My%20example%20channel?groupId=72602e12-78ac-474c-99d6-f619710353a9&tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee

• Canal privado: https://teams.microsoft.com/l/channel/<channelId>/<channelName>?groupId=<groupId>&tenantId=<tenantId>&ngc=true

  Ejemplo: https://teams.microsoft.com/l/channel/19%3A9be3de4e70874c71a608dee9ba803ed3%40thread.tacv2/My%20example%20channel?groupId=72602e12-78ac-474c-99d6-f619710353a9&tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee&ngc=true

• Canal compartido: https://teams.microsoft.com/l/channel/<channelId>/<channelName>?groupId=<groupId>&tenantId=<tenantId>&ngc=true&allowXTenantAccess=true

  Ejemplo: https://teams.microsoft.com/l/channel/19%3A9be3de4e70874c71a608dee9ba803ed3%40thread.tacv2/My%20example%20channel?groupId=72602e12-78ac-474c-99d6-f619710353a9&tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee&ngc=true&allowXTenantAccess=true

Los parámetros de consulta son:

• channelId: id. de canal de la conversación (dirección URL codificada). Por ejemplo19%3A9be3de4e70874c71a608dee9ba803ed3%40thread.tacv2.
• channelName: nombre del canal del equipo (con codificación URL). Por ejemploMy%20example%20channel.
• groupId: id. de grupo del equipo. Por ejemplo72602e12-78ac-474c-99d6-f619710353a9.
• tenantId: identificador de inquilinocomo aaaabbbb-0000-cccc-1111-dddd2222eeee.
• ngc: indica un canal de próxima generación. Para los canales privadosdebe establecerse en true.
• allowXTenantAccess: indica un canal al que se puede acceder a través de los límites del inquilino. Para los canales compartidosdebe establecerse en true.

Generación de un vínculo profundo a un archivo en un canal

Use el siguiente formato de vínculo profundo que se puede usar en un botconector o tarjeta de extensión de mensaje para configurar un vínculo profundo para conectarse a un archivo en un canal:

https://teams.microsoft.com/l/file/<fileId>?tenantId=<tenantId>&fileType=<fileType>&objectUrl=<objectUrl>&baseUrl=<baseUrl>&serviceName=<Name>&threadId=<threadId>&groupId=<groupId>

Los parámetros de consulta son:

• fileId: identificador de archivo único de Sharepoint Onlinetambién conocido como sourcedoc respuesta de la API de Sharepoint Online driveItem o sharepointIds.listItemUniqueId desde ella. Por ejemplo1FA202A5-3762-4F10-B550-C04F81F6ACBD.
• tenantId: identificador de inquilinocomo 0d9b645f-597b-41f0-a2a3-ef103fbd91bb.
• fileType: tipo de archivo admitidocomo docxpptxxlsx y pdf.
• objectUrl: dirección URL del objeto del archivo. El formato es https://{tenantName}.sharepoint.com/sites/{TeamName}/SharedDocuments/{ChannelName}/FileName.ext. Por ejemplohttps://microsoft.sharepoint.com/teams/(filepath).
• baseUrl: dirección URL base del archivo. El formato es https://{tenantName}.sharepoint.com/sites/{TeamName}. Por ejemplohttps://microsoft.sharepoint.com/teams.
• serviceName: nombre del servicioid. de aplicación. Por ejemploteams.
• threadId: threadID es el identificador de equipo del equipo donde se almacena el archivo. Es opcional y no se puede establecer para los archivos almacenados en la carpeta de OneDrive de un usuario. Por ejemplo19:<[email protected]>.
• groupId: id. de grupo del archivo. Por ejemploae063b79-5315-4ddb-ba70-27328ba6c31e.

En el siguiente formato de ejemplo se muestra el vínculo profundo a los archivos:

https://teams.microsoft.com/l/file/5E0154FC-F2B4-4DA5-8CDA-F096E72C0A80?tenantId=0d9b645f-597b-41f0-a2a3-ef103fbd91bb&fileType=pptx&objectUrl=https%3A%2F%2Fmicrosoft.sharepoint.com%2Fteams%2FActionPlatform%2FShared%20Documents%2FFC7-%20Bot%20and%20Action%20Infra%2FKaizala%20Actions%20in%20Adaptive%20Cards%20-%20Deck.pptx&baseUrl=https%3A%2F%2Fmicrosoft.sharepoint.com%2Fteams%2FActionPlatform&serviceName=teams&threadId=19:[email protected]&groupId=ae063b79-5315-4ddb-ba70-27328ba6c31e

Serialización de este objeto

{
fileId: "5E0154FC-F2B4-4DA5-8CDA-F096E72C0A80",
tenantId: "0d9b645f-597b-41f0-a2a3-ef103fbd91bb",
filetype: = "pptx",
objectUrl: "https://microsoft.sharepoint.com/teams/ActionPlatform/Shared Documents/FC7- Bot and Action Infra/Kaizala Actions in Adaptive Cards - Deck.pptx",
baseUrl: "https://microsoft.sharepoint.com/teams/ActionPlatform",
serviceName: "teams",
threadId: = "19:[email protected]",
groupId: "ae063b79-5315-4ddb-ba70-27328ba6c31e"
}

Ejemplo de código