Compartilhar via

Configurar notificações do Slack

Os painéis de IA/BI dão suporte ao envio de instantâneos agendados para canais do Slack. Isso permite que as equipes recebam atualizações do painel diretamente em seu workspace do Slack. Esta página explica como criar um aplicativo slack e configurar um canal do Slack 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 Slack como assinante, consulte Assinar um canal do Slack ou do Microsoft Teams.

As assinaturas do Slack 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

Exemplo de uma notificação do Slack mostrando um instantâneo do painel

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 instalar aplicativos no workspace 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 de notificação, qualquer usuário com permissões CAN EDIT em um painel poderá adicionar o destino do Slack como assinante aos agendamentos que gerenciar.

Etapa 1: Criar e configurar um aplicativo slack

Crie um aplicativo slack para seu workspace e configure as permissões necessárias.

Criar o aplicativo Slack

  1. Acesse seus aplicativos na documentação da API do Slack. Talvez você seja solicitado a entrar no workspace do Slack.
  2. Clique em Criar um aplicativo.
  3. Clique em A partir de um manifesto ou Do zero, dependendo de você ter um arquivo de manifesto para adicionar as informações básicas do aplicativo, ou se deseja criá-lo usando a interface de configuração do Slack. Consulte a documentação do Slack sobre como configurar aplicativos com manifestos de aplicativo 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 será 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 OAuth.
  4. Adicione os seguintes escopos:
    • incoming-webhook
    • files:write
    • files:read
    • chat:write

Instalar o aplicativo em seu workspace

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

Verifique se o aplicativo foi adicionado ao canal de destino

  1. No seu workspace do Slack, abra o canal de destino. Clique no nome do canal próximo à parte superior da janela.

  2. Clique na guia Integrações .

    Detalhes do canal em um espaço de trabalho do Slack.

  3. Em Aplicativos, confirme se você vê o bot que acabou de criar. Se você não vê-lo, clique em Adicionar aplicativos e adicioná-lo.

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 & Permissões nas configurações do aplicativo Slack.
    • Copie o Token OAuth do Usuário do Bot.
  2. URL do webhook:
    • Navegue até Webhooks de entrada nas configurações do aplicativo Slack.
    • Copie a URL do Webhook para o canal de destino.

Obter a ID do canal do Slack

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

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 Slack.

  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 Slack 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: a URL do webhook do aplicativo Slack
    • Token OAuth: o token OAuth do usuário do bot do aplicativo Slack
    • ID do Canal do Slack: O ID do canal do workspace do Slack
  9. Clique em Criar.

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

Para obter instruções sobre como assinar canais do Slack 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 Slack.

Faltando anexo em PDF

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

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

Notificação não exibida

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

  • Verifique se a URL do webhook está correta e se corresponde ao canal de destino
  • Verifique se o aplicativo Slack está instalado no workspace
  • Verifique se o bot foi adicionado ao canal de destino
  • Confirme se o agendamento está ativo e não está em pausa

Próximas etapas

  • Last updated on