Configurar notificações do Slack

Os painéis de IA/BI suportam o envio de snapshots agendados para os canais do Slack. Isso permite que as equipes recebam atualizações do painel diretamente em seu espaço de trabalho do Slack. Esta página explica como criar um aplicativo Slack e configurar um canal do Slack como destino de notificação. 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 Slack como subscritor, consulte Subscrever um canal Slack ou Microsoft Teams.

As assinaturas do Slack fornecem instantâneos de 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:

• Você deve ser um administrador do espaço de trabalho do Azure Databricks para configurar destinos de notificação.
• Você deve ter as permissões apropriadas para criar e instalar aplicativos em seu espaço de trabalho do Slack.

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

Depois de configurar o destino da notificação, qualquer usuário com permissões CAN EDIT em um painel pode adicionar o destino do Slack como assinante às agendas gerenciadas.

Etapa 1: Criar e configurar um aplicativo Slack

Crie um aplicativo Slack para seu espaço de trabalho e configure as permissões necessárias.

Criar o aplicativo Slack

1. Vá para Seus aplicativos na documentação da API do Slack. Você pode ser solicitado a entrar no espaço de trabalho do Slack.
2. Clique em Criar um aplicativo.
3. Clique em De um manifesto ou Do zero, dependendo se você tem um arquivo de manifesto para adicionar as informações básicas do seu aplicativo ou se deseja criá-lo usando a interface do usuário de configuração do Slack. Consulte a documentação do Slack sobre como configurar aplicativos com manifestos de aplicativos para obter instruções sobre como criar a partir de um manifesto.

Depois de criar o aplicativo, a página de configurações do aplicativo Slack é aberta automaticamente.

Adicionar escopos OAuth necessários

1. Na barra lateral, em Recursos, clique em OAuth e Permissões.
2. Role para baixo até Escopos.
3. Em Escopos de Token de Bot, clique em Adicionar um Escopo de OAuth.
4. Adicione os seguintes escopos:
   • incoming-webhook
   • files:write
   • files:read
   • chat:write

Instale o aplicativo em seu espaço de trabalho

1. Na barra lateral de configurações do aplicativo Slack, em Configurações, clique em Instalar aplicativo.
2. Clique em Instalar ou Solicitar instalação.
3. Selecione um canal de destino no seu espaço de trabalho.
4. Clique em Permitir para concluir a instalação.

Verifique se o aplicativo foi adicionado ao seu canal de destino

1. No espaço de trabalho do Slack, abra o canal de destino. Clique no nome do canal na parte superior da janela.

2. Clique na guia Integrações .

   

3. Em Aplicações, confirme que vê o bot que acabou de criar. Se não o vir, clique em Adicionar aplicações e adicione-o.

Recuperar credenciais de autenticação

Você precisa das seguintes informações do aplicativo Slack para configurar o destino de notificação do Azure Databricks:

1. Token OAuth do usuário do bot:
   • Navegue até OAuth & Permissions nas configurações do aplicativo Slack.
   • Copie o token OAuth do usuário do bot.
2. URL do Webhook:
   • Navegue até Incoming Webhooks nas configurações da aplicação Slack.
   • Copie o URL do Webhook para o seu canal de destino.

Obter o ID do canal do Slack

1. No espaço de trabalho do Slack, navegue até o canal de destino.
2. Clique no nome do canal para abrir os detalhes do canal.
3. Copie o ID do canal dos detalhes do canal.

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

Crie um destino de notificação no seu espaço de trabalho do Azure Databricks que aponte para o seu canal do Slack.

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 Folga na lista suspensa do tipo de destino.
8. Insira as seguintes informações:
   • Nome do destino: um nome descritivo para este destino do Slack
   • URL do Webhook do Slack: O URL do webhook da sua aplicação Slack
   • Token OAuth: O token OAuth do usuário do bot do seu aplicativo Slack
   • ID de canal do Slack: O ID do canal do seu espaço de trabalho no Slack
9. Clique em Criar.

Os usuários agora podem adicionar esse destino de notificação do Slack como assinante às agendas do painel.

Para instruções sobre como subscrever canais do Slack para os horários dos painéis, consulte Subscrever um canal do Slack ou do Microsoft Teams.

Solução de problemas

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

Anexo PDF ausente

Se a notificação do Slack aparecer sem um anexo PDF, verifique se:

• O token OAuth está configurado corretamente no destino da notificação
• O ID do canal corresponde ao canal de destino
• A aplicação Slack tem o escopo necessário files:write

A notificação não aparece

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

• Verifique se o URL do webhook está correto e corresponde ao canal de destino
• Verifique se o aplicativo Slack está instalado no espaço de trabalho
• Verifique se o bot foi adicionado ao canal de destino
• Confirme se o agendamento está ativo e não pausado

Próximos passos

• Inscreva os canais do Slack nas agendas do painel. Veja Assinar um canal do Slack ou do Microsoft Teams
• Configure destinos de notificação por e-mail. Consulte Gerenciar destinos de notificação