Partilhar via


Configurar notificações do Microsoft Teams

Importante

Este recurso está no Public Preview.

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 criar e configurar aplicações no Microsoft Copilot Studio e no Microsoft Entra ID.

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

Crie um bot Microsoft Copilot Studio para o seu espaço de trabalho do Teams e configure as permissões necessárias.

Criar o bot do Microsoft Copilot Studio

Complete os seguintes passos da documentação do Microsoft Copilot Studio:

  1. Instale a aplicação Copilot Studio no Microsoft Teams.
  2. Crie um novo chatbot numa equipa.

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

  1. Aceda ao centro de administração do Microsoft Entra.
  2. Clique em Aplicações > Registos de Aplicações.
  3. Encontre e selecione o registo da aplicação associado ao seu bot Copilot Studio usando o ID da Aplicação do passo anterior.
  4. Na barra lateral esquerda, clique em permissões da API.
  5. Clique em Adicionar uma permissão.
  6. Nas APIs Microsoft, clique em permissões de Aplicação Microsoft Graph>.
  7. Adicione as seguintes permissões:
    • Files.Read.All
    • Sites.ReadWrite.All
  8. Clique em Adicionar permissões.
  9. 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 do Microsoft Entra, com o registo da 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.

Publique o bot e adicione ao canal do Teams

Complete os seguintes passos da documentação do Microsoft Copilot Studio:

  1. Publique o seu chatbot.
  2. Torne o seu chatbot disponível para outros colaboradores.

Crie um webhook de entrada para o canal

  1. Na documentação do Microsoft Copilot Studio, siga os passos para criar um Webhook de Entrada.
  2. Copie e guarde a URL gerada do webhook.
  3. Clique em Concluído.

Copiar o URL do webhook gerado.

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.

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 Administração do espaço de trabalho , clique na guia 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 do seu bot Microsoft Copilot Studio
    • 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.

Crie um novo destino para equipas.

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 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
  • Verifique se o bot foi publicado e adicionado 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