Este guia explica como configurar, criar e gerenciar convites de usuários no Discourse.
Nível de usuário exigido: Administrador
O Discourse permite que usuários em grupos permitidos convidem novos membros para sua comunidade (padrão nível de confiança 2). Os convites podem ser configurados para redirecionar o novo usuário para um tópico específico quando ele ingressa no site pela primeira vez. Os convites também podem ser configurados para adicionar o usuário a grupos personalizados do Discourse quando ele aceita o convite.
Configurando as configurações do site relacionadas a convites
As seguintes configurações do site podem ser ajustadas para configurar como os convites funcionam em seu site:
| Nome | Descrição |
|---|---|
invite allowed groups |
Os grupos que têm permissão para convidar novos usuários para o site (padrão para nível de confiança 2 e equipe) |
default invitee trust level |
O nível de confiança que será concedido aos usuários convidados (padrão para nível de confiança 1) |
max invites per day |
O número máximo de convites que um usuário regular pode enviar em um dia. Este limite não é imposto aos membros da equipe. (Padrão para 10 convites por dia) |
invite expiry days |
O número de dias que um convite é válido (padrão para 90 dias) |
invite link max redemptions limit |
O número máximo de resgates que um link de convite criado por um usuário da equipe pode ter (padrão para 5000) |
invite link max redemptions limit users |
O número máximo de resgates que um link de convite criado por um usuário que não seja da equipe pode ter (padrão para 10) |
Criando um convite
Para criar um convite, acesse a seção “invites” (convites) na página de perfil do seu usuário. Isso o levará para sua página de convites pendentes. Essa página mostra uma lista de convites anteriores que você enviou e permite que você envie novos convites. Clique no botão “Invite” (Convidar) para começar a criar um novo convite:
Uma janela modal será aberta, permitindo que você configure o convite:
- Description: Adicione uma descrição opcional ao convite para facilitar a organização.
- Restrict to: Insira um endereço de e-mail ou domínio (ex:
example.com) para limitar quem pode usar o convite. - Max uses: Defina o número de resgates permitidos se não estiver limitando a um e-mail no campo anterior.
- Expire after: Defina o período de tempo que o convite será válido.
- Arrive at topic: Escolha um tópico para os usuários acessarem após o ingresso. (Apenas equipe, oculto quando
must approve users(deve aprovar usuários) está ativado) - Add to groups: Selecione os grupos aos quais o novo usuário será adicionado. (Apenas equipe e proprietários de grupo)
- Custom message: Adicione uma nota pessoal ao seu e-mail de convite. (Exibido apenas ao restringir a um endereço de e-mail)
Após configurar o convite, se você o restringiu a um endereço de e-mail, terá a opção de copiar o link do convite ou enviar um e-mail de convite diretamente do seu site Discourse:
Se você não restringiu o convite a um endereço de e-mail, você terá apenas a opção de copiar o link do convite.
Métodos alternativos para convidar usuários
Convidando para um tópico específico
Os usuários podem ser convidados para um tópico específico clicando no botão “Share” (Compartilhar) no rodapé do tópico. Clique no botão “Invite” (Convidar) na janela modal que se abre para acessar o formulário de convite. Observe que apenas usuários administradores no site podem convidar um usuário para um tópico que esteja em uma categoria protegida. Ao fazer isso, eles serão solicitados a adicionar o usuário ao grupo que tem acesso à categoria.
Convidando para um grupo
Proprietários de grupo e administradores do site podem convidar novos usuários para um grupo a partir da página do grupo. Clique no botão “Invite” (Convidar) na página do grupo para abrir a janela modal de convite:
Aceitando um convite
Quando um convite é aceito visitando um link de convite, o usuário será direcionado para uma página que exibe os mesmos campos que são vistos na janela modal de cadastro do seu site. Uma exceção é que, se o convite foi criado para um endereço de e-mail específico, o campo de e-mail não será exibido. Em vez disso, uma conta será criada para ele com o endereço de e-mail para o qual o convite foi configurado:
Análise de Convites
Estatísticas sobre quantas pessoas se cadastraram a partir de um link específico podem ser visualizadas na página “Invites” (Convites) do usuário que criou o link do convite ou o e-mail de convite.
Em particular, a página “Pending” (Pendente) exibirá uma lista de todos os links de convite que estão atualmente ativos e mostrará uma contagem de quantos usuários resgataram o link em relação ao total de cadastros permitidos pelo link. A página “Expired” (Expirado) mostrará uma visualização semelhante, mas exibirá apenas os convites que não estão mais ativos, e você também pode ver uma lista de todos os usuários que resgataram links de convite na página “Redeemed” (Resgatado).
Além disso, o plugin Data Explorer pode ser usado para criar relatórios sobre estatísticas de convites usando a tabela invited_users. Por exemplo, a seguinte consulta SQL exibirá uma lista de todos os usuários que foram convidados para um site, juntamente com quem os convidou e há quanto tempo o usuário se cadastrou:
Lista de Usuários Convidados
SELECT iu.user_id,
i.invited_by_id AS invited_by_user_id,
iu.redeemed_at AS reltime$time
FROM invited_users iu
JOIN invites i ON iu.invite_id = i.id
WHERE iu.redeemed_at IS NOT NULL
ORDER BY iu.redeemed_at DESC
Problemas comuns e soluções
- Convite não funcionando: Verifique a expiração do convite e os limites de resgate.
- Usuários não recebendo convites: Verifique os logs de e-mail enviados e a validade do endereço de e-mail.
Recursos adicionais
- Como personalizar modelos de e-mail específicos (fornece detalhes sobre a personalização dos e-mails de convite)
- Enviando Convites de Usuários em Massa (envia convites em massa a partir de um arquivo CSV)
- Automatize o envio de e-mails de convite do Discourse com o Zapier
- Lista de usuários que se cadastraram via convites