Configurar notificações do Microsoft Teams

Os painéis de IA/BI dão suporte ao envio de instantâneos agendados para canais do Microsoft Teams. Isso permite que as equipes recebam atualizações do painel diretamente em seu workspace do Teams. Esta página explica como criar um aplicativo do Microsoft Teams e configurar um canal do Teams como um destino de notificação. Os editores de painéis podem então adicionar este destino de notificações como subscritor aos painéis agendados. Para obter informações sobre como adicionar um canal do Teams como assinante, consulte Assinar um canal do Slack ou do Microsoft Teams.

As assinaturas do Teams fornecem instantâneos de painel que incluem:

• Uma captura de tela PNG do painel que é visível diretamente no canal
• Um link direto para abrir o painel no Azure Databricks
• Um anexo de captura de tela em PDF no tópico de mensagens

Requirements

Você deve ter as seguintes permissões:

• Você deve ser um administrador do workspace do Azure Databricks para configurar destinos de notificação.
• Você deve ter as permissões apropriadas para registrar aplicativos e conceder consentimento de administrador no Microsoft Entra ID. Você também deve ser capaz de criar um recurso Azure Bot no portal do Azure, adicionar um aplicativo no Teams e criar fluxos de trabalho do Power Automate no Microsoft Teams.

Durante o processo de instalação, você coleta credenciais de autenticação da Microsoft para configurar o destino de notificação do Azure Databricks.

Depois de configurar o destino de notificação, qualquer usuário com permissões CAN EDIT em um painel poderá adicionar o destino do Teams como assinante aos agendamentos gerenciados.

Etapa 1: Criar e configurar um aplicativo do Microsoft Teams

Registre um aplicativo Microsoft Entra ID, crie um bot Azure associado a esse app e adicione um app do Teams para o bot ao seu canal.

Registre um aplicativo Microsoft Entra ID

1. Acesse o centro de administração do Microsoft Entra.
2. Clique em Aplicações > Registros de aplicativo > Novo registro.
3. Digite um nome para o aplicativo e clique em Cadastrar.
4. Na página Visão geral do aplicativo, copie a ID do aplicativo (cliente). Você precisa desse valor para criar o Azure Bot e configurar o destino de notificação do Azure Databricks.

Configurar permissões de aplicativo na ID do Microsoft Entra

1. No centro de administração do centro de administração do Microsoft Entra, com o registro do seu app selecionado, clique em permissões da API na barra lateral esquerda.
2. Clique em Adicionar uma permissão.
3. Nas APIs da Microsoft, clique em permissões de Aplicativo do Microsoft Graph>.
4. Adicione as seguintes permissões:
   • Files.Read.All
   • Sites.ReadWrite.All
5. Clique em Adicionar permissões.
6. Clique em Conceder consentimento do administrador para conceder as permissões para sua organização.

Criar um segredo de autenticação

1. No centro de administração do Microsoft Entra, com o registro do seu aplicativo selecionado, clique em Certificados & Segredos.
2. Clique em Segredos do Cliente> Novo segredo do cliente.
3. Insira uma descrição e selecione um período de expiração.
4. Clique em Adicionar.
5. Copie o valor do segredo recém-criado. Esse valor é exibido apenas uma vez e você precisa dele para configurar o destino de notificação do Azure Databricks.

Obter a ID do locatário

1. No Centro de administração do Microsoft Entra, com o registro do aplicativo selecionado, navegue até Visão geral.
2. Copie ID do Diretório (inquilino). Você precisa desse valor para configurar o destino de notificação do Azure Databricks.

Crie um Azure Bot para o app

Crie um recurso do Azure Bot que use o aplicativo Microsoft Entra ID que você registrou.

1. Vá ao portal do Azure e clique em Criar um recurso.
2. Procure por Azure Bot, selecione a carta Azure Bot e clique em Criar.
3. No ID do Microsoft App, selecione Usar registro de aplicativo existente e insira o ID do aplicativo (cliente) do aplicativo que você registrou.
4. Preencha os campos demais necessários e clique em Revisar + criar > Criar.
5. Quando a implantação terminar, clique em Ir para o recurso.

Conecte o bot ao Microsoft Teams

