Discord quiz chatbot

2020 年 CCNS QA 活動用的， 於 discord 平台上的聊天機器人， 用 discord.js 寫成。

discord.js 入門可以看 https://discordjs.guide ， api 文件則看 https://discord.js.org/#/docs/main/stable/general/welcome 。 另外 api 中有用到一個型別 collection， 不知道為什麼原本在文件裡的連結連不過去，一直找不到這個類的 api。 後來手動在左上角切成 View docs for Collection master 才看到 https://discord.js.org/#/docs/collection/master/class/Collection 。

後端與資料庫介接的介面是配合 2020 年的後端 ， 當時 api 介面版本是 v1。

執行

echo http://api.url/path > api.url
echo XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX > discord.token
node index.js api.url token response-database.json

chatbot 管理

由於 discord 的限制，不能直接將 bot 加為好友。（應該吧） 需先與該 bot 在同一伺服器，就能與之對話。

管理員可以透過 管理介面 將 bot 加入伺服器， 或直接進入 bot 所在 測試伺服器 與 bot 對話。

與 chatbot 在同一伺服器後， 用 @escho#1145 /start 對 bot 下指令即可開始答題。

與 bot 的答題在私人聊天中進行， 在私人聊天中下指令不需再加 @escho#1145 。

chatbot 指令

在與 bot 一對一私人訊息中可以直接用 /somecommand 的格式下指令； 在公頻中需要在指令前標注 @escho#1145 /somecommand bot 才會回應。

• 直接回覆以 0-3 a-d A-D 開頭的訊息回答
• 或按題目下的 emoji 反應 A B C D 回答
• /start 開始答題
• /status 看自己的答題狀況
• /help 指令說明
• /statistic 排行榜

答對會對你的訊息按讚（大拇指），答錯則是向下的大拇指； 然後回覆事先錄製的對白，延時一秒後送出下一題。

delay echo 對話系統

若是在公頻 @ 本機器人，或是在私頻直接對話， 但內容沒有用 / 開頭下指定， 機器人會回覆上一次 @ 本機器人的非指定內容， 也就是一個簡單的延遲回覆對話系統，可以簡單製造在對話的錯覺。

公開頻道

gholk: @escho hey
gholk: @escho how are you?
escho: @gholk, @escho hey
gholk: @escho how about your loading?
escho: @gholk, @escho how are you?
gholk: @escho i am fine
escho: @gholk, @escho how about your loading?

私人對話

gholk: hey
gholk: what?
escho: hey
gholk: ??
escho: what?
gholk: i say hey
escho: ??
gholk: ...
escho: i say hey
gholk: hey!!
escho: ...

大量私訊功能

腳本 broadcast-dm.js 可以用來發私訊。

node broadcast-dm.js token-file \
'我們是電腦與網路愛好社 CCNS，感謝您遊玩本遊戲。
期待能在社博以及社大與您相見！
社大時間為 2020-09-24 晚上，歡迎你！' \
    330360675291496448 365456618080567297

參數是 token 檔名、訊息，其餘是 discord 的數字 user id。 以 ccns 社博來說，可以從 database 的 username 撈。

node -p 'JSON.parse(process.argv[1]).data
    .filter(u => u.platform == "discord")
    .map(u => u.name.replace(/discord-/,"")).join("\n")' \
    "$(curl --silent $api_url/players)" \
| xargs node broadcast-dm.js token-file "$message"