v2.4.0 リリースノート

本日 7 月 7 日、七夕。夜空の願いは届いたでしょうか。

BotShade を v2.4.0 に更新いたしました。本リリースでは、皆さまの Bot に「秘密の願い」を安全に託せる仕組み — Bot 環境変数 をお届けします。あわせて、カスタムコマンドから 外部の Web サービスを呼び出せる新ノード、ログイン画面の刷新、/nuke の不具合修正など、Bot 運営の幅をさらに広げる更新をご用意しました。

お気づきの点がございましたら サポート よりお気軽にご報告ください。

本記事の目次:

• ハイライト
• Bot 環境変数
• カスタムコマンドから外部 Web API を呼び出せる apiReq ノード
• ログイン・登録画面を統合
• Bot の起動・停止・再起動まわりを刷新
• 近日提供予定 — Bot ステータス / Activity 設定
• ベータ期間中の暫定プラン付与を終了
• 修正された不具合
• 互換性について
• サポート・コミュニティ

ハイライト

• Bot 環境変数 — Bot ごとに API キーやトークン等の機密情報を安全に保管し、カスタムコマンドから {env.NAME} の記法で参照できるようになりました。
• apiReq ノード — カスタムコマンドから 外部の Web API を呼び出す ためのノードを追加しました。天気・翻訳・ゲームの戦績など、外部サービスと連携する Bot が作れます。
• ログイン・登録画面を統合 — これまで別々だった /login と /register を /auth に統合し、行き来なしに完結できるようになりました。読み込み中の表示も、実際の進行状況に合わせて更新されます。
• Bot の起動・停止・再起動まわりを刷新 — ステータス表示や再起動フローが、より安定した新しい仕組みに切り替わりました。「取得中」のまま動かなくなる不具合の速やかな修正も含まれます。
• 近日提供予定 — Bot ステータス / Activity 設定 — Bot の Discord 上での「オンライン状態」や「〜をプレイ中」などの表示を、ダッシュボードから設定できる機能を追加しました。近日提供予定の有料プランに含まれる機能 として、順次ご利用いただけるようになります。
• ベータ期間中の暫定プラン付与を終了 — ベータ期間中、暫定的にすべてのお客様に有料プラン相当の機能をご提供してきましたが、本リリースをもってこの暫定措置を終了し、全てのお客様を「BotShade Free」プランへ設定 させていただきました。
• /nuke を使用したときに チャンネルの並び順（位置）が失われてしまう 不具合を修正しました。

Bot 環境変数

Bot ごとに、API キー・パスワード・URL などの機密情報を安全に保管し、カスタムコマンドの定義から参照できる 新機能を追加しました。ダッシュボードにそっと短冊を吊るすようなイメージで、Bot 詳細ページ → 環境変数 から追加・編集・削除できます（人の目に触れない場所に、しっかりしまっておきます）。

• 保管された値そのものはダッシュボード上に 平文で再表示されません。編集は「新しい値の上書き」のみ受け付ける、いわゆる secrets（機密値） としての取り扱いです。
• カスタムコマンドの定義や送信メッセージの中では、{env.NAME} の記法で環境変数を参照できます（NAME は登録した変数名）。
• 予約名の {env.BOT_TOKEN} は、その Bot 自身のトークンを参照します。カスタムコマンドから、その Bot 自身として追加の Discord API 操作を行いたい場合にご利用ください。
• 環境変数への参照は、次にご紹介する apiReq ノード の URL・ヘッダー・ボディからも利用できます。API キーをコマンド定義に直書きすることなく、外部サービスと連携できるようになります。

想定される使い方

• 天気予報 API のキーを環境変数として保管し、コマンドから 今日の天気 を返す
• 翻訳 API のキーを保管し、/translate 相当のカスタムコマンドを組み立てる
• Bot 独自の Web ダッシュボードや監視サービスの認証トークンを保管し、apiReq ノードから通知を送る

カスタムコマンドから外部 Web API を呼び出せる apiReq ノード

カスタムコマンドのビルダーに、外部の Web API を呼び出す apiReq ノード を追加しました。これまで Bot の内側だけで完結していたコマンドから、天の川を渡って外のサービスへ リクエストを送れるようになります。GET / POST 等のリクエストを組み立て、返ってきた JSON をコマンドの後続処理に流し込むことができます。

• URL / メソッド / ヘッダー / ボディ を、これまでのノードと同じ流れで指定できます。それぞれの入力欄では Bot 環境変数（{env.NAME}）や、コマンドの入力・変数 を差し込むことができます。
• レスポンスの JSON は、後続のノードから フィールド指定でそのまま取り出せます。取り出した値はメッセージや Embed の中に埋め込めるので、たとえば「天気 API を呼び出して → 気温を Embed に表示 → 傘のアイコンをつける」といった複合コマンドが作れます。
• 外部への通信は、安定性の観点から BotShade 側のネットワーク経路 を経由します（ユーザー側では特別な設定は必要ありません）。応答が長時間返らない場合は、自動的に打ち切って安全に処理を終了します。

