Enviar notificación de fuente de actividad
La notificación de fuente de actividad de Microsoft Teams ayuda a los usuarios a evaluar los elementos que requieren atención mediante la notificación de los cambios. Para ampliar la funcionalidad de notificación de fuente de actividad a la aplicación, use las API de notificación de fuente de actividad de Microsoft Graph.
Las características clave de la difusión de fuente de actividad son:
- Proporciona una experiencia mejorada.
- Mantiene actualizados a los usuarios.
- Difunde el mensaje para todos los miembros.
- Muestra la notificación de fuente de actividad.
- Difunde los detalles disponibles para los miembros.
Esta guía paso a paso le ayuda a difundir mensajes y notificar a todos los miembros de una organización mediante la notificación de fuente de actividad. Puede ver la siguiente salida:
Requisitos previos
Asegúrese de instalar las siguientes herramientas y configurar el entorno de desarrollo:
| Instalar | Para usar... | |
|---|---|---|
| Visual Studio 2022 | Puede instalar la versión empresarial en Visual Studio 2022 e instalar las cargas de trabajo ASP.NET y desarrollo web. Use la versión más reciente. | |
| SDK de .NET Core versión 3.1 | Enlaces personalizados para la depuración local y las implementaciones de aplicaciones de Azure Functions. Use la versión más reciente o instale la versión portátil. | |
| Túnel de desarrollo | Las características de aplicaciones de Teams (bots conversacionales, extensiones de mensajes y webhooks entrantes) necesitan conexiones entrantes. Un túnel conecta el sistema de desarrollo a Teams. Dev tunnel es una herramienta eficaz para abrir de forma segura tu host local a Internet y controlar quién tiene acceso. El túnel de desarrollo está disponible en Visual Studio 2022, versión 17.7.0 o posterior. También puede usar ngrok como túnel para conectar el sistema de desarrollo a Teams. No es necesario para las aplicaciones que solo incluyen pestañas. Este paquete se instala en el directorio del proyecto (mediante npm devDependencies). |
Nota:
Después de descargar ngrok, regístrese e instale authtoken.
Asegúrese de que tiene las cuentas siguientes y configure el entorno de desarrollo:
- Cuenta de Microsoft .
- La aplicación teams debe estar instalada para el destinatario, ya sea personalmente, o en un equipo o chat.
- El identificador de inquilino para enviar y recibir notificaciones debe coincidir.
Configuración del inquilino de desarrollo de Teams
Un inquilino es como un espacio o un contenedor donde chatea, comparte archivos y ejecuta reuniones para su organización en Teams. También puede cargar y probar la aplicación personalizada.
Comprobación de la opción de carga de aplicaciones personalizadas
Después de crear la aplicación, debe cargarla en Teams sin distribuirla. La función se conoce como carga de aplicaciones personalizada. Inicie sesión en su cuenta de Microsoft 365 para ver esta opción.
Nota:
La carga de aplicaciones personalizada es necesaria para obtener una vista previa y probar aplicaciones en el entorno local de Teams. Habilite la carga de aplicaciones personalizadas para obtener una vista previa y probar la aplicación en Teams localmente.
¿Ya tiene un inquilino y tiene acceso de administrador? ¡Vamos a comprobar si realmente lo haces!
Para comprobar las aplicaciones de carga personalizadas en Teams:
En el cliente de Teams, seleccione el icono Aplicaciones .
Seleccione Administrar las aplicaciones.
Seleccione Cargar una aplicación.
Busque la opción Cargar una aplicación personalizada.
Nota:
Póngase en contacto con el administrador de Teams si no puede cargar una aplicación personalizada.
Creación de un inquilino para desarrolladores de Teams gratuito (opcional)
Si no tiene una cuenta de desarrollador de Teams, puede obtenerla de forma gratuita. ¡Únete al programa para desarrolladores de Microsoft 365!
Seleccione Unirse ahora y siga las instrucciones en pantalla.
Seleccione Set-up E5 subscription (Configurar suscripción A5 ) en la pantalla de bienvenida.
Configure una cuenta de administrador. Una vez finalizada, se muestra la pantalla siguiente.
Inicie sesión en Teams con la nueva cuenta de administrador. Ahora puede seleccionar Cargar una aplicación personalizada.
Configuración del entorno local
Abra Microsoft-Teams-Samples.
Seleccione Código.
En el menú desplegable, seleccione Abrir con GitHub Desktop.
Seleccione Clonar.
Registro del inicio de sesión único de Teams Auth con Microsoft Entra ID
Los pasos siguientes le ayudan a crear y registrar el inicio de sesión único de autenticación de Teams en Azure Portal:
- Cree y registre una nueva aplicación en Registros de aplicaciones.
- Use ngrok para crear un túnel a los puntos de conexión del servidor web.
Agregar registro de aplicación
Acceda a Portal Azure.
Seleccione Registros de aplicaciones.
Seleccione + Nuevo registro.
Escriba el nombre de la aplicación.
Seleccione Cuentas en cualquier directorio organizativo (cualquier inquilino de Microsoft Entra ID: multiinquilino).
Seleccione Registrar.
La aplicación está registrada en Microsoft Entra ID. Aparece la página de información general de la aplicación.
Nota:
Guarde el identificador de la aplicación desde el identificador de aplicación (cliente) y el identificador de directorio (inquilino) para su uso posterior.
Creación de un túnel
Abra Visual Studio.
Seleccione Crear un nuevo proyecto.
En el cuadro de búsqueda, escriba ASP.NET. En los resultados de la búsqueda, seleccione ASP.NET Core Web App.
Seleccione Siguiente.
Escriba Nombre del proyecto y seleccione Siguiente.
Seleccione Crear.
Aparece una ventana de información general.
En la lista desplegable de depuración, seleccione Túneles de desarrollo (sin túnel activo)>Crear un túnel....
Aparecerá una ventana emergente.
Actualice los detalles siguientes en la ventana emergente:
- Cuenta: escriba una cuenta de Microsoft o GitHub.
- Nombre: escriba un nombre para el túnel.
- Tipo de túnel: en la lista desplegable, seleccione Temporal.
- Acceso: en la lista desplegable, seleccione Público.
Seleccione Aceptar.
Aparece una ventana emergente que muestra que el túnel de desarrollo se ha creado correctamente.
Seleccione Aceptar.
Puede encontrar el túnel que ha creado en la lista desplegable de depuración de la siguiente manera:
Seleccione F5 para ejecutar la aplicación en el modo de depuración.
Si aparece un cuadro de diálogo Advertencia de seguridad , seleccione Sí.
Aparecerá una ventana emergente.
Seleccione Continuar.
La página principal del túnel de desarrollo se abre en una nueva ventana del explorador y el túnel de desarrollo ya está activo.
Vaya a Visual Studio y seleccione Ver > salida.
En el menú desplegable Consola de salida , seleccione Túneles de desarrollo.
La consola de salida muestra la dirección URL del túnel de desarrollo.
Agregar uri de identificador de aplicación
En el panel izquierdo, en Administrar, seleccione Exponer una API.
Junto a URI de id. de aplicación, seleccione Agregar.
Actualice el URI del identificador de aplicación en el
api://your-devtunnel-domain/botid-{AppID}formato oapi://your-ngrok-domain/botid-{AppID}y seleccione Guardar.
En la imagen siguiente se muestra el nombre de dominio:
Nota:
Si usa un servicio de tunelización como ngrok, asegúrese de actualizar el valor cada vez que se actualice el subdominio ngrok. Por ejemplo, api://f631****.ngrok.io/c4e88a5d-e3d4-47f4-accb-0ef9de3bce8a, donde f631****.ngrok.io es el nuevo nombre del subdominio ngrok.
Agregar un ámbito
En el panel izquierdo, en Administrar, seleccione Exponer una API.
Seleccione + Agregar un ámbito.
Escriba access_as_user como nombre del ámbito.
En ¿Quién puede dar su consentimiento?, seleccione Administradores y usuarios.
Actualice los valores del resto de los campos de la siguiente manera:
Escriba Teams para acceder al perfil del usuario como nombre para mostrar del consentimiento del administrador.
Entrar Permite a Teams llamar a las API web de la aplicación como el usuario actual como descripción del consentimiento del administrador.
Escriba Teams para acceder al perfil de usuario y realizar solicitudes en nombre del usuario como nombre para mostrar del consentimiento del usuario.
Escriba Habilitar Teams para llamar a las API de esta aplicación con los mismos derechos que el usuario que ladescripción del consentimiento del usuario.
Asegúrese de que Estado se establece en Habilitado.
Seleccione Agregar ámbito.
En la imagen siguiente se muestran los campos y los valores:
Nota:
El nombre del ámbito debe coincidir con el URI del identificador de aplicación con
/access_as_useranexado al final.
Agregar aplicación cliente
En el panel izquierdo, en Administrar, seleccione Exponer una API.
En Aplicaciones cliente autorizadas, identifique las aplicaciones que desea autorizar para la aplicación web de la aplicación.
Seleccione + Agregar una aplicación cliente.
Agregue aplicaciones web de Teams para dispositivos móviles o de escritorio y Teams.
Para equipos móviles o de escritorio de Teams: escriba el identificador de cliente como
1fec8e78-bce4-4aaf-ab1b-5451cc387264.
En Web de Teams: escriba el identificador de cliente como
5e3ce6c0-2b1f-4285-8d4b-75ee78787346.
Active la casilla Ámbitos autorizados .
Seleccione Agregar aplicación.
En la imagen siguiente se muestra el identificador de cliente:
Agregar permiso de API
En el panel izquierdo, en Administrar, seleccione Permisos de API.
Seleccione + Agregar un permiso.
Seleccione Microsoft Graph.
Seleccione Permisos delegados
Seleccione los permisos siguientes:
Directory.Read.All
Directory.ReadWrite.All
TeamsActivity.Send
TeamsAppInstallation.ReadForUser
TeamsAppInstallation.ReadWriteForUser
User.Read
Nota:
Usuario. La lectura está habilitada de forma predeterminada.
Seleccione Agregar permisos.
Seleccione + Agregar un permiso.
Seleccione Microsoft Graph.
Seleccione Permisos de aplicación.
Seleccione los permisos siguientes:
- Directory.Read.All
- TeamsActivity.Send
- TeamsAppInstallation.ReadForUser.All
Seleccione Agregar permisos.
Asegúrese de conceder el consentimiento del administrador para los permisos necesarios.
Asegúrese de conceder el consentimiento del administrador para los permisos necesarios.
Nota:
- Si a una aplicación no se le concede el consentimiento del administrador de TI, los usuarios deben proporcionar su consentimiento la primera vez que usen una aplicación.
- Los usuarios solo deben dar su consentimiento a los permisos de API si la aplicación Microsoft Entra está registrada en un inquilino diferente.
Adición de una autenticación web
En el panel izquierdo, en Administrar, seleccione Autenticación.
Seleccione Agregar unaaplicación de página única de plataforma>.
Escriba el URI de redireccionamiento de la aplicación anexando
auth-endal nombre de dominio completo. Por ejemplo,https://your-devtunnel-domain/auth-endohttps://your-ngrok-domain/auth-end.En Flujos híbridos y de concesión implícita, seleccione las casillas Tokens de acceso y tokens de identificador .
Seleccione Configurar.
En Web, seleccione Agregar URI.
Escriba
https://token.botframework.com/.auth/web/redirect.Haga clic en Guardar.
Creación de un secreto de cliente
En el panel izquierdo, en Administrar, seleccione Certificados & secretos.
En Secretos de cliente, seleccione + Nuevo secreto de cliente.
Aparece la ventana Agregar un secreto de cliente .
Escriba Descripción.
Seleccione Agregar.
En Valor, seleccione Copiar en el Portapapeles para guardar el valor del secreto de cliente para su uso posterior.
Configuración de la aplicación
Vaya a appsettings.json archivo en el repositorio clonado.
Abra el archivo appsettings.json en la versión más reciente de Visual Studio y actualice la siguiente información:
Establezca en
"MicrosoftAppId"el identificador de aplicación de Microsoft del bot.Establezca en
"TenantID"Id. de directorio (inquilino).Establezca en
"MicrosoftAppPassword"el valor de id. de secreto de cliente del bot.Establezca en
"BaseUrl".[WebAppDomainName]
Configuración del archivo de manifiesto
Vaya al archivo manifest.json en el repositorio clonado.
Abra el archivo manifest.json en la versión más reciente de Visual Studio y realice los siguientes cambios:
Reemplace todas las repeticiones de
<<Microsoft-App-ID>>por el identificador de aplicación de Microsoft del bot.Reemplace todas las repeticiones de por el nombre de
<<Base_URL>>dominio completo.Establezca en
validDomains[WebAppDomainName].
Compilación y ejecución del servicio
Abra Visual Studio.
Vaya a Archivo>Abrir>proyecto o solución....
Seleccione el archivo ActivityFeedBroadcast.sln de la carpeta csharp .
Seleccione Abrir.
Pulse F5 para ejecutar el proyecto.
Seleccione Sí si aparece el siguiente cuadro de diálogo:
Se abre una página web con un mensaje: ¡El bot está listo!
Adición de una aplicación de difusión de fuente de actividad a Teams
En el repositorio clonado, vaya a graph-activity-feed-broadcast>csharp>ActivityFeedBroadcast>AppManifest.
Cree un archivo .zip con los siguientes archivos presentes en la carpeta AppManifest :
manifest.json
outline.png
color.png
En el cliente de Teams, seleccione el icono Aplicaciones .
Seleccione Administrar las aplicaciones.
Seleccione Enviar una aplicación a su organización.
Seleccione Abrir para cargar el archivo .zip que creó en la carpeta AppManifest .
Seleccione Agregar.
Interacción con la aplicación en Teams
Vamos a interactuar con la aplicación en Teams.
BroadcastTab muestra el título del mensaje y la descripción del mensaje.
Escriba el título y la descripción del mensaje**.
Seleccione Enviar mensaje.
Aparece el mensaje que se difunde correctamente.
La notificación de fuente de actividad se muestra en la pestaña Actividad del destinatario con el mismo identificador de inquilino.
Los detalles del mensaje aparecen al seleccionar el mensaje.
Desafío completo
¿Se te ocurrió algo como esto?
¡Enhorabuena!
Ha completado el tutorial para empezar a trabajar con la aplicación de difusión de fuente de actividad .
¿Tiene algún problema con esta sección? Si es así, envíenos sus comentarios para que podamos mejorarla.