Procedimientos recomendados para usar Microsoft Teams de fuentes de actividad

En este artículo se tratan los procedimientos recomendados para usar Microsoft Teams de fuentes de actividad en Microsoft Graph. Estos procedimientos recomendados se aplican a:

  • Creación de notificaciones de llamada a la acción
  • Solicitar respuestas a notificaciones
  • Creación de notificaciones sobre eventos externos

En la siguiente imagen se muestra un ejemplo de una notificación de fuente de actividad en Teams:

Captura de pantalla de una Teams que muestra la vista de notificación de fuente de actividad.

Al implementar notificaciones de fuentes de actividad, tenga en cuenta los siguientes puntos:

  • Las notificaciones del sistema redirigen a los usuarios a la fuente de actividad, no a la aplicación. Para ver otra actividad, los usuarios deben seleccionar la notificación asociada en la fuente de actividades.
  • Los usuarios solo pueden administrar la configuración de notificaciones después de que la aplicación seleccionada envíe una notificación.
  • El icono de cada notificación se incluye en el manifiesto de la aplicación. Microsoft Graph no admite la personalización del icono.
  • No se admiten las notificaciones de prioridad.

Mejorar la experiencia de notificación

Microsoft Teams notificaciones en formatos de fuente de actividad y notificaciones del sistema. Los usuarios reciben notificaciones de varios orígenes en chats, canales, reuniones u otras aplicaciones. Para mejorar la experiencia del usuario, aplique las siguientes recomendaciones:

  • Localice el contenido en una notificación del sistema o fuente. La localización solo se produce si el contenido de la aplicación está localizado.
  • Proporcione títulos y descripciones adecuados para los tipos de actividad. Use títulos cortos, como @mention y Anuncios. Evite títulos largos, como Actividad de usuario mencionada y Actividad posterior a la creación.
  • Las notificaciones deben transmitir información importante que sea relevante para el usuario. Por ejemplo, Diego le asignó un vale de ventas es un mensaje relevante; Joni abandonó el equipo de ventas.
  • Evita enviar notificaciones de naturaleza promocional, como Probar la nueva característica en la aplicación De ciclo.
  • Evite las notificaciones duplicadas de mensajes de bot y notificaciones de fuente de actividad. Para obtener más información, vea notificaciones de fuentes de actividad o mensajes de marco de bots.
  • Use la sección de vista previa de texto en las notificaciones. Proporcione información para ayudar al usuario a determinar la importancia de la notificación y tomar medidas, si es necesario.
  • No agregue un punto al final del título de notificación, para que sea coherente con todas las demás configuraciones de notificación de Teams.
  • Haga que la relación entre la notificación y su contenido sea clara para el usuario. Por ejemplo, cuando un usuario recibe una notificación para aprobar una licencia, la notificación debe redirigirla a la sección correspondiente de la aplicación. Si la notificación pertenece a la eliminación o eliminación de entidades, como usuarios y tareas, dirija al destinatario al contenido e indique la acción necesaria.
  • Asegúrese de que la experiencia de fuente es independiente. Por ejemplo, cualquier ventana emergente y modal debe permanecer en la aplicación.
  • Comprueba que la aplicación no envía más de 10 notificaciones por minuto, por usuario. Las notificaciones se limitarán automáticamente si el recuento supera los 10.
  • Asegúrate de que el tiempo de carga de la aplicación no afecte negativamente a la experiencia de los usuarios cuando cambien entre notificaciones en la fuente.
  • Informe al usuario sobre el período de almacenamiento de notificaciones en la fuente de actividades. En Microsoft Teams, el período de almacenamiento es de 30 días.

    Nota

    El límite de almacenamiento de 30 días se aplica a todas las notificaciones. No es específico de las notificaciones enviadas a través de la API de notificaciones de fuente de actividades.

Notificaciones de fuente de actividad o mensajes de marco de bots

Puede usar notificaciones de fuentes de actividad o mensajes de marco de bots, pero no usar ambos tipos de notificaciones. En las secciones siguientes se describen los tipos de notificación y cuándo se debe usar cada uno.

Notificaciones de fuente de actividades

Las notificaciones de fuente de actividad aparecen en la Teams de actividad y pueden incluir vínculos a varias ubicaciones. Estas notificaciones:

  • Permitir que el usuario tome medidas o triage la notificación.
  • Dirige al usuario a una pestaña en un chat o canal, una aplicación personal o un mensaje de chat o canal.

La API de notificaciones de fuentes de actividad permite a los usuarios configurar notificaciones para cada tipo de notificación desde la configuración de notificación.

Si usas notificaciones de fuente de actividad, ten en cuenta que la aplicación puede enviar notificaciones dobles, si envía notificaciones de bots a chats o canales y también a la fuente de actividades. Solo envía notificaciones dobles si el escenario lo requiere.

Use notificaciones delegadas para crear una mejor experiencia de notificación. La API de notificación de fuente de actividades puede enviar llamadas delegadas o de solo aplicación. En las llamadas delegadas, el remitente de la notificación aparece como el usuario que inició la notificación y, en las llamadas de solo aplicación, el remitente aparece como la aplicación.

Puede actualizar una notificación de fuente de actividad existente en lugar de crear una nueva notificación mediante el parámetro chainId.

Mensajes de marco de bot

Los mensajes de bot se entregan como mensajes de chat o de canal. Si el usuario activa las notificaciones de chat o canal, las notificaciones que se desencadenan se envían como mensajes de chat o canal. Para enviar mensajes de *bot, @mention* el nombre del usuario para que la notificación aparezca en la fuente de actividades.

Es útil para que la alerta se consuma como un mensaje de chat o canal; por ejemplo, un mensaje que consumen todos los miembros del canal.