Criar e enviar uma notificação do seu serviço de aplicativo (preterido)

Importante

A API de notificações do Microsoft Graph foi preterida e parou de retornar dados em janeiro de 2022. Para uma experiência de notificação alternativa, confira os Hubs de Notificações do Microsoft Azure. Para obter mais informações, consulte a postagem no blog Desativando a API de notificações do Microsoft Graph (beta).

Você pode criar e enviar uma notificação para um usuário com as APIs do Microsoft Graph. 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.

Para enviar uma notificação para o usuário, seu serviço de aplicativo precisará:

1. Autenticar com a plataforma de identidade da Microsoft.
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.

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. Como alternativa, você pode postar 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 atualizar tokens, mas isso não é recomendado. 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.

Entrega garantida no 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. 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. Para saber como aproveitar as opções de fallback, confira o recurso de notificação.

Introdução

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.