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 criar e configurar aplicativos no Microsoft Copilot Studio e no Microsoft Entra ID.

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

Crie um bot do Microsoft Copilot Studio para seu workspace do Teams e configure as permissões necessárias.

Criar o bot do Microsoft Copilot Studio

Conclua as seguintes etapas na documentação do Microsoft Copilot Studio:

1. Instale o aplicativo Copilot Studio no Microsoft Teams.
2. Crie um chatbot em uma equipe.

Configurar permissões de aplicativo na ID do Microsoft Entra

1. Acesse o centro de administração do Microsoft Entra.
2. Clique em Aplicativos Registro de Aplicativos>.
3. Localize e selecione o registro de aplicativo associado ao bot do Copilot Studio usando a ID do aplicativo da etapa anterior.
4. Na barra lateral esquerda, clique em permissões de API.
5. Clique em Adicionar uma permissão.
6. Nas APIs da Microsoft, clique em permissões de Aplicativo do 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 para sua organização.

Criar um segredo de autenticação

1. No Centro de administração do Microsoft Entra, com o registro do 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.

Publicar o bot e adicionar ao canal do Teams

Conclua as seguintes etapas na documentação do Microsoft Copilot Studio:

1. Publique seu Chatbot.
2. Disponibilize seu chatbot para outros funcionários.

Criar um webhook de entrada para o canal

1. Na documentação do Microsoft Copilot Studio, siga as etapas para criar um Webhook de entrada.
2. Copie e salve a URL de webhook gerada.
3. Clique em Concluído.

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.

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: a ID do aplicativo do bot do Microsoft Copilot Studio
   • 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:

• A ID do aplicativo está configurada corretamente 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 bot foi publicado e 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