Conectar Slack ao Elido

O app Elido para Slack faz duas coisas: fornece um comando slash /shorten em qualquer canal e publica alertas de limite de cliques e falhas de scan em um canal de sua escolha. A configuração leva cerca de dois minutos.

Instalar o app#

1. Vá para Settings → Notifications no dashboard do Elido.
2. Clique em Add to Slack. A tela de OAuth do Slack é aberta.
3. Selecione o workspace onde deseja instalar. Você precisa ser administrador do workspace Slack, ou pedir a um administrador que aprove a instalação.
4. Revise os escopos solicitados — chat:write, commands, incoming-webhook, users:read — e clique em Allow.
5. O Slack redireciona você de volta ao Elido. Você verá uma marca de verificação verde e o nome do workspace.

Nota: O token OAuth é criptografado em repouso com a chave KMS do seu workspace. O Elido não armazena suas mensagens do Slack.

Escolher um canal para alertas#

1. Em Settings → Notifications, encontre a seção do Slack.
2. Clique em Edit channel.
3. Escolha qualquer canal público da lista, ou cole um ID de canal privado. Canais privados exigem que o bot do Elido seja convidado primeiro (/invite @Elido naquele canal).
4. Clique em Save. Envie uma notificação de teste com o botão Test — espere uma mensagem em 3 segundos.

Usar o comando /shorten#

Em qualquer canal ou DM do Slack, digite:

/shorten https://example.com/very-long-path

O Elido responde na thread com o link curto e a contagem de cliques (0 para novos links). O link é criado no seu workspace padrão sem tags. Para aplicar uma tag, adicione-a após um espaço:

/shorten https://example.com/path tag:newsletter

O comando respeita as configurações de limite de cliques e domínio personalizado do seu plano. Se você estiver no plano Free, o link usa f.elido.me.

Configurar limites de alerta#

Vá para Settings → Notifications → Slack. Para cada link ou campanha, você pode definir:

• Click threshold — publicar quando um link ultrapassar N cliques.
• Scan failure — publicar quando nosso scanner de URL marcar um destino como malicioso.
• Expiry warning — publicar 24 horas antes de um link expirar.

Cada alerta inclui o slug do link, o tipo de evento e um link direto para a visualização de analytics.

Remover o acesso do Slack#

1. No Elido: Settings → Notifications → Slack → Disconnect.
2. No Slack (por precaução): Workspace settings → Connected apps → Elido → Remove.

Desconectar pelo Elido para imediatamente todas as alertas e comandos slash. O token OAuth do Slack é excluído do nosso banco de dados em 60 segundos.

Solução de problemas#

/shorten retorna "dispatch_failed" — O app Elido não está instalado neste workspace. Peça ao seu administrador do Slack para aprovar a instalação.

Alertas não chegando — Verifique se o canal de destino ainda está acessível. O Elido registra falhas de entrega em Settings → Notifications → Delivery log. Um canal excluído ou um canal privado do qual o bot foi removido são as duas causas mais comuns.

A tela OAuth diz "This app is not approved" — Seu workspace Slack tem aprovação de apps habilitada. Um administrador precisa aprovar o app Elido em slack.com/apps antes que a instalação possa ser concluída.

Alertas duplicados — Se você tem dois workspaces do Elido no mesmo workspace Slack, cada um dispara seus próprios alertas. Remova a integração do workspace do qual não deseja alertas.