Enviar notificaciones de la fuente de actividades a los usuarios en Microsoft Teams

La fuente de actividades de Microsoft Teams permite a los usuarios clasificar los elementos que requieren atención notificándoles los cambios. Puede usar las API de notificación de fuente de actividades en Microsoft Graph para ampliar esta funcionalidad a sus aplicaciones. Esto permite que las aplicaciones proporcionen experiencias más ricas y atraigan mejor a los usuarios, ya que les ayuda a mantenerse al día con los cambios en las herramientas y los flujos de trabajo que usan.

Casos de uso de notificaciones de fuentes de actividades

  • Noticias: ayuda a los usuarios a mantenerse actualizados con la información más reciente, como nuevas tareas o nuevas publicaciones.
  • Colaboración: cuando compartes un archivo o @mencionas a un usuario en un comentario, los usuarios pueden ver una vista previa del texto en el banner de notificación.
  • Recordatorios: una notificación para informarle sobre un evento o una tarea. Por ejemplo, hoy tiene una fecha de vencimiento para el aprendizaje y la aplicación le envía una notificación de recordatorio para ayudarle a recordar la tarea o el evento.
  • Alertas: Notificaciones, que requieren atención urgente o inmediata. Por ejemplo, ha pasado la fecha de vencimiento de un aprendizaje o un administrador ha enviado una solicitud para corregir un error con la prioridad más alta.

Ventajas de las notificaciones del panel de actividades

  • La notificación de la fuente de actividades es una integración nativa de Teams que lleva al usuario sin problemas a la aplicación de pestañas, lo que aporta una interacción adicional del usuario de Actividad a su aplicación.
  • La notificación de fuente de actividades viene con una notificación del sistema operativo en los clientes móviles y de escritorio de Teams, para que la atención del usuario se capte del elemento emergente y el sonido del sistema.
  • El contenido de la notificación es altamente personalizable, lo que permite a los usuarios obtener una vista previa del resumen de los eventos notificados.
  • Puede vincular profundamente la aplicación a una notificación para que, cuando un usuario seleccione la notificación, aumente la interacción del usuario con la aplicación.
  • Puede enviar notificaciones de la fuente de actividades a varios destinatarios. Por ejemplo, enviar una notificación personal o enviar notificaciones por lotes a un grupo de usuarios.
  • La localización de manifiestos de aplicación (anteriormente denominados manifiesto de la aplicación de Teams) admite el texto con plantilla en las notificaciones del panel de actividades.

Comprender los conceptos básicos de las notificaciones del panel de actividades

En Teams, las notificaciones de la fuente de actividades constan de varios bits de información que se muestran juntos, como se muestra en la siguiente imagen:

Captura de pantalla que muestra los componentes de una notificación de fuente de actividades.

Entre estos componentes se incluyen:

Contador Descripción
1 Avatar: muestra quién inició la actividad.
2 Tipo de actividad o icono de aplicación: el tipo de actividad o el icono de aplicación representa el tipo de actividad. Para las notificaciones de aplicaciones, el icono de línea se reemplaza por un icono de aplicación.
3 Título: actor + motivo: actor: nombre del usuario o aplicación que inició la actividad. Motivo: describe la actividad.
4 Marca de tiempo: muestra cuándo se produjo la actividad.
5 Vista previa del texto: Muestra una línea truncada desde el inicio de la notificación.
6 Ubicación: muestra dónde se produjo la actividad en Teams.

En el ejemplo siguiente se muestra que los componentes proporcionan conjuntamente los detalles sobre una notificación.

La captura de pantalla muestra el ejemplo de notificación.

Tipos de tarjetas de notificación de fuentes de actividades

En las variantes siguientes se muestran los tipos de tarjetas de notificación de la fuente de actividades que puede mostrar. El logotipo de la aplicación reemplaza el avatar del usuario para las notificaciones generadas por la aplicación:

Captura de pantalla que muestra las notificaciones de la fuente de actividades en un escritorio.

Contador Descripción
1 Teams personalizado
2 Windows
3 Mac

Requisitos para usar las API de notificación de la fuente de actividades

