Créer et envoyer une notification à partir de votre service d’applicationCreate and send a notification from your app service

Vous pouvez créer et une notification et l’envoyer à un utilisateur à l’aide d’API Microsoft Graph.You can create and send a notification to a user by using Microsoft Graph APIs. La notification est stockée dans le magasin du service Microsoft Graph Notifications et envoyée à tous les clients de l’application sur tous les appareils auxquels l’utilisateur cible est connecté.The notification is stored in the activity feed store and is sent to all app clients on all devices that the target user is signed in on.

Pour envoyer une notification à votre utilisateur, votre service d’application va :In order to send a notification to your user, your application service will:

  1. S’authentifier auprès de la Plateforme d’identités Microsoft.Authenticate with the Microsoft identity platform.
  2. Publier une notification sur l’API Microsoft Graph en utilisant le jeton d’authentification et cibler l’utilisateur avec un ID d’abonnement de notification utilisateur obtenu auprès de votre client d’application lors de la création d’un abonnement.Post a notification to the Microsoft Graph API using the auth token, and target the user with a user notification subscription ID that is obtained from your app client when creating a subscription.

Notes

Pour une authentification simplifiée, nous vous recommandons d’utiliser le nouveau kit SDK sur les notifications, léger et amélioré, côté client avec un ID d’abonnement de notification utilisateur pour recevoir des notifications et gérer leur état.For a simplified authentication story, we recommend using the new and improved, lightweight notification SDK on the client-side with a user notification subscription ID to receive notifications and manage notification state. Vous pouvez aussi publier des notifications pour le compte de l’utilisateur via des autorisations déléguées. Votre service d’application devra conserver les jetons d’accès et les actualiser, mais ce n’est pas recommandé.Alternatively, you can post notifications on behalf of the user via delegated permissions and your app service will need to maintain access tokens and refresh tokens, but this is not recommended. Pour en savoir plus sur le flux OBO d’OAuth 2.0, voir Appels de service à service utilisant l’identité utilisateur déléguée dans le flux On-Behalf-Of.To learn more about OAuth 2.0 OBO flow, see Service-to-service calls that use delegated user identity in the On-Behalf-Of flow.

Remise garantie sur iOSGuaranteed delivery on iOS

Sur les plateformes comme iOS, sous certaines conditions d’alimentation, les notifications de données brutes risquent d’être retardées à cause du traitement par lots, ou même de ne pas atteindre du tout le point de terminaison cible.On platforms like iOS, under certain power conditions, raw data notifications might be delayed in delivery due to batching, or not reach the target endpoint at all. Pour que les notifications haute priorité soient remises aux utilisateurs sur iOS, la plateforme de notifications Microsoft Graph vous permet de spécifier une option « de secours » de notification toast brute-à-visuelle qui envoie automatiquement une notification toast visuelle à l’appareil iOS cible, afin de garantir que vos utilisateurs soient notifiés en quasi-temps réel.For high-priority notifications being delivered to users on iOS, the Microsoft Graph notifications platform allows you to specify a raw-to-visual toast notification "fallback" option that automatically sends a visual toast notification to the target iOS device, thereby ensuring your user gets notified near real-time. Pour savoir comment bénéficier des options de secours, voir la ressource de notification.To learn how to leverage fallback options, please see the notification resource.

Prise en mainGetting started

Pour savoir comment votre service d’application peut commencer à envoyer des notifications à vos utilisateurs, voir notification et notre exemple de service d’application.To learn how your app service can start sending notifications to your users, see notification and our App Service sample.