Latest / M365.FM – Podcast de Microsoft 365, Copilot e IA em português / Notificações de alteração do Microsoft Graph explicadas: tempo real em vez de polling (Dublagem IA)

Transcript

Notificações de alteração do Microsoft Graph explicadas: tempo real em vez de polling (Dublagem IA) · M365.FM – Podcast de Microsoft 365, Copilot e IA em português

• 0:00
  Preparado para 10 dias de Microsoft 305 Copilot IA,
• 0:04
  Azure e as pessoas que estão moldando o futuro do trabalho,
• 0:06
  em janeiro, a M365 com está de volta e vamos trazer algo ainda maior.
• 0:12
  Junte-se a nós em sessões ao vivo, demonstrações do mundo real
• 0:15
  e conhecimento prático de MVPs e especialistas do setor em todo o mundo.
• 0:18
  Nada de slides genéricos ou palavras da moda sem fim.
• 0:22
  Estamos abordando desafios reais.
• 0:23
  Copilot Studio, agente de IA, fábrica, segurança, governança e automação.
• 0:28
  Seja você um profissional de TI, desenvolvedor ou líder de negócios,
• 0:33
  há sessões criadas para você.
• 0:35
  Com 10 dias inteiros, você pode explorar várias tecnologias
• 0:38
  e se conectar com uma comunidade global.
• 0:40
  Assista ao vivo e leve insights práticos de volta para a sua organização.
• 0:45
  Janeiro de 2027, 10 dias, uma comunidade Microsoft.
• 0:49
  As inscrições já estão abertas.
• 0:51
  Acesse m365com.net e garanta sua vaga hoje mesmo.
• 0:55
  Isso mesmo, m365com.net.
• 1:01
  Inscreva-se agora em m365com.net.
• 1:05
  Tópico de hoje.
• 1:06
  É algo que quase todo mundo que desenvolve com o Microsoft 365 já ouviu falar.
• 1:09
  Mas a maioria das pessoas não entende como funcionam os bastidores.
• 1:12
  Estou falando das notificações de alteração do Microsoft Graph.
• 1:16
  Exatamente elas são e por que você deveria se importar.
• 1:18
  Vamos começar pelo problema aquelas vezes.
• 1:20
  Imagine que você cria um aplicativo que precisa saber quando algo muda no Microsoft 365.
• 1:23
  Talvez um novo e-mail chegue e alguém atualize um arquivo no SharePoint ou um novo usuário
• 1:27
  seja adicionado ao diretório da sua empresa.
• 1:29
  Como seu aplicativo desconto?
• 1:30
  O ponto é, a maneira antiga é o polo em sondagem.
• 1:33
  Seu aplicativo envia uma solicitação ao Microsoft Graph a cada poucos minutos perguntando.
• 1:36
  Há algo novo desde a última verificação?
• 1:38
  Se nada mudou, você desperdiçou uma solicitação.
• 1:40
  E se algo mudou 5 segundos após sua verificação, você só saberá no próximo ciclo.
• 1:45
  Você está verificando com muita frequência, desperdiçando recursos e arriscando throttling
• 1:48
  ou raramente demais, perdendo eventos?
• 1:49
  Microsoft, na verdade, limita aplicativos que fazem sondagens agressivas de manhã.
• 1:54
  Desenvolvedores chamam isso de prisão do Graph, onde seu app é bloqueado por um tempo
• 1:56
  por excesso de solicitações.
• 1:59
  Então a pergunta é, não existe um jeito melhor?
• 2:01
  Em vez de seu app perguntar constantemente se há algo novo, o sistema apenas avisasse
• 2:04
  quando algo mudasse?
• 2:06
  É exatamente isso que as notificações de alteração fazem.
• 2:09
  O que são as notificações de alteração do Microsoft Graph?
• 2:11
  Aqui está a definição mais simples.
• 2:13
  As notificações de alteração permitem que seu aplicativo reaja instantaneamente a eventos
• 2:16
  do Microsoft 365 sem verificações constantes.
• 2:19
  Pense nelas como um sensor de movimento na sua caixa de corre.
• 2:22
  Em vez de passar por ela a cada hora para olhar dentro, você instala um sensor que te avisa
