このガイドでは、Discourseインスタンスに複数のユーザーを一括招待機能を使用して招待する方法を説明します。
必要なユーザーレベル: 管理者
Discourseインスタンスに多数のユーザーを招待するのは、個別に実行すると時間がかかる場合があります。幸いなことに、Discourseには一度に複数のユーザーを招待できる一括招待機能が用意されています。このガイドでは、一括招待を送信する手順を説明します。
信頼レベルのグループ、管理者、モデレーター、スタッフグループなどの定義済みのグループにユーザーを招待することはできません。回避策として、グループ設定ページの「効果 (Effects)」セクションでユーザーの信頼レベルを自動的に設定するようにカスタムグループを設定できます。これにより、サイトの
default invitee trust level設定によって設定される信頼レベルとは異なる信頼レベルに招待されたユーザーを設定できるようになります。
概要
Allow bulk inviteサイト設定が有効になっていることを確認します（デフォルトで有効です）。- ユーザー情報を含むCSVファイルを用意します。
- CSVファイルをDiscourseインスタンスにアップロードします。
- 一括招待の進行状況を監視します。
Allow bulk invite サイト設定が有効になっていることを確認する
Allow bulk invite 設定はデフォルトで有効になっています。サイトで無効になっている場合は、次の手順を実行します。
- 管理 >
すべてのサイト設定に移動し、bulk inviteを検索します。または、{your.domain.com}/admin/site_settings/category/all_results?filter=bulk%20inviteに移動します。 - まだ有効になっていない場合は、
Allow bulk inviteの横にあるチェックボックスをオンにし、チェックマークをクリックしてサイト設定を保存します。
CSVファイルの準備
最初の手順は、招待したいユーザーの情報を含むCSV（カンマ区切り値）ファイルを作成することです。知っておくべきことは次のとおりです。
- 各行が 1 つのユーザーを表します。
- Eメールアドレスは必須であり、最初の列にある必要があります。
- グループの割り当て（オプション）は 2 列目に入力します。
- 特定のトピックID（オプション）は 3 列目に入力します。
- ロケール（オプション）は 4 列目に入力します。
- 追加の列は、カスタムユーザーフィールドの値を設定するために使用できます（列ヘッダーはユーザーフィールド名と一致する必要があります）。
CSVファイルの構造は次のとおりです。
email,groups,topic_id,locale
CSVファイルのガイドライン
- Eメールアドレスは有効である必要があります。
- 複数のグループはセミコロンで区切ります（例：
group_1;group_2;group_3）。 - 既存のユーザーをグループに追加したい場合は含めることができます。
- Eメールのみが必須であり、グループ、トピックID、ロケール、ユーザーフィールドはオプションです。
- カスタムユーザーフィールドを含める場合、CSVには
emailで始まるヘッダー行が必要です。
max_bulk_invitesという非表示のサイト設定があり、デフォルトではCSVで 50k 行まで許可されます。
CSVファイルの例
user1@example.com,group_1;group_2,topic_id
user2@example.com,group_3,
user3@example.com,,
完了したら、必ずファイルを CSV として保存してください。
CSVファイルのアップロード
CSVファイルが準備できたら、次の手順でアップロードします。
-
管理者のユーザープロファイルの招待タブに移動します。
{your.domain.com}/my/invited/pending -
「ファイルから一括招待 (Bulk Invite from File)」ボタンをクリックします。
-
表示されるモーダルで、CSVファイルをアップロードします。
-
アップロードを確認します。
アップロード後、処理が完了すると通知されるという確認メッセージが表示されます。
一括招待の進行状況の監視
CSVファイルが処理されると、進捗レポートを含む個人メッセージの通知が届きます。このレポートには次のものが含まれます。
- 送信された招待の総数
- 送信されなかった招待の数（ある場合）
- プロセス中に発生したエラー
ユーザープロファイルの招待ページを確認すると、正常に送信された招待のリストが表示されます。
次に行うこと
CSVファイル内の各Eメールアドレスに招待メールが届きます。このメールには次のものが含まれます。
- 招待を送信した人の名前
- コミュニティのタイトル
- コミュニティの簡単な説明（
site description設定から） - 招待リンク
招待されたユーザーが確認リンクをクリックすると、次のようになります。
- アカウントは直ちにアクティブ化され、Eメールアドレスに関連付けられます。
- 指定されたグループに追加されます（CSVに含まれていた場合）。
- ターゲットトピックにリダイレクトされます（トピックIDが指定されていた場合）。
invite expiry days設定（デフォルト：90日）に基づいて期限切れになります。
招待メールのカスタマイズ
招待メールのテキストをカスタマイズしたい場合：
- 一般的な招待については、「Invite Forum Mailer」Eメールテンプレートを編集します。
- 特定のトピックIDを含む招待については、「Invite Mailer」Eメールテンプレートを編集します。