Configurar o Slack
Configurar o Slack
Se você quiser que suas assinaturas de dashboards ou alertas sejam enviados para canais do Slack (ou pessoas no Slack), um administrador deve primeiro integrar seu Analytics ao Slack.
Crie seu Slack App
Para que o Analytics envie mensagens para seus canais Slack, você precisará criar um Slack App e disponibilizá-lo para o Analytics.
Em qualquer página do Analytics, vá para Admin settings > Settings > Notification channels > Slack.
Clique em Open Slack Apps. O Analytics abrirá uma nova aba no navegador e o enviará para o site do Slack para criar o Slack App.
No site do Slack, clique em Create an App.
Escolha um workspace para desenvolver seu app
Selecione o workspace onde você deseja criar seu app.
O app manifest
Quando você clicar em Open Slack App, o Analytics enviará o app manifest, que o Slack usará para configurar seu app.
Você pode receber um aviso que diz:
Este app foi criado a partir de um manifesto de terceiros Sempre verifique os URLs e permissões abaixo.
Este aviso é esperado (o Analytics é o terceiro aqui). Você pode clicar em Configure para ver o app manifest que o Analytics enviou no URL. Aqui está o manifest em formato YAML:
_metadata:
major_version: 1
minor_version: 1
display_information:
name: Analytics
description: Bringing the power of Analytics to your Slack #channels!
background_color: "#509EE3"
features:
bot_user:
display_name: Analytics
oauth_config:
scopes:
bot:
- users:read
- channels:read
- channels:join
- files:write
- chat:write
- chat:write.customize
- chat:write.public
- groups:read
O manifest apenas cuida de algumas configurações para seu app e ajuda a agilizar o processo.
Clique no botão Next. Depois clique em Create para configurar seu Slack App.
Instale seu app no workspace
No site do Slack do seu app recém-criado, na aba Settings > Basic Information, na seção Install your app, clique em Install to workspace. Na tela seguinte, clique em Allow para dar ao Analytics acesso ao seu workspace do Slack.
O Bot User OAuth Token
Na página do seu app no Slack, à esquerda na seção Features, clique em OAuth and Permissions no menu lateral do Slack Apps e copie o Bot User OAuth Token. Volte para a página de configurações do Slack no Analytics e cole esse token no campo com o mesmo nome.
Salve suas alterações no Analytics
No Analytics, clique no botão Save changes e pronto! O Analytics executará automaticamente um teste rápido para verificar se o token da API está funcionando corretamente. Caso algo dê errado, será exibida uma mensagem de erro.
Enviando alertas e assinaturas para canais privados do Slack
Para enviar assinaturas e alertas para canais privados do Slack, você deve primeiro adicionar o app do Analytics ao canal privado.
No Slack, entre no canal privado e mencione o app do Analytics. Por exemplo, se você chamou seu Slack app de “Analytics”, basta digitar @Analytics. O Slack perguntará se você deseja convidar o app para o canal, e você deve confirmar.
Analytics não está listando seu canal privado?
Pode levar algum tempo para o Analytics detectar todos os canais aos quais o app foi convidado. Novos canais podem não aparecer nas listas por até 10 minutos após o convite do app ao canal.
Para que o Analytics consiga ver canais privados, o app deve ter o groups:read oauth scope. Embora essa permissão deva ser concedida ao configurar o app via Analytics, instalações antigas podem não ter essa permissão.
Se você suspeita que este é o caso, acesse as configurações do app no Slack:
- Clique no app Analytics na lista de apps.
- Clique em OAuth & Permissions no menu lateral.
- Na seção Scopes, adicione o escopo
groups:read. - O app precisará ser reinstalado no workspace clicando no botão Reinstall em OAuth Tokens.
Leitura adicional
Leia a documentação para outras versões do Analytics.