• 2:25
  no momento em que a correspondência chega.
• 2:27
  Você para de perder tempo com verificações vazias e nunca perde uma entrega.
• 2:30
  É isso que as notificações de alteração fazem pelo seu aplicativo.
• 2:32
  Quando algo muda, como um novo e-mail, um arquivo atualizado ou um evento de calendário,
• 2:36
  o Microsoft Graph envia uma notificação para seu aplicativo automaticamente.
• 2:39
  Não é necessário fazer pouco.
• 2:41
  Bem, este sistema tem duas partes, uma assinatura e uma notificação, e elas trabalham juntas.
• 2:45
  A assinatura é onde você diz ao Microsoft Graph o que deseja o monitor.
• 2:49
  Você diz coisas como, ei, avise-me quando alguém enviar uma nova mensagem para esta
• 2:52
  caixa de entrada.
• 2:53
  Ou, avise-me quando um arquivo for atualizado nesta biblioteca do SharePoint.
• 2:56
  Você registra seu interesse e o Graph tomando.
• 2:58
  A notificação é o que acontece em seguida.
• 3:00
  Quando a alteração ocorre, o Graph envia um HTTP post para um endpoint fornecido por
• 3:03
  você.
• 3:04
  Seu aplicativo recebe esse post e sabe que algo aconteceu, e pode então decidir o que fazer,
• 3:08
  como buscar novos dados, acionar um fluxo de trabalho ou atualizar um banco de dados.
• 3:12
  Aqui está a principal diferença, irmão.
• 3:15
  As notificações são entregues automaticamente.
• 3:17
  Seu aplicativo não precisa solicitar, o sistema envia informação no momento em que
• 3:20
  ela ocorre.
• 3:20
  Essa é a mágica disso.
• 3:22
  O Microsoft Graph oferece suporte a notificações de alteração para uma ampla gama de recursos.
• 3:26
  Mensagens, eventos, contatos, usuários, grupos, arquivos, mensagens do Teams, alertas
• 3:30
  de segurança.
• 3:30
  Praticamente tudo que você pode acessar pelo Graph pode ser monitorado quanto a alterações.
• 3:34
  Mas como você realmente configura isso?
• 3:35
  Como você diz ao Graph monitorar e para onde enviar os alertas?
• 3:38
  Criando uma assinatura.
• 3:39
  Dizendo ao Graph o que monitorar.
• 3:41
  Então o que é uma assinatura?
• 3:41
  É apenas uma solicitação de registro.
• 3:43
  Seu aplicativo desavise-me quando isso acontecer.
• 3:46
  E você envia essa solicitação para a API do Microsoft Graph.
• 3:48
  O Graph armazena agora.
• 3:50
  Você precisa fornecer ao Graph alguns detalhes nessa solicitação.
• 3:52
  Primeiro, o recurso deseja monitorar.
• 3:54
  O caminho para os dados.
• 3:55
  Por exemplo, em User, se você estiver monitorando alterações em contas de usuário.
• 3:58
  Ou Me, Mail, Folders, Inbox, Messages.
• 4:01
  Se você quiser saber sobre novos e-mails.
• 4:03
  Em seguida, o tipo de alteração.
• 4:05
  Você quer saber quando algo é criado, atualizado ou excluído.
• 4:08
  Você pode escolher um ou solicitar todos os três.
• 4:10
  Terceiro, o URL de notificação.
• 4:11
  Este é o endereço do seu endpoint.
• 4:13
  O local para onde o Graph deve enviar a notificação quando algo acontecer.
• 4:15
  Ele deve ser um endpoint HTTPS acessível publicamente.
• 4:18
  Não há atalhos aqui.
• 4:19
  Quarto, a data de expiração.
• 4:21
  As assinaturas não duram para sempre.
• 4:22
  Você escolhe uma data e hora futuras para a expiração da assinatura.
• 4:25
  Mas diferentes recursos têm tempos máximos de vida diferentes.
• 4:28
  As mensagens da Outlook podem durar até 7 dias.
• 4:30
  As mensagens de chat do Teams têm um limite máximo de 13.
