設定すること
- Elido Slackアプリ — ワークスペースの1つにOAuthでインストールされ、ワークスペースのKMSキーで保存時に暗号化されます。
/shortenスラッシュコマンド — 任意のチャンネルまたはDMでインラインにリンクを作成し、オプションでタグを付けられます。- クリックしきい値・スキャン失敗・期限警告のアラートを選択したチャンネルに送信します。
Elido Slackアプリは2つの機能を提供します：任意のチャンネルで /shorten スラッシュコマンドを使えるようにすること、および選択したチャンネルにクリックしきい値とスキャン失敗のアラートを送信することです。設定には約2分かかります。
アプリをインストールする#
- Elidoダッシュボードで Settings → Notifications に移動します。
- Add to Slack をクリックします。SlackのOAuth画面が開きます。
- インストール先のワークスペースを選択します。Slackワークスペースの管理者である必要があります。管理者でない場合は承認を求めてください。
- リクエストされたスコープ —
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チャンネルまたはDMで入力します：
/shorten https://example.com/very-long-path
Elidoはスレッドで短縮リンクとクリック数（新規リンクは0）を返信します。リンクはデフォルトワークスペースにタグなしで作成されます。タグを適用するにはスペースの後に追加します：
/shorten https://example.com/path tag:newsletter
コマンドはプランのクリックキャップとカスタムドメインの設定を尊重します。Freeプランの場合、リンクは f.elido.me を使用します。
アラートしきい値を設定する#
Settings → Notifications → Slack に移動します。各リンクまたはキャンペーンに対して設定できます：
- Click threshold — リンクがNクリックを超えたときに投稿。
- Scan failure — URLスキャナーが宛先を悪意のあるものとしてフラグを立てたときに投稿。
- Expiry warning — リンクの期限が切れる24時間前に投稿。
各アラートにはリンクのスラグ、イベントタイプ、アナリティクスビューへの直接リンクが含まれます。
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ワークスペースでアプリ承認が有効になっています。インストールが完了する前に、管理者が slack.com/apps でElidoアプリを承認する必要があります。
アラートが重複する — 同じSlackワークスペースに2つのElidoワークスペースがある場合、それぞれが独自のアラートを発火します。アラートが不要なワークスペースからインテグレーションを削除してください。