Integração do Newsletter do Discourse

[Discourse]

	Resumo
	Link do Repositório
	Guia de Instalação

Como este é um plugin #oficial mantido pela equipe do Discourse, #suporte, #bugs, UX e solicitações de #recursos podem ser feitas nas respectivas categorias aqui no Meta, e marcadas com a tag do plugin apropriada. Clique em um link abaixo para iniciar um.

Suporte Bug UX Recurso

Recursos

• Administradores podem configurar uma newsletter global que será sincronizada com uma lista de e-mails no provedor de newsletter.
• Usuários podem assinar a newsletter a partir de um banner no site
  • Uma vez que o banner é dispensado, ele não aparecerá novamente para o usuário.
• Uma caixa de seleção é adicionada à página de preferências do usuário (/my/preferences/emails), permitindo que os usuários alterem sua assinatura de newsletter a qualquer momento.
• Assinantes são adicionados ou removidos da lista de e-mails vinculada no provedor de newsletter via sua API quando os usuários assinam ou cancelam a assinatura.
• O plugin sincroniza o status da assinatura entre o Discourse e o provedor de newsletter.
• Atualmente, o plugin suporta Mailchimp como provedor de newsletter e apenas uma newsletter global para todos os usuários. Suporte para provedores adicionais e newsletters limitadas a grupos está planejado para lançamentos futuros.

Guia de Configuração

Para habilitar o plugin, você pode usar o alternador em sua página /admin/plugins, ou verificando a configuração de administrador discourse newsletter integration enabled. Você também pode acessar as configurações do plugin a partir desta página:

Personalizar texto no Banner e Configurações do Usuário

Os usuários verão um banner sobre a newsletter, permitindo que eles assinem ou o dispensem. Este banner pode ser personalizado para melhor atender às necessidades do seu fórum e só será visível se todas as configurações relacionadas ao plugin estiverem configuradas. Uma vez dispensado, o usuário não o verá novamente, mas poderá optar por assinar a partir de sua página de preferências.

Você pode personalizar o texto do banner de assinatura no painel de administração. Aqui estão os rótulos personalizáveis para o banner:

• js.discourse_newsletter_integration.banner.heading
• js.discourse_newsletter_integration.banner.description
• js.discourse_newsletter_integration.banner.subscribe

• js.discourse_newsletter_integration.banner.manage_preferences
• js.discourse_newsletter_integration.banner.thank_you
• js.discourse_newsletter_integration.banner.added_to_newsletter

Você também pode personalizar o nome da sua newsletter no que cada usuário vê em sua página de preferências:

• js.discourse_newsletter_integration.preferences.section_head
• js.discourse_newsletter_integration.preferences.checkbox_description

Integração com Mailchimp

Existem três configurações de site do Discourse relacionadas à integração com o Mailchimp:

Nome	Descrição
discourse newsletter integration mailchimp api key	Chave de API para sua conta Mailchimp.
discourse newsletter integration mailchimp list id	O ID da sua Audiência Mailchimp que você deseja sincronizar com o Discourse.
discourse newsletter integration mailchimp server prefix	A parte do subdomínio do URL que você vê ao fazer login em sua conta Mailchimp, por exemplo, us14 e us19.

discourse newsletter integration mailchimp api key

Para gerar uma chave de API, siga estas etapas:

1. Navegue até a seção Chaves de API de sua conta.
2. Clique em Criar Nova Chave.
3. Nomeie sua chave.
4. Clique em Gerar Chave.
5. Clique em Copiar Chave para a Área de Transferência. Salve sua chave em um local seguro.
6. Clique em Concluído.

Sobre Chaves de API | Mailchimp

discourse newsletter integration mailchimp list id

Cada audiência do Mailchimp tem um ID de audiência exclusivo (às vezes chamado de ID de lista) que integrações, plugins e widgets podem exigir para conectar e transferir dados de assinantes. O ID da audiência é gerado pelo sistema do Mailchimp quando a audiência é criada e não pode ser alterado.

