Criar e enviar uma notificação do serviço de aplicativoCreate and send a notification from your app service

Você pode criar e enviar uma notificação para um usuário com as APIs do Microsoft Graph.You can create and send a notification to a user by using Microsoft Graph APIs. As notificações são armazenadas no repositório do serviço de Notificações do Microsoft Graph e enviadas a todos os clientes de aplicativos, em todos os dispositivos em que o usuário de destino está conectado.The notification is stored in the Microsoft Graph Notifications service store and is sent to all app clients on all devices that the target user is signed in on.

Para enviar uma notificação para o usuário, seu serviço de aplicativo precisará:In order to send a notification to your user, your application service will:

  1. Autenticar com a plataforma de identidade da Microsoft.Authenticate with the Microsoft identity platform.
  2. Publique uma notificação para a API do Microsoft Graph usando o token de autenticação e direcione o usuário com uma ID de assinatura de notificação de usuário que é obtida do seu cliente de aplicativo ao criar uma assinatura.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.

Observação

Para uma história de autenticação simplificada, recomendamos usar o novo e aprimorado SDK de notificação do lado do cliente com uma ID de assinatura de notificação de usuário para receber notificações e gerenciar o estado de notificação.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. Como alternativa, você pode publicar notificações em nome do usuário por meio de permissões delegadas e seu serviço de aplicativo precisará manter tokens de acesso e de atualização, mas isso não é recomendável.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. Para saber mais sobre o fluxo OAuth 2.0 OBO, confira Chamadas de serviço a serviço que usam a identidade do usuário delegado no fluxo 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.

Entrega garantida no iOSGuaranteed delivery on iOS

Em plataformas como o iOS, em certas condições energéticas, a entrega de notificações de dados brutos pode atrasar devido ao processamento em lotes ou pode nem chegar ao ponto de extremidade.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. Para notificações com alta prioridade entregues a usuários no iOS, a plataforma de notificações do Microsoft Graph permite especificar uma opção de "fallback" de notificação do sistema "raw-to-visual" que envia automaticamente uma notificação do sistema visual para o dispositivo iOS de destino, garantindo que os usuários sejam notificados praticamente em tempo real.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. Para saber como aproveitar as opções de fallback, confira o recurso de notificação.To learn how to leverage fallback options, please see the notification resource.

IntroduçãoGetting started

Para saber como o seu serviço de aplicativo pode começar a enviar notificações aos seus usuários, confira notificação e o nosso Exemplo do serviço de aplicativo.To learn how your app service can start sending notifications to your users, see notification and our App Service sample.