kbigwheelのプログラミング・ソフトウェア技術系ブログ

プログラミング・ソフトウェア技術系のことを書きます

slack知見

某scalikejdbcな人に教えてもらったslack app周りのノウハウ。 アプリを作りたかったので助かる。 以下の記述が間違っていたとしたら僕の書き間違い・理解の間違い。

  • 認証
    • よく読めばわかるがslack appの認証はOAuth
    • 現在の認証はbot tokenとuser tokenだけでよい
    • bot tokenはすべての権限が付与された新bot tokenと等価。逆に言うと新botトークンは権限が選択式になった旧botトーク
    • user tokenは基本的に使わない。user tokenが必要なのはその人自身の権限でしかできないようなアクションをするとき
      • 例としてはその人に成り代わってpostするときや、一部の管理者権限はbotではもたせられないのでworkspace(team)でのadministrativeなアクションをするときはuser tokenである必要あり
    • workspace tokenは従来のbot tokenを更新する目的で作られかけたがうまくいかずdeprecated。ドキュメント上で言及されたり仕様例が残っているところもあるが使わないこと。
    • botトークンは管理者がインストールしてもユーザーがインストールしても機能が変わらない。
    • 基本的にbotトークンで済む場合はbotトークンを推奨
  • スラッシュコマンドは今後推奨されない?
    • 廃止されることはないが、先日発表されたショートカットのほうがGUIがあり便利なのでそちらを今後は推奨
    • ショートカットとスラッシュコマンドの両方を実装するのはあり
  • slackのドキュメントはナラティブに書くという方針があるらしく、英語ネイティブでないと読みづらかったりその方針のために?古い記述がよく残っている