紹介
個人の招待リンク、誰が誰を招待したか、招待して退出する行為を防ぐ滞在タイマー、紹介数に応じた報酬ロール。
仕組み
Discord は、メンバーがどの招待を使ったかを教えてくれないため、ボットはすべての招待の使用回数を記録し、誰かが参加すると、回数が増えた招待に紹介をクレジットします。 /referrals link は、実行したメンバー用に、ボットが作成する個人の招待を作ります。そのため、Discord の招待ダイアログに触れずに、そのメンバーの参加が本人のものとして記録されます。
紹介は1件ずつ通知されます。ログチャンネルの埋め込み、または、承認と却下のボタンが付いたスタッフ用の非公開チケットです。メンバーが報酬の基準に達すると、自動的にロールが付与されます。
セットアップ
- /referrals setup enabled:true
- 追跡をオンにします。オプション: mode(log または ticket)、log_channel、ticket_category、staff_role、hold、hold_hours(1〜720)、min_account_age(0〜365日)。
- /referrals reward-add count:<n> role:@role
- カウントされた紹介が n 件に達した人に、ロールを1回付与します。複数追加すると段階的な報酬になります。 /referrals reward-remove count:<n> で1つ削除できます。
- /referrals settings
- 現在の設定と、これまでにカウントされた合計です。
- 紹介ページ(ダッシュボード)
- コミュニティ → 紹介: 同じ設定をフォームで変更できるほか、報酬の段階も設定できます。
メンバー向けのコマンド
- /referrals link
- このサーバーでのあなた専用の招待リンクです。
- /referrals me
- あなたが招待した人数と、滞在タイマーの待機中の人数です。
- /referrals top
- 紹介数が最も多いメンバーです。
- /referrals user member:@someone
- スタッフ専用: 1人のメンバーの合計です。
カウントされないもの
- 再参加
- サーバーごとに、メンバー1人につき紹介は1回だけです。退出して別のリンクから参加しても、再びカウントされることはありません。
- 自分自身の招待とボット
- カウントされることはありません。
- 新しいアカウント
- min_account_age 日より新しいアカウントは拒否されます。
- 招待して退出
- hold がオンのときは、紹介は hold_hours の間待機し、メンバーがまだそのサーバーにいる場合にのみカウントされます。
招待を読み取るには、ボットにサーバーの管理(Manage Server)が必要です。権限がなくても、ほかの機能は壊れませんが、参加は紹介者に紐づけられません。カスタム URL(バニティ URL)からの参加は、メンバーに紐づけられません。