Este guia explica como convidar vários usuários para sua instância do Discourse usando um recurso de convite em massa.
Nível de usuário necessário: Administrador
Convidar um grande número de usuários para sua instância do Discourse pode consumir muito tempo se for feito individualmente. Felizmente, o Discourse oferece um recurso de convite em massa que permite convidar vários usuários de uma só vez. Este guia o guiará pelo processo de envio de convites em massa.
Não é possível convidar usuários para grupos predefinidos, como grupos de nível de confiança, administradores, moderadores ou grupos de 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 Efeitos (Effects) da página de configuração do grupo. Fazer isso permitirá que você defina o nível de confiança dos usuários convidados para um nível de confiança diferente do que é definido pela configuração
nível de confiança de convidado padrão(default invitee trust level) do seu site.
Visão Geral
- Garanta que a configuração do site
Permitir convite em massa(Allow bulk invite) esteja ativada (está por padrão) - Prepare um arquivo CSV com as informações do usuário
- Carregue o arquivo CSV em sua instância do Discourse
- Monitore o progresso do convite em massa
Garantir que a configuração do site Permitir convite em massa esteja ativada
A configuração Permitir convite em massa (Allow bulk invite) está ativada por padrão. Se ela foi desativada em seu site:
- Navegue até as configurações do seu site em Administrador >
Todas as configurações do site e pesquise por bulk invite. Ou vá para{seu.dominio.com}/admin/site_settings/category/all_results?filter=bulk%20invite - Se ainda não estiver ativado, marque a caixa ao lado de
Allow bulk invitee clique no visto para salvar a configuração do site.
Preparando o arquivo CSV
O primeiro passo é criar um arquivo CSV (Comma-Separated Values - Valores Separados por Vírgula) contendo as informações dos usuários que você deseja convidar. Aqui está o que você precisa saber:
- Cada linha representa um usuário
- O endereço de e-mail é obrigatório e deve estar na primeira coluna
- Atribuições de grupo (opcional) vão na segunda coluna
- Um ID de tópico específico (opcional) vai na terceira coluna
- Uma localidade (opcional) vai na quarta coluna
- Quaisquer colunas adicionais podem ser usadas para definir valores de campo de usuário personalizados (o cabeçalho da coluna deve corresponder ao nome do campo do usuário)
Aqui está a estrutura do arquivo CSV:
email,groups,topic_id,locale
Diretrizes do arquivo CSV
- Os endereços de e-mail devem ser válidos
- Separe vários grupos com ponto e vírgula (ex:
group_1;group_2;group_3) - Você pode incluir usuários existentes se quiser adicioná-los a grupos
- Apenas o e-mail é obrigatório; grupos, ID do tópico, localidade e campos de usuário são opcionais
- Se incluir campos de usuário personalizados, o CSV deve ter uma linha de cabeçalho começando com
email
max_bulk_invitesque permite 50 mil linhas em um CSV por padrão
Exemplos de arquivos CSV
user1@example.com,group_1;group_2,topic_id
user2@example.com,group_3,
user3@example.com,,
Apenas certifique-se de salvar o arquivo como CSV quando terminar.
Carregando o arquivo CSV
Depois de preparar seu arquivo CSV, siga estas etapas para carregá-lo:
-
Navegue até a guia Convites (Invites) no perfil do seu usuário Administrador.
{seu.dominio.com}/my/invited/pending -
Clique no botão “Convidar em Massa do Arquivo” (Bulk Invite from File)
-
No modal que aparecer, carregue seu arquivo CSV
-
Confirme o carregamento
Após o carregamento, você receberá uma mensagem de confirmação informando que será notificado quando o processo for concluído.
Monitorando o progresso do convite em massa
Assim que o arquivo CSV for processado, você receberá uma notificação de mensagem pessoal com um relatório de progresso. Este relatório incluirá:
- Número total de convites enviados
- Número de convites não enviados (se houver)
- Quaisquer erros que ocorreram durante o processo
Você pode verificar sua página de convites no seu perfil de usuário para ver uma lista de convites enviados com sucesso.
O que acontece em seguida
Cada endereço de e-mail no seu arquivo CSV receberá um e-mail de convite. O e-mail incluirá:
- O nome da pessoa que enviou o convite
- O título da sua comunidade
- Uma breve descrição da sua comunidade (da configuração
descrição do site) - Um link de convite
Quando um usuário convidado clicar no link de confirmação:
- A conta dele será ativada imediatamente e associada ao seu endereço de e-mail
- Ele será adicionado aos grupos especificados (se algum foi incluído no CSV)
- Ele será direcionado para o tópico de destino (se um ID de tópico foi especificado)
dias de expiração do convite(invite expiry days) (padrão: 90 dias).
Personalizando e-mails de convite
Se você deseja personalizar o texto dos e-mails de convite:
- Para convites gerais, edite o modelo de e-mail “Mailer de Convite do Fórum” (Invite Forum Mailer)
- Para convites que incluem um ID de tópico específico, edite o modelo de e-mail “Mailer de Convite” (Invite Mailer)