このガイドでは、Discourseコミュニティのグループにユーザーを招待する方法を、スタッフとグループオーナーの両方の方法で説明します。
必要なユーザーレベル: 管理者またはグループオーナー
フォーラムのスタッフおよびグループオーナーは、招待を作成して新規ユーザーおよび既存ユーザーをグループに追加できます。
このガイドでは以下について説明します。
- スタッフとグループオーナーがユーザーに招待を送信する方法。
- ユーザー招待のためのDiscourse APIの使用。
- CSVアップロードによる一括招待の送信。
トラストレベルのグループ、管理者、モデレーター、スタッフグループなどの定義済みグループへのユーザー招待はできません。回避策として、グループの設定ページの「効果 (Effects)」セクションでカスタムグループを設定し、ユーザーのトラストレベルを自動的に設定することができます。これにより、サイトの
default invitee trust level設定で設定されているトラストレベルとは異なるトラストレベルに、招待されたユーザーのトラストレベルを設定できるようになります。
スタッフとしてのユーザー招待
Discourseのスタッフは、新規ユーザーと既存ユーザーの両方を1つ以上のカスタムグループに招待できます。手順は次のとおりです。
- プロフィールページに移動します。
- 「招待 (Invites)」をクリックします。
- 招待したいグループを選択するために、「グループに追加 (Add to groups)」ドロップダウンを選択します。
- 「招待を保存 (Save Invite)」をクリックしてユーザーと直接共有できるリンクとして招待を保存するか、「保存してメールを送信 (Save and Send Email)」をクリックしてメールで送信することができます。
コミュニティへの参加のための招待の作成と送信方法に関する追加の詳細については、Configuring how users can create and send invites for others to join your community を参照してください。
グループオーナーとしてのユーザー招待
グループオーナーの場合、所有するグループに新規ユーザーを招待できます。次の手順に従ってください。
- グループのページに移動します。
- 「招待 (Invite)」ボタンをクリックします。
グループオーナーは、「ユーザーを追加 (Add Users)」ボタンを使用して既存のユーザーをグループに招待することもできます。
APIの使用
グループ招待は、/invites.json APIエンドポイントを使用してDiscourse API経由で送信することもできます。
あるいは、The Discourse API gem を使用してRubyで招待を送信することもできます。
以下は、Discourse API Gemを使用したAPIの例です。
require 'discourse_api'
client = DiscourseApi::Client.new("https://discourse.example.com")
client.api_key = "your key"
client.api_username = "an_admin"
# Invite user by email to specific groups
client.invite_user(
email: "bob@bob.com",
group_ids: "1,2,3"
)
一括招待
ユーザーの一括招待は、CSVファイルをアップロードすることで実行できます。このプロセスに関する詳細は、こちらの詳細ガイド Send Bulk User Invites をお読みください。
ベストプラクティス
- ロールや権限に基づいてユーザーを整理するためにカスタムグループを作成します。
- 混乱を防ぐために、招待メッセージに明確な指示を提供します。
- コミュニティを整理するために、グループメンバーシップを定期的に確認および管理します。
追加リソース
- Discourse APIドキュメント: https://docs.discourse.org/