• 4:32
  Arquivos do SharePoint podem durar cerca de 30 dias.
• 4:35
  Informações de presença?
• 4:36
  Isso expira após apenas uma hora.
• 4:37
  Isto é um exemplo concreto.
• 4:39
  Digamos que você queira saber quando alguém na sua empresa muda de cargo.
• 4:42
  Você cria uma assinatura para o recurso de usuários com um tipo de alteração de atualização.
• 4:46
  Você aponta para a sua URL de notificação e define a inspiração para alguns dias à frente.
• 4:50
  Quando alguém atualiza seu perfil no Azure AD, o Graph envia um post para seu endpoint com uma carga de notificação.
• 4:55
  Essa carga inclui o ID do usuário e informa o que foi alterado.
• 4:58
  Seu aplicativo pode então agir.
• 5:00
  Atualizar um sistema de RH, disparar um aviso ao gerente, o que precisar.
• 5:03
  O Graph responde a sua solicitação de assinatura com o ID de assinatura.
• 5:07
  Você precisará decidir mais tarde para gerenciar, renovar, atualizar ou excluir a assinatura.
• 5:11
  Não é que estou a dedo.
• 5:12
  Antes do Graph começar a enviar notificações, ele precisa confirmar se seu endpoint está ativo e ouvindo.
• 5:17
  Isso requer um handshake.
• 5:19
  Token de validação do handshake explicado.
• 5:21
  Ao criar uma assinatura, o Microsoft Graph não confia cegamente no seu endpoint.
• 5:26
  Ele envia um ping de teste primeiro, uma solicitação de verificação.
• 5:29
  Esse ping inclui um token de validação, uma string aleatória de caracteres.
• 5:32
  Seu endpoint deve capturar esse token e enviá-lo de volta como texto simples em 10 segundos.
• 5:37
  Pense nisso com um entregador tocando sua campainha para confirmar se você está em casa antes de deixar um pacote.
• 5:41
  Se ninguém atendeu, o entregador não deixa nada.
• 5:43
  Vale aqui.
• 5:44
  Se seu endpoint não retornar o token de validação, o Graph não enviará notificações a ele.
• 5:48
  A resposta deve ser texto simples, não JSON ou XML, apenas a string bruta do token.
• 5:54
  Se errar o formato, o handshake falha.
• 5:56
  É uma verificação de segurança.
• 5:57
  Isso prova que seu endpoint está ativo, ouvindo e sob seu controle.
• 6:01
  Impede que alguém aponte uma assinatura para uma URL que não possui na esperança de interceptar notificações destinadas a outra pessoa.
• 6:07
  Sem handshake não há assinatura.
• 6:08
  O Graph rejeita a solicitação de criação e você recebe um erro.
• 6:11
  Você corrige seu endpoint e tenta não ver.
• 6:13
  Assim que o handshake é bem sucedido, a assinatura fica ativa e as notificações começam a fluir.
• 6:17
  Mas aqui está o detalhe.
• 6:18
  Elas não fluem para cima.
• 6:20
  Mantendo a conexão ativa.
• 6:22
  Renovação de assinatura.
• 6:23
  Toda assinatura tem uma data de expiração.
• 6:25
  Você a define quando a cria.
• 6:27
  O Graph impõe.
• 6:28
  Quando esse dia chega, a assinatura para.
• 6:30
  Sem mais notificações.
• 6:32
  Pense nisso com um parquímetro.
• 6:34
  Você insere o tempo e quando ele acaba, o medidor expira.
• 6:37
  Recursos diferentes têm limites diferentes.
• 6:39
  Mensagens do Outlook podem durar sete dias.
• 6:42
  Chats do Teams, três dias.
• 6:43
  Arquivos do SharePoint, cerca de trinta dias.
• 6:45
  Informações de presença, apenas uma hora.
• 6:47
  Portanto, seu aplicativo não pode simplesmente criar uma assinatura e esquecê-la.
• 6:50
  Você precisa de um processo que a mantenha ativa.
• 6:52
  Renovar é sim.
• 6:53
  Envie uma solicitação pateada com a rede da assinatura.
• 6:56
  Inclua uma nova data de expiração.
