Qué vas a configurar
- La app de Elido para Slack, instalada en tu workspace de Slack con OAuth.
- Una vinculación única entre Slack y tu workspace de Elido mediante una clave de API (
/elido link). - El comando slash
/elidopara acortar una URL y consultar los clics de un enlace en las últimas 24 horas.
La app de Elido para Slack te da un único comando slash, /elido, para acortar URL y consultar el número de clics sin salir de Slack.
Instalar la app
Instala la app de Elido en tu workspace de Slack desde el panel de Elido o desde el listado de apps de Slack. Debes ser administrador del workspace de Slack, o pedirle a uno que apruebe la instalación. La app solicita los scopes commands, chat:write, users:read y app_mentions:read. El token OAuth de Slack se almacena cifrado en reposo.
Vincular Slack a tu workspace de Elido
La app de Slack no sabe qué workspace de Elido usar hasta que la vinculas una vez:
- En Elido, crea una clave de API en Settings → API Keys.
- En cualquier canal de Slack, ejecuta:
/elido link <api-key>
- Elido comprueba la clave y vincula Slack al primer workspace al que la clave tenga acceso. El mensaje solo lo ves tú, y la clave se almacena cifrada.
Acortar un enlace
/elido https://example.com/very-long-path
Elido responde con el enlace corto, visible solo para ti. El enlace se crea en el workspace vinculado, en el dominio de redirección por defecto configurado para la app de Slack. El comando no admite etiquetas ni slugs personalizados.
Consultar los clics de un enlace
/elido stats <slug>
Responde con el total de clics y los visitantes únicos de las últimas 24 horas para ese slug.
Quitar el acceso de Slack
- En Slack: Workspace settings → Connected apps → Elido → Remove.
- En Elido: revoca la clave de API que usaste para
/elido linken Settings → API Keys.
Al revocar la clave, el comando slash deja de crear enlaces de inmediato.
Solución de problemas
/elido te pide vincular primero: Ejecuta /elido link <api-key> una vez en el workspace de Slack.
/elido link dice que la clave no tiene workspaces: El usuario de la clave aún no tiene ningún workspace. Crea uno primero en Elido.
/elido devuelve "dispatch_failed": La app de Elido no está instalada en este workspace. Pide a tu administrador de Slack que apruebe la instalación.
La pantalla de OAuth dice "This app is not approved": Tu workspace de Slack tiene activada la aprobación de apps. Un administrador debe aprobar la app de Elido en slack.com/apps antes de que la instalación pueda completarse.