Visão geral
A integração com o Slack conecta seu espaço de trabalho do Slack ao UserGuiding via OAuth. Uma vez conectado, o UserGuiding publica mensagens em tempo real nos canais do Slack que você selecionar — um canal por pesquisa e um canal por tipo de notificação (Resumo Semanal, Atividade Diária, Alertas Personalizados).
Esta integração substitui a Slack Integration (Legacy), que exigia que você colasse manualmente a URL do webhook de entrada. Se você estiver usando a integração legada atualmente, será informado sobre a migração na primeira vez que se conectar. Mais detalhes estão disponíveis abaixo na seção Migração.
Do que você precisa
- Um espaço de trabalho do Slack
- Um administrador do espaço de trabalho do Slack deve aprovar a solicitação OAuth.
- Acesso à página de Integrações no Guia do Usuário (recomenda-se a função de Administrador ou Proprietário da Conta)
Permissões Solicitações de orientação ao usuário
Ao autorizar o aplicativo, o Slack solicitará sua aprovação:
- channels:read — lista os canais públicos em seu espaço de trabalho para que você possa escolher um no Guia do Usuário
- groups:read — lista os canais privados aos quais o bot foi adicionado
- chat:write — publique mensagens como o bot UserGuiding
- chat:write.public — publicar em qualquer canal público sem ser convidado primeiro
O UserGuiding nunca lê mensagens do seu espaço de trabalho.
Conectando o Slack
- Acesse Configurações → Integrações e abra o cartão do Slack .
- Clique em Conectar ao Slack . Você será redirecionado para o Slack.
- Selecione o espaço de trabalho, revise as permissões solicitadas e clique em Permitir .
- Você será redirecionado de volta para o Guia do Usuário. O cartão do Slack agora mostra o espaço de trabalho do Slack conectado: <nome do seu espaço de trabalho> .
Escolhendo canais para respostas da pesquisa
Abra a pesquisa que deseja encaminhar para o Slack, role até a seção Integrações e:
- Ative as notificações do Slack .
- Selecione um canal no menu suspenso "Canal do Slack" .
- Opcionalmente, ative a opção "Enviar atributos do usuário" e escolha quais atributos incluir na mensagem.
Cada pesquisa pode ser publicada em um canal diferente. Depois de salva, cada nova resposta para essa pesquisa é publicada como uma mensagem no canal selecionado.
Escolhendo canais para notificações
O Resumo Semanal, a Atividade Diária e os Alertas Personalizados têm cada um seu próprio canal no Slack. Acesse Configurações → Notificações e:
- Abra a aba que deseja configurar ( Resumo , Atividade ou Alertas ).
- Ative a opção "Publicar no Slack" .
- Selecione um canal no menu suspenso "Canal do Slack" .
- Clique em Salvar no canto superior direito.
Você pode escolher um canal diferente para cada tipo de notificação (por exemplo, #ug-digest , #ug-activity , #ug-alerts ).
Se o Slack não estiver conectado
Quando o Slack não está conectado (ou foi desconectado), a opção de integração com o Slack fica desativada em todas as páginas que utilizam o Slack — configuração da pesquisa, Configurações → Notificações → Resumo , Atividade e Alertas . Você verá um aviso abaixo da opção: "Seu espaço de trabalho do Slack está desconectado. Reconecte-o para enviar notificações." com um link " Acessar Integrações " que leva você a Configurações → Integrações , onde você pode conectar (ou reconectar) seu espaço de trabalho. Depois de conectado, a opção se torna interativa e o menu suspenso do Canal do Slack aparece.
Desconectar do Slack
Em Configurações → Integrações → Slack , clique no link Desconectar no banner do espaço de trabalho conectado. O UserGuiding remove a configuração de integração e solicita ao Slack que revogue o token do bot, para que o bot saia dos canais nos quais estava publicando.
Após a desconexão, as postagens no Slack são interrompidas em todas as pesquisas e tipos de notificação. As seleções de canal são preservadas, portanto, reconectar-se ao mesmo espaço de trabalho as restaura.
Migrando da integração legada com o Slack
Se sua conta ainda estiver usando a integração legada de webhook do Slack, uma caixa de diálogo de migração será exibida na primeira vez que você clicar em Conectar ao Slack (A nova integração do Slack Workspace em Painel/Configurações/Integrações) :
A ativação da nova integração desativará sua integração atual com o Webhook do Slack (legada). Suas notificações existentes deixarão de ser entregues até que você atribua um canal do Slack a cada uma delas.
Você precisará atribuir canais para:
- Resumo semanal — Configurações → Notificações
- Atividade diária — Configurações → Notificações
- Alertas personalizados — Configurações → Notificações
- Respostas da pesquisa — Página de configuração de cada pesquisa
Solução de problemas
- A mensagem "Falha na conexão com o Slack" indica que o fluxo OAuth foi interrompido ou o Slack retornou um erro. Clique em "Conectar ao Slack" e tente novamente. Se o problema persistir, entre em contato com o suporte do UserGuiding.
- O menu suspenso do canal está vazio — o token do bot pode ter sido revogado pelo Slack. Desconecte-se e reconecte-se. O menu suspenso é atualizado automaticamente a cada poucos minutos.
- As mensagens pararam de chegar — verifique se a integração ainda está conectada em Configurações → Integrações e se o canal não foi arquivado no Slack.