Para encontrar seu ID de audiência, siga estas etapas:

1. Navegue até Audiência
2. Selecione a Audiência que você deseja
3. Clique no menu suspenso Configurações e escolha Nome e padrões da audiência.
4. Na seção ID da Audiência, você verá uma sequência de letras e números. Este é o seu ID de audiência.

Encontre seu ID de Audiência | Mailchimp

discourse newsletter integration mailchimp server prefix

Faça login em sua conta Mailchimp e olhe o URL em seu navegador. Você verá algo como https://us19.admin.mailchimp.com/; a parte us19 é o prefixo do servidor. Observe que seu valor específico pode ser diferente.

Problemas conhecidos

Este plugin tem funcionalidade básica e funciona bem, mas aqui estão alguns problemas conhecidos que abordaremos no futuro:

Mudando contas Mailchimp

Após configurar a integração com o Mailchimp e estabelecer audiências para uma newsletter, se você mudar para uma nova conta (através das configurações do site), as audiências não serão sincronizadas com a nova conta.

Hospedado por nós? Este plugin está disponível em nosso plano Enterprise.

[Jagster (Jakke Lehtonen)]

Funciona sem o Mailchimp ou é uma espécie de front-end para os serviços do Mailchimp (como é bastante típico em outras plataformas)?

[nat (Natalie T)]

A intenção deste plugin é ajudar proprietários de sites a trabalhar com provedores de marketing por e-mail para enviar mensagens de marca mais personalizadas.

O único provedor incluído no plugin é o Mailchimp por enquanto, então não, este plugin não funciona sem o Mailchimp. Ele sincroniza usuários do fórum Discourse que optam por participar com o que o Mailchimp define como uma “audiência”.

[ked (Kenny DuBose)]

@nat Permita-me sugerir a inclusão do Zoho Campaigns em um futuro próximo.

[jordan-violet]

Uma coisa que notei é que, após ativado, o banner não apareceu para mim até que eu fizesse login com um navegador anônimo.

Haverá algo que possamos fazer para garantir que isso apareça para todos os usuários existentes que já visitaram o site antes?

[JammyDodger]

Para constar, apareceu normal para todos os meus usuários de teste existentes quando eu estava testando.

[Jonathan5]

Assim como com o plugin Assinaturas, seria bom se as pessoas pudessem se inscrever na newsletter e no fórum ao mesmo tempo. Acho que só é possível para usuários já registrados.

[JammyDodger]

Acho que incluir uma caixa no modal de criação de conta seria bom. Embora atualmente eles vejam o banner ao fazer login, o que pode ser mais proeminente?

[denvergeeks]

@Jagster Li isto na publicação do tópico acima…

Atualmente, o plugin suporta Mailchimp como provedor de newsletter e apenas uma newsletter global para todos os usuários. Suporte para provedores adicionais e newsletters limitadas a grupos está planejado para lançamentos futuros.

[nat (Natalie T)]

@jordan-violet

há algo que possamos fazer para garantir que isso apareça para todos os usuários existentes?

Suspeito que isso possa ser um pequeno problema (cache!) apenas para o seu usuário, já que foi você quem o ativou.

A lógica do banner para exibi-lo é muito fixa: se o usuário nunca dispensou o banner antes, ele será exibido.

[nathank (Nathan Kershaw)]

Como este plugin lida com uma Audiência existente que já contém muitos dos membros da comunidade?

E existe alguma forma de fazê-lo funcionar como ‘opt out’ (recusar) em vez de ‘opt in’ (aceitar)?
Com isso quero dizer que:

1. Todos que se inscreverem em nosso site são adicionados à Audiência automaticamente
2. O banner oferece uma opção de ‘opt out’ (ou talvez simplesmente não seja exibido)

[maiki]

@Jonathan5

Assim como com o plugin de Assinaturas, seria bom se as pessoas pudessem se inscrever na newsletter e no fórum ao mesmo tempo. Acho que só é possível para usuários já registrados.

