Compartilhar com o Teams a partir do aplicativo ou guia pessoal

  • Artigo

O compartilhamento com o Teams permite que os usuários compartilhem o conteúdo do aplicativo pessoal ou da guia para outro usuário ou grupo ou canal no Teams. Os usuários podem selecionar Compartilhar para o Teams para iniciar a experiência compartilhar com o Teams em uma janela pop-up. A janela pop-up permite que os usuários adicionem outro usuário ou grupo ou canal para compartilhar o conteúdo.

A imagem a seguir mostra a janela pop-up Compartilhar para o Teams:

Botão Habilitar Compartilhar para o Teams

Observação

Verifique se você tem a biblioteca de clientes JavaScript do Microsoft Teams (@microsoft/teams-js@1.11.0-beta.7 ou posterior) para habilitar o Share to Teams para seu aplicativo pessoal ou guia.

Para habilitar o Share to Teams:

  1. Crie um aplicativo pessoal ou uma guia com a biblioteca de clientes Javascript do Teams.

  2. Crie um botão Compartilhar para o Teams .

  3. No botão Compartilhar para o Teams, chame microsoftTeams.sharing.shareWebContent com uma carga de conteúdo.

O exemplo a seguir explica como criar uma carga 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
          }
        ]
      });

A carga contém os seguintes parâmetros:

Nome da propriedade Objetivo
type O tipo deve ser URL
url URL a ser compartilhado
message Mensagem padrão a ser carregada na caixa de composição
preview Definido como para habilitar a true visualização de URL

A imagem a seguir mostra a opção Compartilhar para o Teams:

botão share-to-teams

O botão Compartilhar com o Teams pode ser hospedado ou inserido em um aplicativo em execução no Teams. Você pode adicionar o botão Compartilhar ao Teams ao aplicativo criado usando a biblioteca de clientes JavaScript do Teams.

Observação

O compartilhamento com o Teams não tem suporte em uma caixa de diálogo modal (conhecida como módulos de tarefa 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 tem suporte na plataforma atual.
404 O arquivo especificado não foi encontrado no local determinado.
500 Erro interno encontrado durante a execução da operação necessária.
501 A API não tem suporte no contexto atual.
1.000 Permissões negadas pelo usuário.
2000 Problema de rede.
3000 O hardware subjacente não dá suporte à funcionalidade.
4000 Um ou mais argumentos são inválidos.
5000 O usuário não está autorizado para essa operação.
6000 Não foi possível concluir a operação devido a recursos insuficientes.
7000 A plataforma limitou a solicitação devido à API ter sido invocada com muita frequência.
8000 O usuário anulou a operação.
9000 O código da plataforma é antigo e não implementa essa API.
10000 O valor retornado é muito grande e excedeu nossos limites de tamanho.

Experiência de compartilhamento de usuário final para o Teams

Depois de habilitar o botão Compartilhar para o Teams no aplicativo pessoal ou na guia, você pode compartilhar o conteúdo. Para acessar, siga as etapas:

  1. Abra um aplicativo pessoal ou uma guia e selecione Compartilhar para o Teams.

    botão share-to-teams

  2. Adicione outro usuário ou grupo ou canal para compartilhar o conteúdo.

    add-recipient

  3. Selecione Compartilhar.

    add-note

  4. Selecione Exibir para acessar a conversa em que o link foi compartilhado.

    share-to-teams-link-shared

Confira também