• 6:57
  Faça isso antes que a atual expire e o Graph estenderá a assinatura.
• 7:01
  Aqui está a melhor prática, recomendo.
• 7:03
  Verifique o carimbo de data barra hora e expiração em cada notificação que você receba.
• 7:06
  Se estiver perto de expirar, digamos, dentro de um dia, renove imediatamente.
• 7:09
  Você não precisa de um trabalho em segundo plano separado apenas para gerenciar a assinatura.
• 7:13
  A Microsoft também adicionou notificações de ciclo de vida.
• 7:15
  Esses alertas avisam você antes que uma assinatura expire.
• 7:18
  Eles informam quando sua assinatura está prestes a terminar ou quando seu token de acesso precisa de reautorização.
• 7:22
  Assine esses avisos e seu aplicativo poderá renovar antes que algo pare de funcionar.
• 7:25
  Mas e se seu endpoint ficar fora do ar ou você perder a janela de renovação?
• 7:28
  É aí que entra a rede de segurança.
• 7:31
  Quando as coisas dão errado, confiabilidade e rede de segurança.
• 7:34
  Sua assinatura está ativa, seu endpoint está escutando, as notificações estão fluindo.
• 7:37
  Tudo parece bom, mas o que acontece quando algo falha?
• 7:40
  Talvez seu endpoint saia do ar para manutenção.
• 7:42
  Um problema de rede derruba uma notificação.
• 7:44
  Ou você simplesmente perca a janela de renovação e a assinatura expire.
• 7:47
  Essa coisa conta.
• 7:47
  A questão é como você se recupera.
• 7:49
  O Microsoft Graph espera que seu endpoint de Webhook responda rapidamente, dentro de 3 segundos.
• 7:53
  Se demorar mais, o Graph o marcará como lento.
• 7:55
  Se mais de 10% das suas respostas excederem 3 segundos em qualquer período de 10 minutos,
• 7:59
  o Graph atrasa suas notificações em 10 minutos.
• 8:01
  Ele envia apenas uma pequena amostra para verificar se você se recuperou.
• 8:04
  Pior ainda mais.
• 8:05
  Se mais de 15% das suas respostas excederem o tempo limite de nova tentativa de 10 segundos,
• 8:08
  o Graph marca seu endpoint como descartado.
• 8:10
  As notificações param completamente por 10 minutos.
• 8:12
  Assumido.
• 8:12
  Você não pode recuperá-lo.
• 8:14
  Portanto, seu endpoint precisa ser rápido e confiável.
• 8:16
  Isso não significa que você precise processar cada notificação em menos de 3 segundos.
• 8:19
  Apenas confirme o recebimento rapidamente com a resposta 202 Accepted.
• 8:23
  Então, processe a notificação assincronamente.
• 8:25
  Coloque na fila.
• 8:26
  Trata e posto.
• 8:26
  O segredo é essa resposta rápida.
• 8:28
  Mesmo com um endpoint perfeito, as coisas ainda podem dar errado.
• 8:30
  As assinaturas expiram.
• 8:32
  Falhas de rede acontecem.
• 8:33
  O próprio Microsoft Graph pode perder uma notificação em casos raros.
• 8:36
  Por isso que você precisa de uma rede de segurança.
• 8:38
  Consultas Delta.
• 8:39
  Pense desta maneira.
• 8:40
  As notificações de alteração são um alarme de incêndio.
• 8:42
  Elas dizem que algo está acontecendo agora.
• 8:43
  As consultas Delta são um sistema de spray.
• 8:45
  Elas pegam tudo o que o alarme deixou passar.
• 8:47
  Elas funcionam junto.
• 8:47
  As notificações oferecem consciência em tempo.
• 8:49
  As consultas Delta oferecem uma visão completa que você pode reconciliar com uma.
• 8:53
  O padrão recomendado é simples.
• 8:55
  Use notificações de alteração para obter reconhecimento em seu sistema.
• 8:57
  Execute uma consulta Delta periodicamente, talvez a cada poucas horas ou uma vez por dia,
• 9:00
  para capturar qualquer coisa que tenha passado a se perceber.
