Что вы настроите
- Приложение Elido для Slack, установленное в ваше рабочее пространство Slack через OAuth.
- Однократную привязку Slack к вашему рабочему пространству Elido по API-ключу (
/elido link). - Слэш-команду
/elido, чтобы сократить URL и посмотреть клики по ссылке за последние 24 часа.
Приложение Elido для Slack даёт одну слэш-команду, /elido, чтобы сокращать URL и смотреть число кликов, не выходя из Slack.
Установите приложение
Установите приложение Elido в своё рабочее пространство Slack из дашборда Elido или из каталога приложений Slack. Вы должны быть администратором рабочего пространства Slack или попросить администратора одобрить установку. Приложение запрашивает разрешения commands, chat:write, users:read и app_mentions:read. Токен Slack OAuth хранится в зашифрованном виде.
Свяжите Slack с рабочим пространством Elido
Приложение Slack не знает, какое рабочее пространство Elido использовать, пока вы не свяжете их один раз:
- В Elido создайте API-ключ в Settings → API Keys.
- В любом канале Slack выполните:
/elido link <api-key>
- Elido проверит ключ и свяжет Slack с первым рабочим пространством, к которому у ключа есть доступ. Сообщение видно только вам, а ключ хранится в зашифрованном виде.
Сократите ссылку
/elido https://example.com/very-long-path
Elido ответит короткой ссылкой, видимой только вам. Ссылка создаётся в связанном рабочем пространстве на домене редиректа по умолчанию, настроенном для приложения Slack. Теги и пользовательские slug в команде не поддерживаются.
Посмотрите клики по ссылке
/elido stats <slug>
Отвечает общим числом кликов и уникальных посетителей за последние 24 часа для этого slug.
Удаление доступа Slack
- В Slack: Workspace settings → Connected apps → Elido → Remove.
- В Elido: отзовите API-ключ, использованный для
/elido link, в Settings → API Keys.
Отзыв ключа немедленно прекращает создание ссылок через слэш-команду.
Устранение неполадок
/elido просит сначала выполнить привязку - Выполните /elido link <api-key> один раз в рабочем пространстве Slack.
/elido link сообщает, что у ключа нет рабочих пространств - У пользователя ключа пока нет рабочего пространства. Сначала создайте его в Elido.
/elido возвращает «dispatch_failed» - Приложение Elido не установлено в этом рабочем пространстве. Попросите администратора Slack одобрить установку.
Экран OAuth сообщает «This app is not approved» - В вашем рабочем пространстве Slack включено одобрение приложений. Администратору нужно одобрить приложение Elido на slack.com/apps, после чего установку можно завершить.