Las API de fuente de actividades funcionan con una aplicación de Teams. A continuación se indican los requisitos para enviar notificaciones de la fuente de actividades:

  • El manifiesto de la aplicación debe tener el id. de aplicación de Microsoft Entra agregado a la webApplicationInfo sección. Para obtener más información, consulte esquema de manifiesto de aplicación.
  • Las notificaciones de actividad se pueden enviar con o sin tipos de actividad agregados en el manifiesto de la aplicación.
  • La aplicación de Teams debe instalarse para el destinatario, ya sea personalmente, o en un equipo o chat del que forme parte.

Permissions

Use permisos delegados o de aplicación para enviar notificaciones de fuente de actividades. Al usar permisos de aplicación, se recomienda usar el consentimiento específico de recursos (RSC), ya que el usuario acepta el TeamsActivity.Send.User permiso para enviar notificaciones de actividad. Asegúrese de agregar los permisos RSC en el archivo de manifiesto de la aplicación.

Actualización del manifiesto de la aplicación

En esta sección se describen las actualizaciones que deben agregarse al manifiesto de la aplicación. Asegúrese de usar la versión 1.7 del manifiesto de la aplicación o posterior.

"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.7/MicrosoftTeams.schema.json",
"manifestVersion": "1.7",

Actualización de webApplicationInfo

"webApplicationInfo":
{
    "id": "a3111f15-658e-457c-9689-fd20fe907330",
    "resource": "https://contosoapp.com"
}
Parámetro Tipo Descripción
id string Id. de aplicación de Microsoft Entra (id. de cliente).
resource string Recurso asociado a la aplicación Microsoft Entra. También conocido como dirección URL de respuesta o redireccionamiento en el Portal de Microsoft Azure.

Nota:

Es posible que obtenga un error si varias aplicaciones de Teams en el mismo ámbito (equipo, chat o usuario) usan la misma aplicación de Microsoft Entra. Asegúrese de que usa aplicaciones únicas de Microsoft Entra.

Actualización de actividades

"activities":
{
  "activityTypes": [
    {
      "type": "taskCreated",
      "description": "Task Created Activity",
      "templateText": "{actor} created task {taskId} for you"
    },
    {
      "type": "approvalRequired",
      "description": "Deployment requires your approval",
      "templateText": "{actor} created a new deployment {deploymentId}"
    }
  ]
}
Parámetro Tipo Descripción
tipo string Tipo de actividad. Debe ser único en un manifiesto de aplicación específico.
description string Breve descripción legible por humanos. Esto es visible en el cliente de Teams.
templateText string Texto de plantilla para la notificación de actividad. Puede agregar los parámetros encapsulándolos en {}formato

Nota:

  • Es actor un parámetro especial que siempre toma el nombre de la persona que llama. En las llamadas delegadas, actor es el nombre del usuario. En las llamadas de solo aplicación, toma el nombre de la aplicación de Teams.
  • El tipo de actividad reservada systemDefault no debe incluirse en la sección del manifiesto de la activities aplicación. El systemDefault tipo de actividad permite proporcionar texto de formato libre en la Actor+Reason línea de la notificación del panel de actividades.

Actualización de autorización

"authorization": 
{ 
  "permissions": { 
    "resourceSpecific": [ 
      {
        "type": "Application", 
         "name": "TeamsActivity.Send.User" 
      }, 
      { 
        "type": "Application",
        "name": "TeamsActivity.Send.Group"
      }, 
      { 
        "type": "Application", 
        "name": "TeamsActivity.Send.Chat" 
      } 
    ] 
  }
}
Parámetro Tipo Descripción
tipo string El tipo de permiso RSC.
name string El nombre del permiso RSC. Para obtener más información, consulte Permisos RSC admitidos.

Instalar la aplicación de Teams

Las aplicaciones de Teams deben estar instaladas en un equipo, chat o para un usuario en el ámbito personal para que los usuarios reciban notificaciones del panel de actividades. Para obtener más información, consulte Métodos de distribución de aplicaciones de Teams. Para fines de desarrollo, preferimos la carga personalizada de aplicaciones. Después del desarrollo, puede elegir el método de distribución adecuado en función de si desea publicar en un inquilino o en todos los inquilinos.

