Slack
メッセージを送る・読む。Slack から kokuban の人たちと話せる
- 作るもの
- kokuban のマニフェストから作る自分の Slack アプリと、その 2 つのトークン
- 作る場所
- https://api.slack.com/apps?new_app=1
- コマンド
kokuban connect slack
手順
- kokuban が出すマニフェストを写す(kokuban connect slack --manifest でもう一度出せます)マニフェストが頼むのは、kokuban が使うものだけです。送る、入っているチャンネルと DM を読む、書いた人を調べる。
- 開いたページで From a manifest を選び、ワークスペースを選んで貼り付け、作る
- Install to Workspace を押し、Bot User OAuth Token(xoxb-…)を写す
- Basic Information の App-Level Tokens で Generate を押し、connections:write を付けて作る(xapp-…)ソケットモードにはこのトークンが要ります。kokuban の側から Slack につなぐので、外からあなたの PC に届くものはありません。
つなぐ
kokuban connect slackkokuban が鍵を聞きます(貼っても画面には出ません)。鍵は OS の金庫に入れ、すぐに試します。鍵にできないことがあれば、何を変えればよいかを言います。
kokuban の画面の接続の一覧には、まだつないでいないサービスも並びます。開いて y を押すと、画面がターミナルをこのコマンドに渡します。
知っておくこと
- kokuban は 2 つのトークンを順に聞きます。貼っても画面には出ません。
- Slack から kokuban の人たちと話すには、slack.chat にこの接続を設定します。アプリに DM を送るか、チャンネルに /invite @kokuban してメンションします。1 つのスレッドが 1 つの会話です。
- 初めて誰かがアプリに話しかけると、kokuban の受信箱が「あなたですか?」と聞きます。接続の画面の Slack の接続に「あなた」として扱う人が並び、「not me」で取り消せます。
うまくいかないとき
アプリをチャンネルに招待するか(/invite @kokuban)、OAuth & Permissions で足りない権限を足してインストールし直してください
kokuban connections で、すべての接続を確かめ、手当てが要るものを教えます。
やめるとき
kokuban disconnect slack@hq を実行し、api.slack.com/apps でアプリを開いてワークスペースから外します(アプリごと消しても構いません)。