設定すること
- OAuthでSlackワークスペースにインストールするElido Slackアプリ。
- APIキー（
/elido link）を使った、SlackとElidoワークスペース間の1回限りのリンク。 - URLを短縮し、リンクの過去24時間のクリック数を確認するための
/elidoスラッシュコマンド。
Elido Slackアプリには、Slackを離れずにURLを短縮してクリック数を調べられるスラッシュコマンド /elido が1つあります。
アプリをインストールする
Elidoダッシュボード、またはSlackのアプリ一覧から、ElidoアプリをSlackワークスペースにインストールします。Slackワークスペースの管理者であるか、管理者にインストールの承認を依頼する必要があります。アプリは commands、chat:write、users:read、app_mentions:read のスコープを要求します。SlackのOAuthトークンは、保存時に暗号化されます。
SlackをElidoワークスペースにリンクする
Slackアプリは、一度リンクするまで、どのElidoワークスペースを使うかを認識しません。
- Elidoで、Settings → API KeysからAPIキーを作成します。
- 任意のSlackチャンネルで、次を実行します：
/elido link <api-key>
- Elidoはキーを確認し、そのキーがアクセスできる最初のワークスペースにSlackをリンクします。メッセージはあなたにだけ表示され、キーは暗号化されて保存されます。
リンクを短縮する
/elido https://example.com/very-long-path
Elidoは、あなたにだけ見える形で短縮リンクを返信します。リンクは、リンク済みのワークスペースに、Slackアプリ用に設定された既定のリダイレクトドメインで作成されます。コマンドでは、タグやカスタムスラッグはサポートされていません。
リンクのクリック数を確認する
/elido stats <slug>
そのスラッグの、過去24時間の総クリック数とユニーク訪問者数を返信します。
Slackのアクセスを削除する
- Slackで：Workspace settings → Connected apps → Elido → Remove。
- Elidoで：Settings → API Keysから、
/elido linkに使用したAPIキーを失効させます。
キーを失効させると、スラッシュコマンドによるリンクの作成はただちに停止します。
トラブルシューティング
/elido が先にリンクするよう求める。 Slackワークスペースで、/elido link <api-key> を一度実行してください。
/elido link が、キーにワークスペースがないと表示する。 キーのユーザーにまだワークスペースがありません。先にElidoで作成してください。
/elido が「dispatch_failed」を返す。 このワークスペースにElidoアプリがインストールされていません。Slackの管理者にインストールの承認を依頼してください。
OAuth画面に「This app is not approved」と表示される。 Slackワークスペースでアプリの承認が有効になっています。インストールを完了する前に、管理者がslack.com/appsでElidoアプリを承認する必要があります。