Compartir en Teams desde una aplicación personal o una pestaña

Compartir con Teams permite a los usuarios compartir el contenido desde una aplicación personal o una pestaña a otro usuario o grupo o canal dentro de Teams. Los usuarios pueden seleccionar Compartir en Teams para iniciar la experiencia Compartir con Teams en una ventana emergente. La ventana emergente permite a los usuarios agregar otro usuario o grupo o canal para compartir el contenido.

En la imagen siguiente se muestra la ventana emergente Compartir con Teams:

Habilitar el botón Compartir en Teams

Nota:

Asegúrese de que tiene la biblioteca cliente javaScript de Microsoft Teams (@microsoft/teams-js@1.11.0-beta.7 o posterior) para habilitar Compartir en Teams para su aplicación o pestaña personal.

Para habilitar Compartir en Teams:

  1. Cree una aplicación personal o una pestaña con la biblioteca cliente javascript de Teams.

  2. Crear un botón Compartir en Teams .

  3. En el botón Compartir con Teams, llame a microsoftTeams.sharing.shareWebContent con una carga de contenido.

En el ejemplo siguiente se explica cómo crear una carga de contenido:

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

La carga contiene los parámetros siguientes:

Nombre de propiedad Objetivo
type El tipo debe ser URL
url URL que se va a compartir
message Mensaje predeterminado que se va a cargar en el cuadro de redacción
preview Establézcalo true en para habilitar la versión preliminar de la dirección URL.

En la imagen siguiente se muestra la opción Compartir con Teams:

botón compartir a equipos

Códigos de respuesta

En la tabla siguiente se proporcionan los códigos de respuesta:

Código de respuesta Descripción
100 LA API no se admite en la plataforma actual.
404 El archivo especificado no se encontró en la ubicación especificada.
500 Error interno al realizar la operación necesaria.
501 La API no se admite en el contexto actual.
1 000 Permisos denegados por el usuario.
2000 Problema de red.
3000 El hardware subyacente no admite la funcionalidad.
4000 Uno o más argumentos no son válidos.
5000 El usuario no está autorizado para esta operación.
6000 No se pudo completar la operación debido a recursos insuficientes.
7000 La plataforma limitó la solicitud debido a que la API se invocó con demasiada frecuencia.
8000 El usuario anuló la operación.
9000 El código de la plataforma es antiguo y no implementa esta API.
10000 El valor devuelto es demasiado grande y ha superado los límites de tamaño.

Limitaciones

  • El botón Compartir con Teams se puede hospedar o incrustar en una aplicación que se ejecuta dentro de Teams.
  • Puede agregar el botón Compartir a Teams a la aplicación creada mediante la biblioteca cliente de JavaScript de Teams.

Experiencia de Share to Teams del usuario final

Después de habilitar el botón Compartir en Teams en la pestaña o aplicación personal, puede compartir el contenido. Para obtener acceso, siga estos pasos:

  1. Abra una aplicación o pestaña personal y seleccione Compartir con Teams.

    botón compartir a equipos

  2. Agregue otro usuario, grupo o canal para compartir el contenido.

    add-recipient

  3. Seleccione Compartir.

    add-note

  4. Seleccione Ver para llegar a la conversación donde se ha compartido el vínculo.

    share-to-teams-link-shared

Consulte también