Configurar links profundos

  • Artigo

Os links profundos funcionam como URLs que direcionam os usuários diretamente para conteúdo específico em um aplicativo, eliminando assim a necessidade de navegar por várias telas. No Microsoft Teams, você pode usar links profundos para acessar um chat, mensagem ou guia específico em um aplicativo. Você também pode usar links profundos para iniciar um novo chat ou chamar e compartilhar conteúdo durante uma reunião.

Você pode usar links profundos no Teams das seguintes maneiras:

  • Link profundo para um aplicativo
  • Link profundo para um chat
  • Link profundo para equipes e canais
  • Link profundo para um fluxo de trabalho

Diagrama mostra vários cenários para links profundos.

  • Link profundo para um aplicativo: use um link profundo para navegar pelo conteúdo em uma guia e abrir uma caixa de diálogo de instalação de aplicativo. Por exemplo, seu aplicativo pode ter um bot que envia mensagens notificando o usuário de uma atividade importante. Quando o usuário seleciona a notificação, o link profundo navega até a guia em que o usuário pode exibir mais detalhes sobre a atividade.

    Para obter mais informações, consulte link profundo para um aplicativo.

    A representação gráfica mostra a experiência do usuário de links profundos no aplicativo de guias.

  • Link profundo para um chat: use um link profundo para navegar até uma conversa de canal, mensagens de chat ou um arquivo dentro de um canal.

    Para obter mais informações, consulte link profundo para um chat.

    A representação gráfica mostra a experiência do usuário de links profundos no chat.

  • Link profundo para equipes e canais: use um link profundo para navegar até uma equipe ou canal específico. Para obter mais informações, consulte link profundo para um canal.

    A representação gráfica mostra a experiência do usuário de links profundos no canal.

  • Link profundo para um fluxo de trabalho: use um link profundo para criar um novo chat, abrir uma caixa de diálogo de agendamento ou navegar até uma chamada de áudio-vídeo. Os usuários do aplicativo podem se beneficiar de uma experiência de aplicativo aprimorada utilizando tarefas simplificadas ou automatizadas do usuário. Essas tarefas incluem iniciar um novo chat ou agendar uma reunião que pode ser facilitada pré-populando os links profundos com os parâmetros necessários.

    Para obter mais informações, consulte link profundo para um fluxo de trabalho.

    A representação gráfica mostra a experiência do usuário de links profundos para iniciar uma caixa de diálogo de agendamento de reunião.

Você pode usar a biblioteca de clientes JavaScript do Microsoft Teams (TeamsJS) para navegar na sua guia. Para cenários como navegar para conteúdo e informações ou iniciar uma caixa de diálogo de chat, as APIs digitadas pelo TeamsJS fornecem uma experiência aprimorada. Recomendamos usar APIs digitados pelo TeamsJs para aplicativos do Teams que possam ser executadas em aplicativos do Outlook ou do Microsoft 365. Eles também fornecem uma maneira de marcar se o host dá suporte à funcionalidade usada.

Observação

Para redirecionar os usuários do aplicativo teams para sua experiência nativa por meio de um link profundo com um protocolo como , ou , inicie o link profundo em uma nova janela chamando o window.open método ou usando uma marca de âncora com target="_blank".webex:mailto:tel:

Os links profundos do Teams dão suporte a dois tipos de manipuladores de protocolo:

  1. HTTPS: o https:// manipulador de protocolo é o manipulador padrão na maioria das URLs. Usar esse manipulador de protocolo em um link profundo do Teams o abre em uma janela do navegador que oferece três opções:

    1. Abra o link profundo no cliente da área de trabalho do Teams se ele estiver instalado
    2. Baixe o cliente da área de trabalho do Teams se ele não estiver instalado
    3. Abra o link profundo no cliente Web do Teams

    A captura de tela mostra um link profundo aberto em um navegador.

    Observação

    Um link profundo deve começar para https://teams.microsoft.com/l/ garantir que ele seja tratado corretamente pelo Teams. As URLs do Teams copiadas da barra de endereços do navegador não funcionam como links profundos no novo cliente do Teams.

  2. MSTEAMS: o msteams:// manipulador de protocolo ignora a tela de seleção do cliente no navegador e abre o link profundo diretamente no cliente da área de trabalho do Teams. Os usuários que não têm o cliente da área de trabalho do Teams podem não ser capazes de acessar links profundos com msteams://. https:// Use sempre em links profundos, a menos que você tenha certeza de que os usuários do seu aplicativo têm o cliente da área de trabalho em seu dispositivo.

    Cuidado

    Não acrescentar msteams: a um https:// link profundo, como msteams:https://teams.microsoft.com/l/call/0/0 o Teams, não pode analisar esse link profundo como um objeto URL válido.

Confira também