投票(Poll)

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

ダッシュボードのこのページでは、これらの コマンドとコンテキストメニューの有効状態・権限のみ を設定します。

この機能でできること

• 投票関連の 3 つのコマンド(/poll create・/poll end・/poll edit)を Bot に追加し、それぞれ有効・無効を切り替える
• 投票メッセージを右クリックして実行するコンテキストメニュー「投票を終了する」を追加し、有効・無効を切り替える
• これらのコマンド・メニューを「だれが使えるか」を、ロールや Discord の権限で細かく設定する

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

設定項目はコマンド・コンテキストメニューの権限設定のみで、投票独自の細かいオプション(質問文や選択肢、締め切りなど)はダッシュボードにはありません。

投票で使うコマンド

画面を開く

「投票」の設定画面は、Bot の管理画面のメニューから開きます。

機能を有効化する

このページでは、上部の「機能の有効化」スイッチと、その下の「コマンド権限設定」「コンテキストメニュー権限設定」の 2 つのカードで設定します。

コマンド権限設定

「コマンド権限設定」カードでは、投票関連のスラッシュコマンドの有効状態と権限を設定します。

カード内には次の 3 つのコマンドが、折りたたみ(アコーディオン)形式で並んでいます。設定したいコマンドの行をクリックすると、その下に詳細設定が開きます。

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

「コンテキストメニュー権限設定」カードでは、投票メッセージを右クリックして実行するコンテキストメニューの有効状態と権限を設定します。

「投票を終了する」を使うと、Discord 上で投票メッセージを右クリック(スマートフォンでは長押し)して表示されるメニューから、コマンドを入力せずに投票を終了できます。

権限を細かく設定する

「コマンド権限設定」「コンテキストメニュー権限設定」のどちらでも、「個別権限設定を有効化」をオンにすると「詳細権限設定」が表示され、ロールや Discord 権限の条件で利用可否を細かく決められます。

操作方法はすべての機能で共通です。ロールの追加・削除、権限条件(AND / OR / STRICT / CONTAINS)の作り方、「Discord権限より個別設定を優先(強制上書き)」の使い方などは、コマンド権限設定の使い方(全機能共通)で詳しく説明しています。

設定を保存する

設定を変更すると、画面下部に「未保存の変更があります」というバーが表示されます。

Discord で投票を作成・操作する

ダッシュボードで権限を設定したら、実際の投票は Discord 上で操作します。

実際の動作と既定値

ここからは、Discord 上で /poll create を実行したときに投票が実際にどう動くかを説明します。ダッシュボードでの権限設定とあわせて、運用前に挙動を把握しておくと便利です。

/poll create で指定する項目

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

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

投票方式(表示形式)

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

投票ルール

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

投票するとどうなるか

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

集計中の表示には 📊 **現在の投票状況** の見出しとともに、各選択肢の得票数(例: りんご: 3票)が表示されます。ボタン式の場合は各ボタンのラベルにも得票数が反映されます。

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

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

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

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

最終結果の各行は、次のような形式で表示されます。

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

各コマンドが成功すると、本人だけに見える確認メッセージが表示されます。投票名はバッククォートで囲まれて表示されます。

投票 `{投票名}` を開始しました。
投票 `{投票名}` を編集しました。
投票 `{投票名}` を終了しました。

上限とクールダウン

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

投票そのものや、各選択肢への投票回数にクールダウン(待ち時間)はありません。実施中の投票には、いつでも投票・投票し直しができます。

表示されるメッセージ

投票の操作でうまくいかなかったとき、Bot は本人だけに見えるメッセージ(エフェメラル)でエラーを知らせます。代表的なメッセージは次のとおりです(プレースホルダはバッククォートで囲んで表記しています)。

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

• /poll edit で変更できるのはタイトルと説明文だけです。 選択肢そのものや期間・投票方式はあとから変更できません。これらを変えたいときは、いったん投票を終了して作り直してください。編集してもそれまでの票は保持されます。
• 投票名はサーバー内で重複できません。 すでに実施中の投票と同じ名前を付けようとすると作成に失敗します。別の名前を指定してください。
• 終了・編集ができるのは、作成者本人かサーバー管理者(Manage Guild / サーバー管理 権限を持つメンバー)だけです。 作成者は、Manage Messages 権限がなくても自分が作った投票を終了・編集できます。
• /poll end や「投票を終了する」は、投票メッセージに対して実行します。 投票ではないメッセージを対象にすると これは投票メッセージではありません。 と表示されます。
• 投票メッセージを削除すると、その投票には投票できなくなります。 削除後に投票しようとすると この投票は終了または削除されたようです。 と表示されます。
• 締め切りは多少のずれが出ることがあります。 自動終了は約 1 分ごとにチェックされるため、締め切り時刻ちょうどではなく、最大 1 分ほど遅れて確定する場合があります。
• 投票メッセージの締め切り時刻は、フッターに YYYY/mm/dd HH:MM UTC の形式(UTC)で表示されます。

コマンド・メニュー一覧

Discord 上で使える投票関連のコマンド・メニューと、既定で必要な権限は次のとおりです。いずれもダッシュボードの権限設定で「だれが使えるか」を上書きできます。

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

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