使用 python & Flask 來實作一個簡單的 Slack bot
- Python3
- pip3
- virtualenv
- Flask
- slackclient
- ngrok
brew cask install ngrok
# create a new virtual envirnment for this project
virtualenv slackbot.env --python=python3
# active the virtual envirnment
source slackbot.env/bin/activate
git clone https://github.com/wen830722/SlackBot-Simplest-Tutorial.git
cd SlackBot-Simplest-Tutorial
pip3 install -r requirements.txt
- 需事前訂閱需要用到的 events，當這些 events 被觸發，Slack 會送 http request 到指定的 URL（Step4會再提到）
- 目的是為了取得 bot token，讓我們能以 bot 的身份來進行後續的動作（例如：發送訊息、查詢user資訊、查詢channel資訊等）
先將Client ID、Client Secret和Verification Token儲存至環境變數中（in your virtual envirnment）。
之後進行驗證程序時會用到，程式會從這些環境變數取得對應的金鑰。
export SLACK_CLIENT_ID='XXXXXXXXXXXXXXXX'
export SLACK_CLIENT_SECRET='XXXXXXXXXXXXXXXX'
export SLACK_VERIFICATION_TOKEN='XXXXXXXXXXXXXXXX'
首先，啟動你的flask app～
python3 app.py
接者使用 ngrok，在 terminal 輸入ngrok http 5000後會自動產生一個網址給你，讓 localhost 也能被外網的其他人連上。
（Flask 的 localhost 預設 port 為5000）
ngrok http 5000
接下來回到Slack App的管理介面，這邊需要自行指定四個不同的URL，分別處理驗證、Slack Events、Slash Commands，以及Interactive Messages
- OAuth & Permissions
這是驗證流程中的一個步驟，簡單來說我們需要拿到一組 code + Clien ID + Client Secret 去交換 Slack 的 API access token。
當完成驗證流程前面的步驟後，Slack 會送出 http get request 到我們指定的 Redirect URL（https://011bd378.ngrok.io/finish_auth?code=XXXXXXXXXXX&state=），有了code，我們就可以去交換token。
- Event Subscriptions
對應到 Step2 所訂閱的 events，例如 channel 中有人傳訊息，當 event 被觸發時，Slack 會發出 http post request 到我們指定的Request URL。
- Slash Commands
建立屬於自己 App 的 Slash Command，跟前面的運作原理一樣，當有人使用/truth，則 Slack 會發出 http post request 到指定的 Request URL。
- Interactive Messages
Interactive Messages 指的是 button 和 menu，這兩個物件讓使用者可以透過點擊的動作達到互動的效果。 跟前面一模模一樣樣，當 button 或是 meau 的選項被點擊，則 Slack 會發出 http post request 到指定的 Request URL。
以上都設定完成後，請先連上https://011bd378.ngrok.io/begin_auth進行驗證的動作～（要用自己拿到的ngrok網址！）
驗證完成後，就可以打開你的 Slack 跟 simplebot 互動啦～ 🎉
- OAuth flow
- Types of tokens
- Slack APIs 筆記
- pythOnBoarding Bot（大部分是參考這篇的教學 👍 )