• 9:02
  Dessa forma, mesmo que uma notificação tenha sido perdida, uma assinatura tenha inspirado,
• 9:05
  você nunca perde uma alteração permanentemente.
• 9:07
  Caso de uso no mundo real.
• 9:09
  O que você pode construir.
• 9:10
  Então, o que isso realmente possibilita?
• 9:12
  Deixe-me guiá-lo por alguns exemplos reais.
• 9:13
  Veja a automação de RH.
• 9:14
  Imagine que alguém entre na sua empresa amanhã.
• 9:17
  No momento em que o Entrede cria um novo usuário, uma notificação de alteração é disparada.
• 9:21
  Seu aplicativo captura o perfil dele e cria contas na sua plataforma de RH.
• 9:24
  Controle de ponto e acesso ao prédio, tudo em segundos.
• 9:26
  Sem polo e sem atrasos.
• 9:28
  Para alertas de segurança, digamos que a conta de um usuário seja desativada.
• 9:31
  Uma notificação de alteração aciona um fluxo de trabalho que verifica alterações suspeitas
• 9:34
  e alerta sua equipe de segurança.
• 9:36
  Antes, eu faria polo em cada poucos minutos.
• 9:38
  Agora é instantâneo.
• 9:39
  O processamento de conteúdo funciona da mesma maneira.
• 9:41
  Quando um arquivo chega a uma biblioteca de documentos de SharePoint,
• 9:43
  você quer saber se é uma fatura.
• 9:45
  A notificação informa que um novo arquivo existe.
• 9:47
  Seu aplicativo captura passa por um IA para classificá-lo e envia para o sistema de despesas
• 9:50
  correto.
• 9:51
  Tudo automaticamente.
• 9:53
  Dashboards em tempo real permitem que você veja a análise conforme ela acontece e não
• 9:55
  com horas de atraso.
• 9:56
  As notificações de alteração sincronizam o Dataverse com o Fabric instantaneamente.
• 9:59
  Seus dashboards do Power BI são atualizados quase em tempo real.
• 10:02
  E que está um que acha interessante?
• 10:04
  Conectores do Copac.
• 10:05
  A Microsoft adiciona a sincronização em tempo real via webhooks para que os agentes de IA respondam
• 10:09
  no segundo link que os dados mandam.
• 10:09
  Quando um registro de cliente é atualizado no Dynamics 365, um agente do Copilot gera
• 10:14
  um acompanhamento imediatamente, sem esperar.
• 10:17
  Todos esses exemplos têm uma coisa em conta.
• 10:20
  Antes das notificações de alteração, você criava tarefas agendadas que faziam polling
• 10:23
  a cada hora do dia.
• 10:24
  Funcionava, mas era lento, ineficiente e frágil.
• 10:27
  As notificações de alteração invertem-se.
• 10:29
  Tempo real, orientado a eventos, instantâneo.
• 10:32
  Escolhendo o canal de entrega correto.
• 10:34
  Nem todo aplicativo precisa da mesma entrega.
• 10:36
  Vamos analisar suas opções.
• 10:37
  Webhooks são os mais simples.
• 10:39
  O Graph envia um HTTP post para seu endpoint e você processa e segue em frente.
• 10:43
  Para volumes baixos a médios, digamos algumas centenas de notificações por hora, isso
• 10:46
  funciona bem.
• 10:46
  Mas e se você estiver construindo alguma algo?
• 10:48
  Milhares de notificações por segundo podem sobrecarregar num único endpoint.
• 10:52
  Você precisa de algo mais poderoso.
• 10:53
  Event Hubs lida com milhões de eventos por segundo.
• 10:56
  Em vez de o Graph enviar notificações uma a uma, ele as envia para um hub.
• 10:59
  Seu aplicativo lê no seu próprio ritmo, com baixo risco de sobrecarga.
• 11:02
  Isso é para cenários de grandes empresas, como milhares de sites do SharePoint ou milhões
• 11:05
  de caixas de correio.
• 11:07
  E há o Event Grid opção sem servidor server.
• 11:08
  Ele envia notificações para o Azure Functions ou Logic Apps e lida automaticamente com novas
• 11:12
  tentativas e mensagens mortas.