También puede usar las API de instalación de aplicaciones de Teams para administrar las instalaciones de aplicaciones de Teams.

Enviar notificaciones del feed de actividades a los usuarios

Dado que una aplicación de Teams se puede instalar para un usuario, en un equipo o en un chat, también puede enviar notificaciones en los tres contextos siguientes:

Además, puede enviar notificaciones de forma masiva a un máximo de 100 usuarios a la vez:

Para obtener información detallada sobre los temas admitidos para cada escenario, consulte las API específicas. Se admiten temas basados en texto personalizado para todos los escenarios.

Puedes usar la notificación de la fuente de actividades en los siguientes escenarios:

  • Notifique a las personas sobre el contenido personalizado que requiere su atención.
  • Mostrar contenido enriquecido en la aplicación Tab o la dirección URL.
  • Admite interacciones de usuario complejas.
  • Enviar notificaciones delegadas del usuario que inició la notificación.
  • Ponga una plantilla en el manifiesto de la aplicación.
  • Teams se encarga de la localización de las notificaciones.

Nota:

El icono de actividad se basa en el contexto en el que se realiza la solicitud. Si la solicitud se realiza con permisos delegados, la foto del usuario aparece como avatar, mientras que el icono de la aplicación Teams aparece como icono de actividad. En un contexto de solo aplicación, el icono de la aplicación Teams se usa como avatar y se omite el icono de actividad.

Personalizar las notificaciones

Los usuarios de Teams pueden personalizar las notificaciones que ven en su fuente o como un banner. Las notificaciones generadas a través de las API de la fuente de actividades también se pueden personalizar. Los usuarios pueden elegir cómo se les notifica a través de la configuración de Teams. Las aplicaciones de Teams aparecen en la lista para que el usuario elija una, como se muestra en la siguiente captura de pantalla:

Captura de pantalla que muestra la configuración de Notificaciones en Teams, con la opción Personalizado resaltada.

Los usuarios pueden seleccionar Editar , junto a una aplicación, y personalizar las notificaciones. El manifiesto de la aplicación muestra el description campo.

La captura de pantalla muestra notificaciones personalizadas para Banner y fuente para una aplicación de Teams.

Ejemplos

Para obtener ejemplos sobre cómo enviar una notificación de fuente de actividades, consulta Ejemplos de envío de notificaciones de fuente de actividades.

Tipo de actividad reservada para enviar notificaciones del panel de actividades

  • El systemDefault tipo de actividad está reservado y no se puede usar en el manifiesto de la aplicación mientras se agregan actividades.
  • Se recomienda usar notificaciones con plantillas, ya que dependen de las plantillas de actividad del manifiesto de la aplicación para lotes grandes y periódicos de notificaciones.
  • El systemDefault tipo de actividad reservada está disponible incluso si los otros tipos de actividad se enumeran en el manifiesto de la aplicación.

Las siguientes son las ventajas y limitaciones para el tipo de systemDefault actividad:

Ventajas Limitaciones
Puede probar nuevos escenarios y probar las API de notificación de fuente de actividades sin agregar tipos de actividad al manifiesto de la aplicación.

Con las aplicaciones de la Tienda Teams, el tipo de systemDefault actividad simplifica el proceso y ahorra tiempo, ya que elimina la necesidad de realizar ajustes constantes en los tipos de actividad en el manifiesto de la aplicación. El systemDefault tipo de actividad está listo para usarse inmediatamente.		 No puede usar las características de localización integradas proporcionadas por el manifiesto de la aplicación.

No puede confiar en el envío de notificaciones personalizables con el tipo de systemDefault actividad. Los usuarios pueden desactivar todas las notificaciones de la aplicación con un botón de alternancia en la configuración del cliente de Teams, lo que puede dificultar la comunicación entre la aplicación y sus usuarios.

Ejemplo de código

Ejemplo de nombre Descripción .NET Node.js
Envío de notificaciones de fuente de actividad Aplicación de ejemplo que muestra cómo enviar notificaciones de fuente de actividades mediante la API de Microsoft Graph API. View View

Guía paso a paso

Siga la guía paso a paso para enviar notificaciones de fuente de actividades en Teams.

Vea también

  • Se actualizó por última vez el