A sugestão é boa, pois otimiza o processo.

No entanto, como alguém que administrou listas de e-mail por anos, eu preferiria muito mais ter pelo menos um nível de verificação de conta antes de adicionar um e-mail à minha lista. Isso agrega mais valor ao longo do tempo e causa menos trabalho a longo prazo.

Se o tornássemos disponível no momento do cadastro, acho que ainda preferiria esperar que eles fizessem login primeiro.

[Jonathan5]

Sim, você precisaria (como agora) de verificação por e-mail para a associação ao Discourse, e começaria a associação à lista de e-mails ao iniciar a associação ao Discourse.

[Jagster (Jakke Lehtonen)]

Essa ainda é uma ação legal em algum lugar nos países ocidentais?

[nathank (Nathan Kershaw)]

Com certeza, se estiver explícito que você também será inscrito na newsletter como parte da adesão ao site.

Na verdade, é essencialmente o mesmo pedido que:

@Jonathan5

seria bom se as pessoas pudessem se inscrever na newsletter e no fórum ao mesmo tempo.

[RGJ (Richard - Communiteq)]

@nathank

Com certeza, se estiver explícito que você também será inscrito na newsletter como parte da adesão ao site.

Isso é falso. @Jagster está correto, não é legal na UE.

A lei de telecomunicações holandesa exige que o usuário dê permissão explícita e separada para newsletters, e o GDPR tem um fundamento diferente para o processamento do fórum e da newsletter. Onde o fórum pode ser visto como cumprimento de um contrato, a newsletter requer consentimento explícito.

Portanto, você precisará de uma caixa de seleção separada, no mínimo. E se bem me lembro, há jurisprudência na Holanda de que a caixa de seleção precisa estar desmarcada por padrão.

Dito tudo isso, que ótimo plugin!

[Jonathan5]

Acho que você concorda. Com base no que você disse sobre consentimento explícito e separado, poderia ser obrigatório que a caixa de consentimento da lista de e-mails, inicialmente desmarcada, fosse marcada para que a pessoa pudesse ingressar no fórum.

[Jagster (Jakke Lehtonen)]

@RGJ

jurisprudência na NL

Isso se aplica em toda a UE. A exclusão (opt-out) é simplesmente ilegal.

E… deveria ser um grande não-não em todos os lugares de qualquer maneira, porque é apenas uma maneira ruim de forçar os usuários a receber algo que não pediram. Mas, ei, é bom para marketing e os usuários sempre podem excluir ou marcar tal newsletter, também conhecida como leads de marketing, como spam

Bem, estou indo para o off-topic, então vou sair deste ramo lateral. Mas se bem me lembro, o Mailchimp é fortemente contra a exclusão (opt-out).

[Jonathan5]

Gostaria de acrescentar que, quando fiz o pedido original, o que eu tinha em mente era uma caixa de seleção opcional e desmarcada para inscrição na lista de e-mails, que apareceria na página de inscrição do Discourse. Acho que isso estaria em conformidade com qualquer interpretação razoável do GDPR da UE e das boas práticas em todo o mundo.

[nathank (Nathan Kershaw)]

@RGJ

A lei holandesa de telecomunicações exige que o usuário dê permissão explícita e separada para newsletters,

Felizmente, eu não moro na Holanda (bem, não no momento). Existem países ‘ocidentais’ que não estão sob a lei da UE.

Isso inclui o Resumo de Atividade? Tudo depende do que é a definição de Newsletter, e onde no espectro está a coisa que realmente é enviada por e-mail.

Além disso, e quanto a uma categoria dedicada com “Observando” definido para todos os usuários por padrão? Isso poderia ser interpretado como uma newsletter se tivéssemos uma interpretação liberal.

Dito tudo isso, tenho quase certeza de que todos concordamos que enviar coisas eletronicamente para as pessoas sem o consentimento delas é definitivamente ruim (e geralmente ilegal). As leis ao redor do mundo diferem em onde está o ponto exato de aceitabilidade.