Integração de experiências entre os dispositivos das notificações do Microsoft Graph (preteridos)

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).

Observação

Se estiver apenas direcionando pontos de extremidade da Web, você poderá ir direto para a configuração do serviço de aplicativo para enviar notificações.

Além do registro de aplicativo no centro de administração do Microsoft Entra, seu aplicativo precisa registrar informações entre dispositivos, como ID de aplicativo entre plataformas e credenciais de push entre plataformas, a fim de autorizar o Microsoft Graph a enviar notificações por meio de serviços nativos de notificação por push que correspondam a cada sistema operacional: Windows, iOS e Android. Isso é feito por meio do painel do Partner Center (antigo painel do Centro de Desenvolvimento do Windows).

Observação

Você precisará de uma conta de desenvolvedor do Windows para concluir as etapas deste artigo, mesmo que não planeje criar um aplicativo UWP do Windows. Se você ainda não tiver uma conta de desenvolvedor do Windows, consulte Abrir uma conta de desenvolvedor. Como alternativa, se você preferir não se inscrever como desenvolvedor do Windows, poderá entrar em contato conosco por email em [gnsengage@microsoft.com](sendto: gnsengage@microsoft.com). Se você criar uma conta de desenvolvedor do Windows e estiver criando uma escola ou aplicativo de trabalho como parte de uma empresa, poderá associar sua conta de desenvolvedor à conta de Microsoft Entra apropriada usada para gerenciar seus envios empresariais. Para obter detalhes, consulte Associar Microsoft Entra ID à sua conta do Partner Center.

Para começar, entre no painel do Partner Center com sua conta de desenvolvedor do Windows:

1. No menu à esquerda, acesse Experiências entre Dispositivos, selecione Configurar um novo aplicativo entre dispositivos, e forneça o nome do aplicativo, conforme mostrado na captura de tela a seguir.

2. Selecione todas as plataformas compatíveis em que seu aplicativo estará disponível e habilitado para receber notificações. Você pode selecionar plataformas compatíveis que incluem o Windows, Android e iOS, conforme mostrado. 

3. Forneça IDs de aplicativo para cada uma das plataformas em seu aplicativo estará disponível, conforme mostrado.

Observação

Você pode adicionar outras IDs (até dez) por plataforma – isso ocorre se você tiver várias versões do mesmo aplicativo, ou até mesmo diferentes aplicativos, e deseja receber a mesma notificação enviada pelo servidor do aplicativo e direcionadas ao mesmo usuário.

4. Forneça ou selecione a ID do aplicativo na conta microsoft e/ou Microsoft Entra registro do aplicativo. Essa ID do cliente corresponde à conta microsoft ou Microsoft Entra registro de aplicativo obtido quando você se registra no centro de administração do Microsoft Entra.

5. As notificações do Microsoft Graph usam cada plataforma nativa de notificação em todas as plataformas principais para enviar notificações aos pontos de extremidade do aplicativo do cliente, ou seja, WNS (para Windows UWP), FCM (para Android) e APNS (para iOS). Forneça as credenciais dessas plataformas de notificação para habilitar as notificações do Microsoft Graph para enviar notificações para o servidor do aplicativo ao publicar notificações direcionadas pelo usuário, conforme mostrado.

Observação

Para aplicativos UWP do Windows, habilitar as notificações por push WNS é um pré-requisito para usar as notificações do Microsoft Graph. Para saber mais, confira a Visão geral do WNS. Após fazer a integração, você pode fornecer credenciais de push pelo Partner Center para a plataforma do dispositivo conectado.

6. Verifique o domínio do aplicativo entre dispositivos, que serve como um processo de verificação para provar que o aplicativo tem a propriedade desse domínio. Isso funciona como uma identidade do aplicativo entre dispositivos para o aplicativo ou os aplicativos que você registrou, conforme mostrado.

   

Isso é tudo. Você já registrou os aplicativos para receber notificações. Em seguida, aprenda como configurar o serviço do aplicativo e a começar a enviar notificações.