Crie aplicativos interativos do Microsoft Graph com feed em tempo real

Este artigo descreve um padrão de integração comum do Microsoft Graph para um cenário de negócios que depende de dados e funcionalidades do serviço de email do Microsoft 365. Ele usa APIs do Microsoft Graph para ler dados, operações de chamada de email e receber notificações de alteração do Microsoft Graph usando webhooks por meio do canal WebSocket. Este cenário tem os seguintes requisitos de arquitetura:

• Um tipo de integração de aplicativo.
• Um fluxo de dados bidirecional entre o Microsoft 365 e o aplicativo.
• Um volume de dados baixo, pois atende a um único usuário.
• Uma latência de dados média aceitável para notificações por push.

Esse padrão usa várias opções de integração do Microsoft Graph, incluindo APIs, notificações de alteração e, opcionalmente, APIs de acompanhamento de alterações. Para receber notificações de alteração por meio do WebSocket, o aplicativo usa o SDK do SignalR, que abstrai e simplifica o gerenciamento do WebSocket.

O diagrama a seguir mostra a arquitetura dessa solução.

Componentes da solução

A arquitetura da solução inclui os seguintes componentes:

• O Microsoft Entra ID, que é necessário para gerenciar a autenticação das APIs do Microsoft Graph e dá suporte a permissões delegadas e de aplicativo para habilitar o fluxo OAuth.
• Serviços de notificação do Microsoft Graph, que gerencia assinaturas de notificação e fornece notificações de alteração para aplicativos cliente.
• APIs RESTful do Microsoft Graph que são acessadas por meio de um único ponto de extremidade: https://graph.microsoft.com.
• Um aplicativo móvel personalizado que implementa lógica e webhooks personalizados e se comunica com o Microsoft Graph.

Considerações

As considerações a seguir dão suporte ao uso desse padrão de integração:

• Disponibilidade: o aplicativo personalizado deve estar altamente disponível no dispositivo de borda e pode dar suporte a um modo offline quando uma conexão confiável com a Internet não estiver disponível.

• Latência: as APIs HTTP RESTful do Microsoft Graph geralmente respondem em um segundo, mas a latência geral depende da velocidade da conexão com a Internet. As notificações do Microsoft Graph são geradas segundos após a alteração, mas sua entrega depende da conexão com a Internet, dos SLAs do fornecedor móvel e da disponibilidade do webhook.

• Escalabilidade: os serviços do Microsoft Graph são altamente escalonáveis, distribuídos geograficamente e oferecem suporte a solicitações e notificações para milhões de clientes.

• Complexidade da solução: essa solução requer código personalizado para orquestrar APIs, manter assinaturas de notificação e receber notificações de alteração por meio de webhooks. Embora essa solução não exija elasticidade, ela precisa dar suporte a usuários em diferentes condições de rede e, potencialmente, lidar com uma explosão de notificações de alteração. Portanto, essa solução é altamente complexa.

Conteúdo relacionado

• Práticas recomendadas em aplicativos em nuvem
• Conceitos básicos do Microsoft Graph