O que você vai configurar
- O app Elido para Slack, instalado no seu workspace do Slack via OAuth.
- Um vínculo único entre o Slack e o seu workspace do Elido usando uma chave de API (
/elido link). - O comando slash
/elidopara encurtar uma URL e consultar os cliques de um link nas últimas 24 horas.
O app Elido para Slack oferece um único comando slash, /elido, para encurtar URLs e consultar a contagem de cliques sem sair do Slack.
Instalar o app
Instale o app Elido no seu workspace do Slack pelo dashboard do Elido ou pela listagem de apps do Slack. Você precisa ser administrador do workspace do Slack, ou pedir a um administrador que aprove a instalação. O app solicita os escopos commands, chat:write, users:read e app_mentions:read. O token OAuth do Slack é armazenado criptografado em repouso.
Vincular o Slack ao seu workspace do Elido
O app do Slack não sabe qual workspace do Elido usar até você vinculá-lo uma vez:
- No Elido, crie uma chave de API em Settings → API Keys.
- Em qualquer canal do Slack, execute:
/elido link <api-key>
- O Elido verifica a chave e vincula o Slack ao primeiro workspace ao qual a chave tem acesso. A mensagem é visível apenas para você, e a chave é armazenada criptografada.
Encurtar um link
/elido https://example.com/very-long-path
O Elido responde com o link curto, visível apenas para você. O link é criado no workspace vinculado, no domínio de redirecionamento padrão configurado para o app do Slack. O comando não aceita tags nem slugs personalizados.
Consultar os cliques de um link
/elido stats <slug>
Responde com o total de cliques e os visitantes únicos das últimas 24 horas para esse slug.
Remover o acesso do Slack
- No Slack: Workspace settings → Connected apps → Elido → Remove.
- No Elido: revogue a chave de API que você usou no
/elido linkem Settings → API Keys.
Ao revogar a chave, o comando slash deixa de criar links imediatamente.
Solução de problemas
/elido pede para vincular primeiro: Execute /elido link <api-key> uma vez no workspace do Slack.
/elido link diz que a chave não tem workspaces: O usuário da chave ainda não tem nenhum workspace. Crie um primeiro no Elido.
/elido retorna "dispatch_failed": O app Elido não está instalado neste workspace. Peça ao administrador do Slack para aprovar a instalação.
A tela de OAuth diz "This app is not approved": Seu workspace do Slack tem a 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.