Alerta que chega por e-mail concorre com dezenas de outros e-mails. Quando o aviso cai no canal do Slack onde o time já conversa, alguém responde na hora. Este artigo mostra como ligar um alerta do WiseData NPS a um canal — por exemplo, o alerta "NPS crítico" da pesquisa pós-atendimento indo para o canal #atendimento.
Antes de começar
Você precisa de permissão para criar um app no seu espaço de trabalho do Slack. Se a sua empresa restringe isso, peça ao administrador do Slack — ele faz o passo 1 e te passa a URL. No WiseData NPS, quem cadastra alertas é o administrador da conta, e o recurso faz parte dos planos Pro e Business e do período de teste.
Passo 1 — Gerar a URL no Slack
- Acesse api.slack.com/apps e clique em Create New App.
- Escolha From scratch, dê um nome (por exemplo, "WiseData NPS") e selecione o seu espaço de trabalho.
- No menu lateral, abra Incoming Webhooks e ligue a chave Activate Incoming Webhooks.
- Clique em Add New Webhook to Workspace e escolha o canal que vai receber os avisos.
- Copie a URL gerada. Ela começa com
https://hooks.slack.com/services/— qualquer outro endereço é recusado no formulário.
Passo 2 — Colar no WiseData NPS
- Vá em Alertas e clique em Novo Alerta (ou edite um existente).
- Preencha Nome do Alerta, Condição e Pesquisa, como em qualquer alerta.
- Em Métodos de Notificação, ligue Slack.
- Cole a URL no campo URL do Incoming Webhook e clique em Criar Alerta.
Como o aviso aparece
A mensagem chega com o nome do alerta como título, uma frase com a condição que disparou (no exemplo, "O NPS caiu abaixo de 30 nos últimos 30 dias."), a pesquisa e os números do momento — NPS atual, limite configurado, janela analisada e respostas. No fim, o botão Ver no sistema, que abre os Resultados da pesquisa que disparou o alerta (em alerta aplicado a todas as pesquisas, abre a página Alertas). O texto sai no idioma do dono da conta.
O ritmo é o mesmo de qualquer alerta: verificação a cada 30 minutos e, depois de disparar, 6 horas sem repetir. Veja o artigo de Alertas para o que isso significa em cada condição.
O canal é fixo por URL
Esta é a dúvida mais comum. A URL do Incoming Webhook fica amarrada ao canal escolhido no passo 1 — não dá para trocar o canal pelo WiseData NPS. Se você quer os comentários novos num canal e a queda de NPS em outro, gere duas URLs no Slack (uma por canal) e crie dois alertas, cada um com a sua.
Combinando com e-mail e webhook
Os métodos não são excludentes: o mesmo alerta pode ir para o Slack, para até 3 e-mails e para um webhook ao mesmo tempo. É comum usar o Slack para a reação rápida do time e o e-mail para quem acompanha de forma menos frequente. Desligar Slack numa edição remove a URL do alerta.
Se os avisos pararem de chegar
Quando alguém remove o app do Slack ou revoga o webhook, as mensagens deixam de chegar. O sistema tenta entregar até 3 vezes; se todas falharem, o card do alerta mostra Última entrega falhou. Passe o mouse sobre o aviso para ver o destino e o motivo — por exemplo, "Slack: HTTP 404". Nesse caso, gere uma URL nova pelo passo 1 e atualize o alerta. O aviso some sozinho na próxima entrega bem-sucedida no Slack; uma entrega que dá certo no webhook não apaga a falha do Slack, e vice-versa.
Segurança
Trate a URL do Incoming Webhook como uma senha: quem tiver ela consegue postar mensagens naquele canal. Ela fica guardada de forma criptografada e só é exibida para o administrador da conta.
Para onde ir depois
- Alertas — as condições e com que frequência cada uma avisa.
- Enviar alertas para um webhook — o mesmo aviso no seu próprio sistema.
Resumindo: gere um Incoming Webhook no Slack para o canal desejado, cole a URL no alerta com Slack ligado, e use uma URL por canal.