Compartilhar com o Teams a partir do aplicativo ou guia pessoal

Partilhar no Teams permite que os utilizadores partilhem os conteúdos da aplicação pessoal ou do separador para outro utilizador, grupo ou canal no Teams. Os utilizadores podem selecionar Partilhar no Teams para iniciar a experiência Partilhar no Teams numa janela de pop-up. A janela de pop-up permite que os utilizadores adicionem outro utilizador, grupo ou canal para partilhar o conteúdo.

A imagem seguinte mostra a janela de pop-up Partilhar no Teams:

Desktop

Dispositivo móvel

Botão Ativar Partilhar no Teams

Observação

Certifique-se de que tem a biblioteca de cliente JavaScript do Microsoft Teams (@microsoft/teams-js@1.11.0-beta.7 ou posterior) para ativar a opção Partilhar no Teams para a sua aplicação ou separador pessoal.

Para ativar a opção Partilhar no Teams:

1. Crie uma aplicação pessoal ou um separador com a biblioteca de cliente Javascript do Teams.

2. Criar um botão Partilhar no Teams .

3. No botão Partilhar no Teams, ligue microsoftTeams.sharing.shareWebContent com um payload de conteúdo.

O exemplo seguinte explica como criar um payload de conteúdo:

microsoftTeams.sharing.shareWebContent({
        content: [
          {
            type: 'URL',
            url: '<URL to be shared>',
            message: 'Default message to be loaded in the compose box',
            preview: true
          }
        ]
      });

O payload contém os seguintes parâmetros:

Nome da propriedade	Objetivo
type	O tipo tem de ser URL
url	URL a partilhar
message	Mensagem predefinida a carregar na caixa de composição
preview	Definir como true para ativar a pré-visualização do URL

A imagem seguinte mostra a opção Partilhar no Teams:

O botão Partilhar no Teams pode ser alojado ou incorporado numa aplicação em execução no Teams. Pode adicionar o botão Partilhar ao Teams à aplicação criada com a biblioteca de cliente JavaScript do Teams.

Observação

A partilha com o Teams não é suportada dentro de uma caixa de diálogo modal (referida como módulos de tarefas no TeamsJS v1.x) ou Stageview no cliente Web do Teams. Não é possível abrir um modal em cima de outro modal.

Códigos de resposta

A tabela a seguir fornece os códigos de resposta:

Código da resposta	Descrição
100	A API não suportada na plataforma atual.
404	O ficheiro especificado não foi encontrado na localização especificada.
500	Foi encontrado um erro interno ao executar a operação necessária.
501	A API não é suportada no contexto atual.
1.000	Permissões negadas pelo utilizador.
2000	Problema de rede.
3000	O hardware subjacente não suporta a capacidade.
4000	Um ou mais argumentos são inválidos.
5000	O utilizador não está autorizado para esta operação.
6000	Não foi possível concluir a operação devido a recursos insuficientes.
7000	A plataforma limitava o pedido devido à API ter sido invocada com demasiada frequência.
8000	O utilizador abortou a operação.
9000	O código da plataforma é antigo e não implementa esta API.
10000	O valor devolvido é demasiado grande e excedeu os limites de tamanho.

Experiência partilhar com o Teams do utilizador final

Depois de ativar o botão Partilhar no Teams na aplicação ou separador pessoal, pode partilhar o conteúdo. Para aceder, siga os passos:

1. Abra uma aplicação ou separador pessoal e selecione Partilhar no Teams.

   

2. Adicione outro utilizador, grupo ou canal para partilhar o conteúdo.

   

3. Selecione Compartilhar.

   

4. Selecione Ver para aceder à conversação onde a ligação foi partilhada.

   

Confira também

• Integrar aplicativos Web
• Criar uma guia pessoal
• Canais partilhados do Microsoft Teams Connect