外部サービスと組み合わせるカスタムコマンドの表現力が、大きく広がるアップデートです。

ログイン・登録画面を統合

これまでダッシュボードでは、/login（ログイン） と /register（新規登録） の 2 つの画面を行き来する構成でした。今回、両者を /auth の単一画面 に統合しました。織姫と彦星の逢瀬は年に一度ですが、ログインと新規登録は今日以降、いつでも同じ場所でお会いいただけます。

• ログインと新規登録を、画面遷移なしに切り替え られます。パスキー・ソーシャルログインのいずれも、同じ画面から選択できます。
• ログイン処理中に表示する プログレス（進捗）表示 を、実際の進行状況に合わせて更新 するようにしました。「認証中…」の表示が長時間止まって見える、といった違和感を解消しています。

既存のリンク（/login / /register）にも引き続きアクセス可能で、自動的に /auth に案内されます。

Bot の起動・停止・再起動まわりを刷新

ダッシュボードから Bot を 起動・停止・再起動 する周辺の表示と動作を、より安定した新しい基盤に切り替えました。

• 本番環境で、Bot のステータス表示が 「取得中」のまま動かなくなる ことがあった不具合を、速やかに修正しました。
• Bot の状態表示は、より早く正確に 現在の状態 を反映するようになりました。
• 起動・停止・再起動のリクエスト中に 時間がかかる場合の表示 を改善し、進行状況が分かりやすくなっています。
• 再起動でエラーが発生した場合に、原因ごとに分けた案内 が表示されるようになりました。

近日提供予定 — Bot ステータス / Activity 設定

Bot の Discord 上での見え方 — オンライン状態（オンライン / 退席中 / 取り込み中 / オフライン）と、名前の下に表示される アクティビティ（「〜をプレイ中」「〜を視聴中」「〜を配信中」「〜を聴取中」「カスタム表示」）を、ダッシュボードから設定できる新機能を追加しました。

• 5 種類のアクティビティ表示に対応し、それぞれのテキストを自由に設定できます。
• アクティビティのテキストには、サーバー名などの変数（{Guild.name} など）を差し込めます。サーバーごとに異なる情報を表示できます。
• 設定の変更は、Bot の再起動なし に反映される仕組みになっています。

本機能は、近日提供予定の有料プランに含まれる機能 として、順次ご利用いただけるようになります。有料プランのご提供開始時期については、改めてお知らせいたします。

ベータ期間中の暫定プラン付与を終了

これまで ベータ期間中の暫定措置 として、すべてのお客様に有料プラン相当の機能を無料でお試しいただけるよう設定しておりました。本リリース (v2.4.0) をもって、この 暫定的なプラン付与を終了 し、全てのお客様を「BotShade Free」プランへ設定 させていただきました。

• お客様が作成された Bot 設定、コマンド、応答テンプレート等のデータは、引き続きそのまま保持 されます。
• 有料プラン相当の機能をご利用いただいていた場合、本リリース以降は Free プランでご利用可能な範囲でのご提供となります。
• 有料プランのご提供開始時期については、改めてお知らせいたします。

本件について、ベータ期間中に BotShade をご愛用いただき、貴重なフィードバックをお寄せいただきましたすべてのお客様に、心より感謝申し上げます。

修正された不具合

/nuke 使用時にチャンネル位置が失われる不具合を修正

/nuke（チャンネル内の削除＋再作成）を実行したときに、元のチャンネルがサーバー内のどの位置にあったか（並び順）が保持されず、リスト末尾に移動してしまうことがある不具合を修正しました。今後は、再作成後のチャンネルは 元と同じ位置 に戻ります。

ダッシュボード側の細かな調整

• Bot 環境変数の追加・削除の直後に、コマンド定義側の 変数セレクター（選択候補） が更新されない場合があった動作を修正しました。追加後すぐにコマンド編集で参照できるようになっています。
• 一部ボタンの 待機中スピナー が背景と同化して見えにくかった配色を調整しました。

互換性について

これまでご利用いただいていた Bot やカスタムコマンドの定義は、v2.4.0 でもそのまま動作いたします。お客様側での移行作業や設定変更は不要です。

{env.NAME} の記法・{env.BOT_TOKEN} の予約名・apiReq ノードは v2.4.0 で新しく利用可能 になった機能で、既存の定義には影響しません。

サポート・コミュニティ

ご質問・不具合のご報告・機能のご要望は、以下のいずれかからお気軽にお寄せください。

• サポートページ — お問い合わせフォーム
• status.botshade.com — サービスの稼働状況

短冊の願いは叶いましたでしょうか。夜空を渡る七夕は年に一度ですが、BotShade は今日も明日も、皆さまのサーバーで動き続けます。今後とも BotShade をどうぞよろしくお願い申し上げます。