投票(Poll)

「投票」は、質問と選択肢を設定して投票を作成・編集・終了できる機能です。Bot に投票関連のスラッシュコマンド(/poll create・/poll end・/poll edit)と、メッセージを右クリックして投票を終了するコンテキストメニュー「投票を終了する」を追加します。

ダッシュボードのこのページでは、これらの コマンドとコンテキストメニューの有効状態・権限のみ を設定します。質問文や選択肢、締め切りなど投票の内容は、Discord 上の /poll create で指定します。

「投票」は無料で利用できる機能です。プレミアムへの加入は不要です。

投票で使うコマンド

「既定で必要な権限」は、ダッシュボードの権限設定で上書きできます。

画面を開く

ダッシュボードから設定したい Bot の管理画面を開き、サイドバー(モバイルではメニュー)の「メッセージ」グループにある「投票」を選びます。

機能を有効化する

画面上部の「機能の有効化」スイッチをオンにすると、この機能が使えるようになります。オフのままでも各コマンドの権限設定は行えます。設定は、その下の「コマンド権限設定」「コンテキストメニュー権限設定」の 2 つのカードで行います。

コマンド権限設定

「コマンド権限設定」カードには /poll create・/poll end・/poll edit が折りたたみ(アコーディオン)形式で並んでいます。行をクリックすると詳細設定が開き、「コマンドを有効化」でコマンド自体の有効・無効を、「個別権限設定を有効化」でだれが使えるかを切り替えられます。詳しい操作はコマンド権限設定の使い方(全機能共通)を参照してください。

個別権限設定をしない場合、3 つのコマンドはいずれも実行に「Manage Messages(メッセージの管理)」の Discord 権限が必要です。各コマンドの詳細設定の上部にある「個別設定しない場合の最低Discord権限」枠で、必要な権限を確認できます。

コンテキストメニュー権限設定

「コンテキストメニュー権限設定」カードで「投票を終了する」の行をクリックすると詳細設定が開き、「コンテキストメニューを有効化」でメニュー自体の有効・無効を、「個別権限設定を有効化」でだれが使えるかを切り替えられます。

権限を細かく設定する

「個別権限設定を有効化」をオンにすると「詳細権限設定」が表示され、ホワイト/ブラックのロールリスト・権限リストで利用可否を細かく決められます。ロールの追加・削除、権限条件(AND / OR / STRICT / CONTAINS)の作り方、「Discord権限より個別設定を優先(強制上書き)」の使い方は、コマンド権限設定の使い方(全機能共通)で説明しています。

設定を保存する

設定を変更すると、画面下部に「未保存の変更があります」というバーが表示されます。このバーで「保存」をクリックするまで変更は反映されません。「破棄」をクリックすると保存前の状態に戻ります。

実際の動作と既定値

/poll create で指定する項目

/poll create では次の項目を指定します。

選択肢のカンマ区切りでは、前後の空白は自動的に取り除かれ、空の項目は無視されます。選択肢のラベルには絵文字や記号もそのまま使えます。

表示形式・投票ルール・期間の単位には自動で入る既定値はありません。/poll create のたびに、それぞれを選んで指定してください。

投票方式(表示形式)

• ボタン式: 各選択肢がボタンとして並び、ボタンのラベルに現在の得票数が 選択肢名 (0) のように表示されます。
• プルダウン式: ドロップダウンから選択肢を選んで投票します。最初は 投票する選択肢を選んでください... というプレースホルダが表示されます。

投票ルール

• 一人一票: 1 人につき 1 票だけ投じられます。別の選択肢を選び直すと、前に入れた票は自動的に取り消されて新しい票に置き換わります。同じ選択肢をもう一度選ぶと、その票は取り消されます(投票なしの状態に戻ります)。
• 複数投票OK: 1 人で複数の選択肢に投票できます。各選択肢はオン・オフの切り替え式で、同じ選択肢をもう一度選ぶとその票だけが取り消されます。他の選択肢に入れた票はそのまま残ります。

投票するとどうなるか

メンバーがボタンを押す、またはプルダウンで選択肢を選ぶと票が記録され、本人だけに見える確認メッセージ 投票を受け付けました。 が表示されます。同時に投票メッセージが更新され、📊 **現在の投票状況** の見出しとともに各選択肢の得票数がリアルタイムで反映されます。

投票が終了したときの表示

投票は、締め切り時刻が来ると自動的に終了します。終了処理は約 1 分ごとに行われるため、締め切り時刻の少しあと(最大 1 分程度)に結果が確定することがあります。/poll end やコンテキストメニュー「投票を終了する」で手動終了した場合は、その時点ですぐに結果が確定します。

終了すると次のように表示が変わります。

• 投票メッセージのボタンやプルダウンが取り除かれ、それ以上投票できなくなります。
• タイトルの先頭に 投票結果: が付きます。
• 説明文に --- **最終結果** --- の見出しが付き、各選択肢が得票数の多い順に並びます。
• 各選択肢は得票数・割合(パーセント)・進捗バーで表示されます。進捗バーは █ の文字を並べた 20 文字のバーで、得票割合に応じて埋まります。

最終結果の各行は次の形式です。

**選択肢名**: 3票 (60.0%)
[████████████░░░░░░░░]

各コマンドが成功すると、本人だけに見える確認メッセージ 投票 {投票名} を開始しました。 / 投票 {投票名} を編集しました。 / 投票 {投票名} を終了しました。 が表示されます(投票名は実際にはバッククォートで囲まれます)。

上限とクールダウン

投票の作成には、プランごとの上限があります。

ベータ期間中は全ユーザーにプレミアムが付与されるため、上記の無料プランの上限(同時 1 つ・72 時間まで)は実質的に適用されません。

投票そのものや、各選択肢への投票回数にクールダウン(待ち時間)はありません。実施中の投票には、いつでも投票・投票し直しができます。Bot を再起動しても、実施中の投票はそのまま投票を受け付け続け、集まっていた票も保持されます。

表示されるメッセージ

投票の操作でうまくいかなかったとき、Bot は本人だけに見えるメッセージ(エフェメラル)でエラーを知らせます。

注意点・うまくいかないとき

• /poll edit で変更できるのはタイトルと説明文だけです。 選択肢そのものや期間・投票方式はあとから変更できません。これらを変えたいときは、いったん投票を終了して作り直してください。編集してもそれまでの票は保持されます。
• 終了・編集ができるのは、作成者本人かサーバー管理者(Manage Guild / サーバー管理 権限を持つメンバー)だけです。 作成者は、Manage Messages 権限がなくても自分が作った投票を終了・編集できます。
• 投票メッセージを削除すると、その投票には投票できなくなります。 削除後に投票しようとすると この投票は終了または削除されたようです。 と表示されます。
• 投票メッセージの締め切り時刻は、フッターに YYYY/mm/dd HH:MM UTC の形式(UTC)で表示されます。

次のステップ / 関連ページ

• コマンド権限設定の使い方(全機能共通) — コマンドとコンテキストメニューの権限を細かく設定する方法
• 抽選 — 投票と同じくコマンドとコンテキストメニューで操作する機能
• 埋め込み — リッチなメッセージを作成する機能
• モジュール一覧 — 利用できる機能の一覧