Configurar notificações do Microsoft Teams

Os dashboards de IA/BI suportam o envio de snapshots agendados para os canais do Microsoft Teams. Isto permite que as equipas recebam atualizações do painel diretamente no seu espaço de trabalho do Teams. Esta página explica como criar uma aplicação Microsoft Teams e configurar um canal Teams como destino de notificações. Os editores de painel podem então adicionar esse destino das notificações como subscritor de painéis agendados. Para informações sobre como adicionar um canal Teams como subscritor, veja Subscrever um canal Slack ou Microsoft Teams.

As subscrições do Teams fornecem instantâneos do painel que incluem:

• Uma imagem instantânea em PNG do painel visível diretamente no canal
• Um link direto para abrir o painel no Azure Databricks
• Um anexo de instantâneo PDF no histórico de mensagens

Requerimentos

Você deve ter as seguintes permissões:

• Tem de ser administrador de workspace Azure Databricks para configurar destinos de notificações.
• Deve ter as permissões adequadas para registar aplicações e conceder consentimento de administrador no Microsoft Entra ID. Também deve ser capaz de criar um recurso Azure Bot no portal do Azure, adicionar uma aplicação Teams e criar fluxos de trabalho Power Automate no Microsoft Teams.

Durante o processo de configuração, recolhe credenciais de autenticação da Microsoft para configurar o destino de notificação do Azure Databricks.

Depois de configurar o destino da notificação, qualquer utilizador com permissões CAN EDIT num painel pode adicionar o destino do Teams como assinante aos horários que gerem.

Passo 1: Criar e configurar uma aplicação Microsoft Teams

Registe uma aplicação Microsoft Entra ID, crie um bot Azure associado a essa aplicação e adicione uma aplicação Teams para o bot ao seu canal.

Registe uma aplicação Microsoft Entra ID

1. Aceda ao centro de administração do Microsoft Entra.
2. Clique em Candidaturas > Registos de aplicações > Nova inscrição.
3. Introduza um nome para a aplicação e clique em Registar.
4. Na página de Visão Geral da aplicação, copie o ID da Aplicação (cliente). Precisa deste valor para criar o Azure Bot e configurar o destino de notificações do Azure Databricks.

Configurar permissões de aplicação no Microsoft Entra ID

1. No centro de administração Microsoft Entra, com o registo da aplicação selecionado, clique em permissões API na barra lateral esquerda.
2. Clique em Adicionar uma permissão.
3. Nas APIs Microsoft, clique em permissões de Aplicação 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 à sua organização.

Criar um segredo de autenticação

1. No centro de administração Microsoft Entra, com o registo da sua aplicação selecionado, clique em Certificados & Segredos.
2. Clique em Novo segredo do cliente em Segredos do cliente>.
3. Introduza uma descrição e selecione um período de validade.
4. Clique em Adicionar.
5. Copie o valor do segredo recém-criado. Este valor é exibido apenas uma vez e precisa dele para configurar o destino de notificação do Azure Databricks.

Obtenha o ID do inquilino

1. No centro de administração do Microsoft Entra, com o registo da aplicação selecionado, navegue até à Visão Geral.
2. Copie o ID do Diretório (inquilino). Precisa deste valor para configurar o destino de notificação do Azure Databricks.

Crie um Azure Bot para a aplicação

Crie um recurso Azure Bot que utilize a aplicação Microsoft Entra ID que registou.

1. Vai ao portal do Azure e clica em Criar um recurso.
2. Procure por Azure Bot, selecione a carta Azure Bot e clique em Criar.
3. Em Microsoft App ID, selecione Usar registo de aplicação existente e insira o ID da aplicação (cliente) da aplicação que registou.
4. Preencha os campos necessários restantes e depois clique em Rever + criar > Criar.
5. Quando a implementação terminar, clique em Ir para o recurso.

Ligue o bot ao Microsoft Teams

Adiciona o canal do Microsoft Teams ao bot, depois cria uma aplicação Teams para o bot e adiciona-a ao teu canal. Para o procedimento completo, consulte Ligar um bot a Microsoft Teams na documentação Azure Bot Service.

1. No recurso Azure Bot, abra os Canais de Definições > e clique em Microsoft Teams.
2. Concorde com os termos de serviço. No separador Mensagens , selecione o ambiente cloud do seu bot e depois clique em Aplicar.
3. Crie uma aplicação Teams para o bot, empacote-a e carregue-a para o Microsoft Teams. Para instruções, consulte Publicar o seu bot no Teams.
4. Adiciona a aplicação Teams ao canal onde queres receber notificações no dashboard.

Obtenha o URL do canal Teams

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

Crie um webhook de entrada para o canal

1. Siga os passos da Microsoft para criar um webhook recebido com Workflows for Microsoft Teams, usando o Enviar alertas de webhook para um modelo de canal e selecionando o canal de destino.
2. Copie e guarde a URL gerada do webhook. Precisa desta URL para configurar o destino de notificação do Azure Databricks.

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

Crie um destino de notificações no seu espaço de trabalho Azure Databricks que aponte para o seu canal Microsoft Teams.

1. Faça logon no seu espaço de trabalho do Azure Databricks.

2. Clique no seu nome de utilizador no canto superior direito da área de trabalho.

3. Selecione Configurações na lista suspensa.

4. Na seção Administrador do Espaço de Trabalho, clique na aba Notificações.

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

6. Clique em Adicionar destino.

7. Selecione Microsoft Teams no menu suspenso do tipo de destino.

8. Insira as seguintes informações:

   • Nome: Um nome descritivo para este destino do canal Teams
   • URL do Webhook do Microsoft Teams: O URL do webhook recebido do Teams
   • ID da Aplicação: O ID da Aplicação (cliente) do registo da sua aplicação Microsoft Entra ID
   • Auth Secret: O valor secreto do cliente do Microsoft Entra ID
   • URL do canal: O URL do canal do Microsoft Teams
   • ID de Inquilino: O ID de Diretório (inquilino) do Microsoft Entra ID

9. Clique em Criar.

Os utilizadores podem agora adicionar este destino de notificação do Teams como destinatário às agendas do painel de controlo.

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

Solução de problemas

Use o seguinte para resolver erros comuns nas notificações do Microsoft Teams.

Anexo PDF ausente

Se a notificação do Teams aparecer sem um anexo PDF, verifique que:

• 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
• A aplicação recebeu as permissões Files.Read.All e Sites.ReadWrite.All necessárias no Microsoft Entra ID.
• Foi concedido consentimento de administrador para as permissões da API

A notificação não aparece

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

• Verifique se o URL do webhook está correto e corresponde ao canal de destino
• Verificar que o segredo de autenticação utiliza o valor do cliente do Microsoft Entra ID e não o ID secreto
• Verifique se a aplicação Teams do bot foi adicionada ao canal de destino
• Assegure que a URL do canal está correta
• Verifique se o ID do inquilino corresponde à sua organização Microsoft
• Confirme se o agendamento está ativo e não pausado

Próximos passos

• Subscreva os canais do Teams para os horários dos painéis. Veja Assinar um canal do Slack ou do Microsoft Teams
• Configurar os destinos das notificações no Slack. Ver Configurar notificações do Slack
• Configure destinos de notificação por e-mail. Consulte Gerenciar destinos de notificação