Що ви налаштуєте
- Додаток Elido для Slack — встановлений через OAuth у вашому робочому просторі, зашифрований при зберіганні за допомогою ключа KMS вашого робочого простору.
- Слеш-команду
/shorten, яка створює посилання прямо з будь-якого каналу або особистих повідомлень, з необов'язковими тегами. - Сповіщення про поріг кліків, помилки сканування та попередження про закінчення терміну дії, що надсилаються в обраний вами канал.
Додаток Elido для Slack виконує дві функції: надає вам слеш-команду /shorten у будь-якому каналі та надсилає сповіщення про поріг кліків і помилки сканування в обраний вами канал. Налаштування займає близько двох хвилин.
Встановлення додатка#
- Перейдіть до Settings → Notifications на дашборді Elido.
- Натисніть Add to Slack. Це відкриє екран OAuth у Slack.
- Виберіть робочий простір, у який ви хочете встановити додаток. Ви повинні бути адміністратором робочого простору Slack або попросити адміністратора схвалити встановлення.
- Перегляньте запитувані дозволи (scopes) —
chat:write,commands,incoming-webhook,users:read— і натисніть Allow. - Slack перенаправить вас назад до Elido. Ви побачите зелену позначку та назву робочого простору.
Токен OAuth шифрується при зберіганні за допомогою ключа KMS вашого робочого простору. Elido не зберігає ваші повідомлення у Slack.
Вибір каналу для сповіщень#
- У Settings → Notifications знайдіть розділ Slack.
- Натисніть Edit channel.
- Виберіть будь-який публічний канал зі списку або вставте ID приватного каналу. Для приватних каналів потрібно спочатку запросити бота Elido (
/invite @Elidoу цьому каналі). - Натисніть Save. Надішліть тестове сповіщення за допомогою кнопки Test — повідомлення має надійти протягом 3 секунд.
Використання команди /shorten#
У будь-якому каналі або особистих повідомленнях Slack введіть:
/shorten https://example.com/very-long-path
Elido відповість у гілці (thread) коротким посиланням і кількістю кліків (0 для нових посилань). Посилання створюється у вашому стандартному робочому просторі без тегів. Щоб додати тег, вкажіть його через пробіл:
/shorten https://example.com/path tag:newsletter
Команда враховує обмеження кліків вашого тарифного плану та налаштування власного домену. Якщо ви користуєтеся планом Free, посилання використовуватиме f.elido.me.
Налаштування порогів сповіщень#
Перейдіть до Settings → Notifications → Slack. Для кожного посилання або кампанії ви можете встановити:
- Click threshold — публікувати, коли посилання перевищує N кліків.
- Scan failure — публікувати, коли наш сканер URL позначає цільову сторінку як шкідливу.
- Expiry warning — публікувати за 24 години до закінчення терміну дії посилання.
Кожне сповіщення містить слаг (slug) посилання, тип події та пряме посилання на перегляд аналітики.
Видалення доступу Slack#
- В Elido: Settings → Notifications → Slack → Disconnect.
- У Slack (для надійності): Workspace settings → Connected apps → Elido → Remove.
Відключення з боку Elido негайно зупиняє всі сповіщення та слеш-команди. Токен Slack OAuth видаляється з нашої бази даних протягом 60 секунд.
Усунення несправностей#
/shorten повертає "dispatch_failed" — додаток Elido не встановлено в цьому робочому просторі. Попросіть свого адміністратора Slack схвалити встановлення.
Сповіщення не надходять — переконайтеся, що цільовий канал усе ще доступний. Elido реєструє помилки доставки у Settings → Notifications → Delivery log. Видалений канал або приватний канал, з якого було видалено бота, є двома найпоширенішими причинами.
Екран OAuth повідомляє "This app is not approved" — у вашому робочому просторі Slack увімкнено схвалення додатків. Адміністратор повинен схвалити додаток Elido за адресою slack.com/apps, перш ніж встановлення буде завершено.
Дубльовані сповіщення — якщо у вас є два робочих простори в одному Slack, кожен із них надсилає власні сповіщення. Видаліть інтеграцію з того робочого простору, від якого ви не хочете отримувати сповіщення.