Este guia explica como configurar o Discourse para criar novos tópicos ou mensagens de grupo a partir de e-mails recebidos. Ele aborda as configurações do site, configuração de grupos e configurações de categorias.
Nível de usuário necessário: Administrador
Configurar e-mails recebidos para criar novos tópicos ou mensagens de grupo
O Discourse permite que você envie e-mails para um endereço especial para criar automaticamente novos tópicos em uma categoria ou novas mensagens de grupo. Esse recurso é útil para integrar o Discourse com listas de distribuição externas, sistemas de tickets de suporte ou simplesmente permitir que usuários sem contas publiquem via e-mail.
Resumo
Este guia abrange o seguinte:
- Habilitando as configurações de e-mail recebido do site
- Configurando e-mails recebidos para grupos específicos
- Configurando e-mails recebidos para categorias específicas
- Compreendendo o comportamento de e-mails encaminhados
- Considerações especiais para sites Discourse Hosted
Habilitar configurações de e-mail recebido
Antes de poder criar tópicos ou mensagens de grupo via e-mail, você deve habilitar a funcionalidade de e-mail recebido no nível do site.
- Acesse o painel de administração do seu site
- Na barra lateral esquerda, clique em E-mail e depois em Configurações
- Pesquise cada configuração usando o campo de filtro e configure conforme necessário
Você também pode navegar diretamente para /admin/config/email para acessar essas configurações.
email_in
Esta é a chave mestra para a funcionalidade de e-mail recebido.
- Rótulo:
Habilitar e-mail recebido - Descrição: Permite criar tópicos e mensagens de grupo via e-mail.
- Padrão: Desabilitado
Você deve habilitar essa configuração antes que qualquer outra configuração de e-mail recebido funcione.
email_in_allowed_groups
Essa configuração restringe quais usuários têm permissão para criar tópicos ou mensagens de grupo via e-mail.
- Rótulo:
Grupos permitidos para e-mail recebido - Descrição: Apenas usuários nesses grupos podem criar tópicos ou mensagens de grupo via e-mail. Deixe em branco para permitir todos os usuários.
- Padrão: Vazio (todos os usuários permitidos)
Para restringir o e-mail recebido a grupos específicos (por exemplo, staff, moderators), insira os nomes dos grupos separados por vírgulas.
enable_staged_users
Essa configuração controla se os usuários que criam tópicos via e-mail são automaticamente colocados em estágio (requerem aprovação).
- Rótulo:
Habilitar usuários em estágio - Descrição: Quando habilitado, os usuários que criam tópicos via e-mail serão colocados em estágio e precisarão de aprovação antes de poderem publicar.
- Padrão: Habilitado
Se você desabilitar essa configuração, os usuários que criam tópicos via e-mail poderão publicar imediatamente sem aprovação.
Para sites Discourse hospedados, a configuração
enable_staged_usersestá desabilitada e oculta durante o período de teste para evitar abusos. Uma vez iniciado uma assinatura, a configuração é desocultada. Para solicitar que ela seja habilitada durante seu período de teste, entre em contato com team@discourse.org.
Usuários em estágio são contas placeholder especiais criadas automaticamente quando um e-mail chega de alguém sem uma conta no Discourse. Eles têm funcionalidade limitada:
- Nome de usuário e nome de exibição são atribuídos automaticamente
- Não podem ser mencionados ou encontrados na busca de usuários
- Não recebem resumos de e-mail ou e-mails de redefinição de senha
- Acompanham automaticamente os tópicos em que participam e podem responder via e-mail
- Podem reivindicar a conta registrando-se com o mesmo endereço de e-mail, convertendo-a em uma conta normal
Configurando e-mails recebidos para um grupo
Você pode configurar um grupo para aceitar e-mails recebidos que criem novas mensagens de grupo. Isso é útil para criar uma caixa de entrada de grupo que pode ser acessada via e-mail.
email_inestiver habilitada e você estiver logado como administrador.
- Acesse a página de grupos (por exemplo,
/g) - Clique no nome do grupo que deseja configurar
- Clique em Gerenciar para acessar a página de gerenciamento do grupo
- Clique na aba Interação
- Role para baixo até a seção E-mail recebido
- Insira o endereço de e-mail recebido personalizado no campo Endereço de e-mail recebido personalizado
- Marque a caixa Aceitar e-mails de usuários anônimos sem contas se quiser permitir que usuários sem contas enviem e-mails para este grupo
- Clique em Salvar para aplicar as alterações
|. Por exemplo,group1@example.com|group2@example.com.
Visibilidade do campo de e-mail do grupo
O campo E-mail recebido só aparece se:
- A configuração do site
email_inestiver habilitada - Você estiver logado como administrador
- O grupo não for um grupo automático (sistema)
Se o campo não aparecer, verifique se a configuração do site email_in está habilitada e se você está logado como administrador.
Configurando e-mails recebidos para uma categoria
Você pode configurar uma categoria para aceitar e-mails recebidos que criem novos tópicos. Isso é útil para criar uma categoria que pode ser acessada via e-mail.
- Acesse a página da categoria (por exemplo,
/c/<category_slug>) - Clique no ícone de chave de inglesa
para editar a categoria - Na página Editar categoria, clique no botão Mostrar Avançado no canto superior direito do cabeçalho da página
- Clique na aba Configurações
- Role para baixo até a seção E-mail
- Insira o endereço de e-mail recebido personalizado no campo Endereço de e-mail recebido personalizado
- Marque a caixa Aceitar e-mails de usuários anônimos sem contas se quiser permitir que usuários sem contas enviem e-mails para esta categoria
- Marque a caixa Categoria espelha uma lista de distribuição se a categoria estiver conectada a uma lista de distribuição externa e todas as publicações originarem de e-mail
- Clique em Salvar na faixa na parte inferior da página para aplicar as alterações
|. Por exemplo,category1@example.com|category2@example.com.
Endereço de e-mail recebido personalizado
Insira o endereço de e-mail recebido personalizado que será usado para criar novos tópicos nesta categoria. Por exemplo, support@example.com.
Aceitar e-mails de usuários anônimos sem contas
Quando habilitado, usuários que não têm uma conta em seu site Discourse podem enviar e-mails para esta categoria para criar novos tópicos. Esses usuários serão automaticamente criados como usuários em estágio (se enable_staged_users estiver habilitado) ou como usuários ativos (se enable_staged_users estiver desabilitado).
Categoria espelha uma lista de distribuição
Habilite isso se a categoria estiver conectada a uma lista de distribuição externa e todas as publicações originarem de e-mail. Quando habilitado:
- Usuários em estágio não receberão notificações web para tópicos nesta categoria
- A restrição
email_in_allowed_groupsé ignorada para publicações que chegam via endereço da lista de distribuição
Essa configuração é útil quando você está espelhando uma lista de distribuição externa para o Discourse e deseja evitar notificar usuários em estágio que ainda não foram aprovados.
Comportamento de e-mails encaminhados
Quando os usuários encaminham e-mails para o Discourse, o conteúdo encaminhado é tratado de acordo com a configuração do site forwarded_emails_behaviour. Essa configuração controla como os e-mails encaminhados são processados e exibidos no Discourse.
A configuração forwarded_emails_behaviour tem três opções:
- Ocultar: O conteúdo encaminhado é ocultado da publicação. Apenas o conteúdo do e-mail original é visível.
- Citar: O conteúdo encaminhado é citado na parte inferior da publicação, semelhante à forma como os clientes de e-mail tratam mensagens encaminhadas.
- Criar respostas: Uma nova resposta é criada para cada e-mail encaminhado, em vez de criar um novo tópico.
Para configurar essa configuração:
- Acesse o painel de administração do seu site
- Na barra lateral esquerda, clique em E-mail e depois em Configurações
- Pesquise
forwarded_emails_behaviourusando o campo de filtro - Selecione a opção desejada no menu suspenso
- Clique em Salvar para aplicar as alterações
forwarded_emails_behaviourse aplica a todos os e-mails recebidos, independentemente de serem enviados para um grupo ou uma categoria.
Instruções especiais para sites Discourse Hosted
Se você estiver usando hospedagem Discourse, precisa habilitar a caixa de seleção “Aceitar e-mails recebidos enviados para” na seção “Aceitar e-mails recebidos” das configurações de e-mail:
- Acesse o painel de administração do seu site
- Na barra lateral esquerda, clique em E-mail e depois em Configurações
- Role para baixo até a seção “Aceitar e-mails recebidos”
- Marque a caixa de seleção Aceitar e-mails recebidos enviados para
- Clique em Salvar para aplicar as alterações
Sites Discourse Hosted usam um domínio de e-mail especial para e-mails recebidos ({SEU_PREFIXO}.discoursemail.com). Qualquer um dos seguintes formatos pode ser usado para o endereço de e-mail recebido:
{QUALQUER_COISA}@{SEU_PREFIXO}.discoursemail.com- onde:{QUALQUER_COISA}é o endereço de e-mail recebido personalizado que você configura{SEU_PREFIXO}é o prefixo exclusivo atribuído ao seu site. Isso deve corresponder ao conjunto sugerido de primeiros caracteres antes do sinal+conforme visto na configuraçãoAceitar e-mails recebidos enviados para
{SEU_PREFIXO}+{QUALQUER_COISA}@discoursemail.com
Além disso, se você for um cliente hospedado e quiser usar um endereço de e-mail verdadeiramente único que não corresponda a nenhum dos formatos acima, você pode fazê-lo configurando o endereço de e-mail através de um provedor de e-mail de terceiros e encaminhando todos os e-mails recebidos nesse endereço para seu site. Você deve habilitar a opção Aceitar e-mails recebidos enviados para e usar o endereço de e-mail mostrado abaixo dessa opção como endereço de encaminhamento.