Adicione o canal do Microsoft Teams ao bot, depois crie um aplicativo do Teams para o bot e adicione-o ao seu canal. Para o procedimento completo, veja Conectar um bot a Microsoft Teams na documentação Azure Serviço de Bot.

1. No recurso Azure Bot, abra os Canais de Configurações > e clique no Microsoft Teams.
2. Concorde com os termos de serviço. Na aba Mensagens , selecione o ambiente de nuvem para seu bot e clique em Aplicar.
3. Crie um aplicativo do Teams para o bot, empacote-o e envie para o Microsoft Teams. Para instruções, veja Publicar seu bot no Teams.
4. Adicione o app do Teams ao canal onde você quer receber notificações no painel.

Obter a URL do canal do Teams

1. No Microsoft Teams, navegue até o canal de destino.
2. Clique no menu de hambúrguer ••• ao lado do nome do canal.
3. Clique em Copiar link. Certifique-se de copiar a URL do canal e não a URL do Teams. Você precisa dessa URL para configurar o destino de notificação do Azure Databricks.

Criar um webhook de entrada para o canal

1. Siga os passos da Microsoft para criar um webhook recebendo com o Workflows for Microsoft Teams, usando o Enviar alertas de webhook para um modelo de canal e selecionando o canal de destino.
2. Copie e salve a URL de webhook gerada. Você precisa dessa URL para configurar o destino de notificação do Azure Databricks.

Etapa 2: Configurar o destino de notificação no Azure Databricks

Crie um destino de notificação no workspace do Azure Databricks que aponte para o canal do Microsoft Teams.

1. Faça login no workspace do Azure Databricks.

2. Clique no nome de usuário no canto superior direito do workspace.

3. Selecione Configurações na lista suspensa.

4. Na seção de administração do workspace, clique na guia Notificações.

5. Clique em Gerenciar na seção Destinos de notificação .

6. Clique em Adicionar destino.

7. Selecione o Microsoft Teams na lista suspensa do tipo de destino.

8. Insira as seguintes informações:

   • Nome: um nome descritivo para este destino de canal do Teams
   • URL do Webhook do Microsoft Teams: a URL do webhook de entrada do Teams
   • ID do aplicativo: O ID do aplicativo (cliente) do seu registro no aplicativo Microsoft Entra ID
   • Auth Secret: o valor do segredo do cliente do Microsoft Entra ID
   • URL do Canal: A URL do canal do Microsoft Teams
   • ID do locatário: O ID do diretório (locatário) do Microsoft Entra ID

9. Clique em Criar.

Agora, os usuários podem adicionar esse destino de notificação do Teams como assinante aos agendamentos do painel.

Para obter instruções sobre como assinar canais do Teams nos agendamentos do painel, consulte Assinar um canal do Slack ou do Microsoft Teams.

Resolução de problemas

Use o seguinte para solucionar erros comuns com notificações do Microsoft Teams.

Faltando anexo em PDF

Se a notificação do Teams for exibida sem um anexo PDF, verifique o seguinte:

• O ID da aplicação (cliente) está corretamente configurado no destino da notificação
• O segredo de autenticação é válido e não expirou
• O aplicativo recebeu as permissões Files.Read.All e Sites.ReadWrite.All necessárias no Microsoft Entra ID
• O consentimento do administrador foi concedido para as permissões de API

Notificação não exibida

Se as notificações não aparecerem em seu canal do Teams:

• Verifique se a URL do webhook está correta e se corresponde ao canal de destino
• Verifique se o segredo de autenticação usa o valor do segredo do cliente do Microsoft Entra ID e não a identificação secreta.
• Verifique se o aplicativo Teams do bot foi adicionado ao canal de destino
• Verifique se a URL do canal está correta
• Verifique se a ID do locatário corresponde à sua organização da Microsoft
• Confirme se o agendamento está ativo e não está em pausa

Próximas etapas

• Inscreva-se nos canais do Teams nos horários do painel. Consulte Assinar um canal do Slack ou do Microsoft Teams
• Configurar destinos de notificação do Slack. Consulte Configurar notificações do Slack
• Configurar destinos de notificação por email. Consulte Gerenciar destinos de notificação