Este guia explica como convidar usuários para um grupo em sua comunidade Discourse, abordando métodos para administradores, proprietários de grupos e moderadores com permissões específicas.
Nível de usuário necessário: Administrador ou Proprietário do Grupo (Moderadores precisam da configuração do site
moderators_manage_groupspara convidar usuários para grupos que não possuem)
Administradores e proprietários de grupos podem criar convites para adicionar novos e existentes usuários a grupos personalizados. Moderadores geralmente não podem convidar usuários para grupos, a menos que sejam os proprietários desse grupo específico ou se o administrador do site tiver habilitado a configuração moderators_manage_groups.
Este guia explicará:
- Como administradores e proprietários de grupos podem enviar convites para usuários.
- Como moderadores podem convidar usuários para grupos que possuem.
- Como a configuração do site
moderators_manage_groupsaltera as permissões. - Uso da API do Discourse para convites de usuários.
- Envio de convites em massa via upload de CSV.
Convidando usuários para um grupo
Administradores podem convidar tanto novos quanto usuários existentes para um ou mais grupos personalizados. Veja como fazer:
- Navegue até sua página de perfil.
- Clique em Convites.
- Selecione o menu suspenso Adicionar a grupos para escolher os grupos aos quais deseja convidar usuários.
- Os convites podem ser salvos como um link que pode ser compartilhado diretamente com os usuários clicando em Criar Link.
Não é possível convidar usuários para grupos pré-definidos, como grupos de nível de confiança, administradores, moderadores ou equipe. Como solução alternativa, você pode configurar um grupo personalizado para definir automaticamente o nível de confiança de um usuário na seção Gerenciar > Membros > Efeitos da página de configuração do grupo. Ao fazer isso, você pode definir o nível de confiança dos usuários convidados para um nível diferente daquele definido pela configuração
default invitee trust leveldo seu site.
Consulte Configurando como os usuários podem criar e enviar convites para outros se juntarem à sua comunidade para obter detalhes adicionais sobre o envio de convites.
Permissões de Moderador
Por padrão, moderadores não podem convidar usuários para grupos que não possuem. Se um moderador tentar adicionar um grupo a um convite sem ser o proprietário desse grupo, receberá um erro: «Você não tem permissão para visualizar o recurso solicitado».
Existem duas maneiras de conceder essa capacidade aos moderadores:
- Tornar o moderador proprietário do grupo: Atribua o moderador como proprietário do grupo específico ao qual deseja convidar usuários.
- Habilitar a configuração do site
moderators_manage_groups: Isso permite que todos os moderadores criem e gerenciem grupos (incluindo o envio de convites) em todo o site. Essa configuração está localizada em Admin → Configurações → Grupos.
Solução de problemas: Se você é um moderador e vê o menu suspenso «Adicionar a grupos» no formulário de convite, mas recebe um erro ao enviar, certifique-se de que é o proprietário do grupo selecionado. Se não for, peça a um administrador que o torne proprietário desse grupo ou que habilite a configuração do site
moderators_manage_groups.
Convidando usuários como proprietário de grupo
Se você é o proprietário de um grupo, pode convidar novos usuários para o grupo que possui. Siga estas etapas:
- Acesse a página do grupo.
- Clique no botão Convidar.
Adicionando usuários existentes
Proprietários de grupos também podem convidar usuários existentes (aqueles que já possuem uma conta no site) para grupos usando o botão Adicionar Usuários.
Usando a API
Convites de grupo também podem ser enviados usando a API do Discourse com o endpoint de API /invites.json. Alternativamente, você pode usar The Discourse API gem para enviar convites usando Ruby.
Abaixo está um exemplo de API usando o Discourse API Gem:
require 'discourse_api'
client = DiscourseApi::Client.new("https://discourse.example.com")
client.api_key = "your_key"
client.api_username = "an_admin"
# Convidar usuário por e-mail para grupos específicos
client.invite_user(
email: "bob@bob.com",
group_ids: "1,2,3"
)
Convites em massa
O convite em massa de usuários pode ser feito carregando um arquivo CSV. Para detalhes sobre esse processo, leia o guia detalhado aqui: Enviar Convites de Usuários em Massa.
Melhores práticas
- Crie grupos personalizados para organizar usuários com base em funções ou permissões, em vez de usar grupos do sistema para convites.
- Ofereça instruções claras em suas mensagens de convite para evitar confusão sobre por que um usuário está sendo convidado.
- Revise regularmente e gerencie as associações de grupo para manter uma comunidade organizada e remover usuários inativos.
- Use a configuração
moderators_manage_groupscom cuidado: Habilitá-la concede aos moderadores poder significativo; certifique-se de que sua equipe de moderação esteja treinada nas melhores práticas de gerenciamento de grupos antes de ativá-la.
Problemas comuns e soluções
- Convite não funcionando: Verifique as datas de expiração do convite e os limites de resgate.
- Usuários não recebendo convites: Verifique os logs de e-mail enviados e certifique-se de que o endereço de e-mail é válido.
- Erro «Você não tem permissão»: Se você é um moderador, certifique-se de que é o proprietário do grupo ao qual está tentando convidar ou de que a configuração do site
moderators_manage_groupsestá habilitada. - Não é possível convidar para grupos do sistema: Você não pode convidar usuários para grupos pré-definidos como
adminsoutrust_level_2. Crie um grupo personalizado com os efeitos desejados.
Perguntas frequentes (FAQs)
Moderadores podem convidar usuários para qualquer grupo?
Não. Por padrão, moderadores só podem convidar usuários para grupos que possuem pessoalmente. Para permitir que moderadores convidem usuários para qualquer grupo, um administrador deve habilitar a configuração do site moderators_manage_groups.
Posso convidar usuários para o grupo «Staff»?
Não. Você não pode convidar usuários para grupos do sistema pré-definidos. Em vez disso, crie um grupo personalizado e configure-o para conceder o nível de confiança ou as permissões desejadas.
Como convido um usuário que já possui uma conta?
Use o botão Adicionar Usuários na página do grupo (para proprietários de grupos) ou o menu suspenso Adicionar a grupos ao criar um convite (para administradores).