Notion Unfurl bot

手順

1. 必要な node_modules のインストール

   npm i -g yarn
   yarn install
   

2. http://api.slack.com/apps?new_app=1 にアクセスして Slack アプリの作成

   • manifest.yaml の内容をコピーすると以降の手順を省略可能
   • FYI: Create and configure apps with manifests

3. App Credentials の Signing Secret をコピーしておく

4. OAuth % Permissions に移動、 Bot Token Scopes に以下を追加

   • links:read
   • links:write

5. Socket Mode に移動、Enable Socket Mode をオンに FYI: Slack ソケットモードの最も簡単な始め方

6. Install App に移動、 Install to Workspace ボタンからアプリをインストール

   • Bot User OAuth Access Token をコピーしておく

7. Notion のトークンの取得

   • 参考: トークンの取得方法 / How to get your token

8. コピーしていたものを環境変数としてセット (.env を使う際は cp _env .env 後に値をセット)

   • SLACK_BOT_TOKEN: Bot User OAuth Access Token
   • SLACK_SIGNING_SECRET: Signing Secret
   • SLACK_APP_TOKEN: Socket Mode
   • NOTION_TOKEN: 上記で取得した Notion の token

9. bot の起動

   yarn build && yarn start
   

10. bot へのリクエストの forward (Socket Mode ではない場合のみ)

    • ngrok などを利用

      ngrok http 3000
      

      https://xxxxxxxxxxxx.ngrok.io のような URL が発行されるためそれをコピーしておく

11. 再び Slack アプリの設定画面に戻り Event Subscriptions に移動、チェックボックスを有効化して以下の設定を追加 (Socket Mode ではない場合のみ)

    • Request URL に ngrok などが発行した URL + /slack/events を入力 (例: https://xxxxxxxxxxxx.ngrok.io/slack/events)
    • Subscribe to bot events に link_shared を追加
    • App unfurl domains に notion.so を追加

12. 再インストールする旨のバナーが出てくるのでリンクから再インストールの実行