FIXER cloud.config Tech Blog

Azure FunctionsでサーバーレスDiscord Botを作る

2023年01月20日 10時00分更新

文● 髙橋一樹／FIXER

　本記事はFIXERが提供する「cloud.config Tech Blog」に掲載された「Azure FunctionsでサーバーレスDiscord Botを作る」を再編集したものです。

　FIXER Rookies Advent Calendar 2022の12日目の記事です。

　早速ですが皆さんDiscord使ってますか？　私は友人と雑談するためによく使っています。特に目的があって会話する訳でもないですが、雑につないでいられる通話サービスというのはいいものですね。最近友人がスプラで温まってうるさかったりもするのですが(通話を分けろ)。

　さて、DiscordにはBotというものが存在します。自動でメッセージの送信やロールの付与など、色々勝手にやってくれる便利なやつです。ちょっと検索すればいくらでも便利なBotが出てきて、導入も容易なのでDiscordサーバーの使い勝手が良くなること間違いなしです。

　ですが、目的に合ったものが見つかるとは限らないのがこの世の常。かくいう私も欲しい機能と微妙に合致しているものがなかったという経験があります。ではどうするのかといえば自作ですね。ほぼ常時Discordに接続している身からすると、Discordにコマンド打ち込んでちょっとした計算やランダム生成をしてくれると嬉しいわけです。という事で今回はDiscord Botの作り方を紹介します。

　まずはWebサーバーを用意してめんどくせ～～～～～～～～

　すみません、面倒くさくなりました。冗談はさておき私も初めてDiscord Botを作った時もサーバー用意の段階で大分手間取った記憶があります。まぁ今となっては便利なサービスもいくつかあるのでそれを使えばいいとは思うのですが、結構維持費必要だったり、無料にしても制限がきつかったりなどする印象です。一つぐらいならいいですがいくつもDiscord Botを作成しようとなると一個一個サーバーが必要になるのでなかなか面倒になるかと思います。

　そこで今回はAzure Functionsを使ってサーバーレスでさくっとDiscord Botを作る方法を紹介していきます。

　今回記事を書くにあたりこちらの記事(https://zenn.dev/drumath2237/articles/112fd0bfa7ea4f836195)を参考にさせていただきました。

Discord Botの準備

　とりあえずDiscordのBotを用意しましょう。まずDiscord Developer Portalにアクセスして、右上のNew Applicationからアプリケーションの作成をしましょう。今は設定変更の必要はないですが、APPLICATION IDとPUBLIC KEYをどこかに控えておくといいかもです。

　その後Settings>Botページに移ってAdd Botを押すとBotが作成されます。Botを作成したら、ResetTokenを押してトークンのリセットを行い、表示されたトークンを必ず控えておきましょう。このトークンは後から確認することが出来ず、忘れたりしたら再生成することになるので気を付けましょう。

　続いて作成したBotを自分のサーバーに招待します。招待するためにはSettings>OAuth2>URL Generatorのページに移ります。今回はDiscord Slash Commandsを使うのでSCOPESでapplications.commandsを選択します。

　項目を選択すると下の方にURLが自動で作成されますのでこのURLにアクセスしてBotを自分のサーバーに招待していきます。ちなみにこのアクセス許可はサーバーの管理者しかできないので注意してください。URLにアクセスすると追加サーバーやBotへの権限許可などを選択していったら招待完了です。

Slash Commandsの登録

　さてBotを作ったのはいいですが、今のところ何もできないBotなので出来ることを増やしてあげましょう。今回BotへのコマンドとしてSlashCommandsというのを使います。「/」を打てばコマンドがサジェストされる便利なやつです。コマンドの登録なのですが、HTTPリクエストを送る必要があります。

　＜APPLICATION_ID＞の部分には作成したアプリケーションのAPPLICATION IDを入力します。GUILD IDはDiscordサーバーにあるIDなのですが、これを見るためにはDiscordの詳細設定で開発者モードをオンにして、調べたいサーバーを選んで右クリックするとIDのコピーが出来ます。これがギルドIDになりますのでこれを使いましょう。

　＜BOT_TOKEN＞の部分にはBotのトークンが入ります。「Bot」との間にスペースが必要なので気を付けてください。

　bodyでコマンド構造を指定してあげます。中身の詳細な説明については今回は省きます。詳しく知りたい方はDiscord Developer PortalのApplication Commandの項目を見て下さい。
(https://discord.com/developers/docs/interactions/application-commands)

　これらをHTTPリクエストで送ってあげます。送ってあげるとDiscordの方で「/」を打つとコマンドがサジェストされるようになります。作ったコマンドを入力してみてください。以下のように帰ってくるはずです。

　コマンドを登録したのはいいですが、Bot側で何も処理を追加してないので応答してくれないのですね。という事で中身を作っていきます。

Azure Functionsの作成

　という事でAzure Functionsを使ってBotの応答を作っていきましょう。まずはAzure Functionsを作ります。今回はランタイムスタックをNode.js、バージョンは16 LTSにしまして、プランはB1以上を選択しましょう。

　コードはVSCodeで書いていきましょう。VSCodeでAzure周りの作業をするにあたって「Azure Tools」の拡張機能を入れてください。必要なのはAzure Functionsだけなのですが、全部まとめて入れといた方が間違いが無くて良いです。

　Azureの拡張機能を入れるとタブにAzureって項目が出来るので、Azureにログインしたのち、そこのWorkSpaceから「Create Function」を選択してください。するとAzure Functions用のプロジェクトが作られます。今回は言語はTypeScript、トリガーはHTTP trigger、承認レベルはAnonymousにしましょう。

　必要なパッケージをインストールしていきます。sがついていない名前のパッケージもあるそうなので間違えないように気を付けてください

　そしてindex.tsにコードを書いていきます。

　コードが書けたらAzure Functionsにデプロイしていきます。デプロイの方法はいろいろありますが今回はVSCodeから手動で行っていきます。Azureのタブから再びWorkSpaceを見ます。一応LocalProjectが入っているか確認してください。入ってなかったらVSCode再起動すれば映ると思います。Deployを選択し、先ほど作成したAzure Functionsを選択してデプロイしていきます。

　デプロイが完了したら環境変数を登録します。Azure Functionsの設定>構成のアプリケーション設定で追加が出来ます。名前は「CLIENT_PUBLIC_KEY」で、値はDiscordのアプリケーションのパブリックキーを入れましょう。

Discord BotにAzure Functionsの登録

　最後にDiscord BotがAzure FunctionsへHTTPリクエストを投げられるようにしておきます。Discord Depeloper Portalの今回作ったアプリケーションを開いてGeneral Informationの「INTERACTIONS ENDPOINT URL」にAzureFunctionsのトリガーを登録します。URLはAzure Functionsの関数>関数から今回作ったものを選んで、概要の関数のURL取得から行えます。URLを入力して変更のセーブをすると、署名の検証が行われるのでこれが問題なく通れば完了です。

　確認としてDiscordでコマンドを入力してメッセージが正常に出てきたら完成です。