Compartir a través de

Habilitar el uso compartido de archivos mediante la biblioteca de interfaz de usuario en el chat de interoperabilidad de Teams

  • Artículo

En un chat de interoperabilidad de Teams ("chat de interoperabilidad"), podemos habilitar el uso compartido de archivos entre los usuarios finales de Azure Communication Services y los usuarios de Teams. Tenga en cuenta que el chat de interoperabilidad es diferente del Azure Communication Services Chat. Si quiere habilitar los archivos compartidos en Azure Communication Services Chat, consulte Agregar uso compartido de archivos con la biblioteca de la interfaz de usuario en Azure Communication Services Chat. Actualmente, el usuario final de Azure Communication Services solo puede recibir archivos adjuntos del usuario de Teams. Consulte Casos de uso de la biblioteca de interfaz de usuario para obtener más información.

Importante

La característica de uso compartido de archivos incluye el compuesto CallWithChat sin configuraciones adicionales.

Descarga de código

Acceda al código de este tutorial en GitHub.

Requisitos previos

Fondo

En primer lugar, es necesario reconocer que la interoperabilidad de chat de Teams tiene que formar parte de una reunión de Teams actualmente. Cuando el usuario de Teams crea una reunión en línea, se creará una conversación de chat y se asociará a la reunión. Para permitir que el usuario final de Azure Communication Services se una al chat y empiece a enviar o recibir mensajes, un participante de la reunión (un usuario de Teams) tendría que admitirlo primero en la llamada. De lo contrario, no tiene acceso al chat.

Una vez que el usuario final de Azure Communication Services se admita en la llamada, podrá empezar a chatear con otros participantes en la llamada. En este tutorial, veremos cómo funciona la imagen insertada en el chat de interoperabilidad.

Información general

De forma similar a cómo se agrega compatibilidad con imágenes insertadas a la biblioteca de interfaz de usuario, se necesita un compuesto CallWithChat creada. Vamos a seguir el ejemplo básico de la página del libro de historias para crear un compuesto ChatWithChat.

Desde el código de ejemplo, necesita CallWithChatExampleProps, que se define como el siguiente fragmento de código:

export type CallWithChatExampleProps = {
  // Props needed for the construction of the CallWithChatAdapter
  userId: CommunicationUserIdentifier;
  token: string;
  displayName: string;
  endpointUrl: string;
  locator: TeamsMeetingLinkLocator | TeamsMeetingIdLocator | CallAndChatLocator;

  // Props to customize the CallWithChatComposite experience
  fluentTheme?: PartialTheme | Theme;
  compositeOptions?: CallWithChatCompositeOptions;
  callInvitationURL?: string;
};

Para poder iniciar el chat compuesto para la reunión, es necesario pasar TeamsMeetingLinkLocator o TeamsMeetingIdLocator, que tiene este aspecto:

{ "meetingLink": "<TEAMS_MEETING_LINK>" }

Or

{ "meetingId": "<TEAMS_MEETING_ID>", "passcode": "<TEAMS_MEETING_PASSCODE>"}

No necesita ninguna otra configuración para permitir que el usuario final de Azure Communication Services reciba archivos adjuntos por parte del usuario de Teams.

Permisos

Cuando el archivo se comparte desde un cliente de Teams, el usuario de Teams tiene opciones para establecer los permisos de archivo para que sean:

  • "Cualquiera"
  • "Personas de la organización"
  • "Personas actualmente en este chat"
  • "Personas con acceso existente"
  • "Personas que elija"

En concreto, la biblioteca de interfaz de usuario actualmente solo admite "Cualquiera" y "Personas que elija" (con dirección de correo electrónico) y no se admiten todos los demás permisos. Si el usuario de Teams envió un archivo con permisos no admitidos, es posible que se dirija al usuario final de Azure Communication Services a una página de inicio de sesión o se le niegue el acceso al hacer clic en los archivos adjuntos en la conversación de chat.

Captura de pantalla de un cliente de Teams enumerando los permisos de archivos.

Además, el administrador de inquilinos del usuario de Teams puede imponer restricciones en el uso compartido de archivos, incluida la deshabilitación de algunos permisos de archivo o la desactivación total de la opción de compartir archivos.

Ejecución del código

Vamos a ejecutar npm run start y después debería poder acceder a nuestra aplicación de ejemplo a través de localhost:3000 como en la siguiente captura de pantalla:

Captura de pantalla de una biblioteca de interfaz de usuario de Azure Communication Services.

Simplemente haga clic en el botón de chat situado en la parte inferior para revelar el panel de chat y ahora, si el usuario de Teams envía algunos archivos, debería ver algo parecido a la siguiente captura de pantalla:

Captura de pantalla de un cliente de Teams enviando un archivo.

Captura de pantalla de la biblioteca de interfaz de usuario de Azure Communication Services recibiendo un archivo.

Y ahora si el usuario hace clic en la tarjeta de datos adjuntos de archivo, se abrirá una nueva pestaña como la siguiente, donde el usuario puede descargar el archivo:

Captura de pantalla de la página web de Sharepoint que muestra el contenido del archivo.

Pasos siguientes

Comprobación del resto de la biblioteca de interfaz de usuario

Puede que también le interese: