Integração do Newsletter do Discourse

[Discourse]

	Resumo	A integração Discourse Newsletter Integration adiciona serviços de assinatura de boletins informativos personalizáveis à sua instância.
	Link do Repositório	https://github.com/discourse/discourse-newsletter-integration
	Guia de Instalação	Como instalar plugins no Discourse

Como este é um plugin #oficial mantido pela equipe do Discourse, #suporte, Contribute > Bug, Contribute > UX e Contribute > Feature podem ser solicitados nas categorias respectivas aqui no Meta, e marcados com a tag apropriada do plugin. Clique em um dos links abaixo para iniciar uma nova discussão.

 Suporte  Bug  UX  Recurso

Recursos

• Os administradores podem configurar um boletim informativo global que será sincronizado com uma lista de mailing no provedor de boletins.
• Os usuários podem se inscrever no boletim informativo por meio de um banner no site.
  • Uma vez que o banner seja descartado, ele não aparecerá mais 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 do boletim informativo a qualquer momento.
• Os assinantes são adicionados ou removidos da lista de mailing vinculada no provedor de boletins por meio de sua API quando os usuários se inscrevem ou cancelam a assinatura.
• O plugin sincroniza o status da assinatura entre o Discourse e o provedor de boletins.
• Atualmente, o plugin oferece suporte ao Mailchimp como provedor de boletins e apenas a um boletim informativo global para todos os usuários. O suporte para provedores adicionais e boletins limitados a grupos está planejado para versões futuras.

Guia de Configuração

Para habilitar o plugin, você pode usar o alternador na 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 nas Configurações do Usuário

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

Você pode personalizar o texto do banner de inscrição no painel administrativo. 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 do seu boletim informativo 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 do Mailchimp.
discourse newsletter integration mailchimp list id	O ID da Audiência do Mailchimp que você deseja sincronizar com o Discourse.
discourse newsletter integration mailchimp server prefix	A parte do subdomínio da URL que você vê quando faz login na sua conta do 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 API Keys da sua conta.
2. Clique em Create New Key.
3. Dê um nome à sua chave.
4. Clique em Generate Key.
5. Clique em Copy Key to Clipboard. Salve sua chave em algum lugar seguro.
6. Clique em Done.

Sobre Chaves de API | Mailchimp

discourse newsletter integration mailchimp list id

Cada audiência do Mailchimp tem um ID de audiência único (às vezes chamado de ID de lista) que integrações, plugins e widgets podem exigir para conectar e transferir dados de assinantes. O ID de 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é Audience
2. Selecione a Audiência desejada
3. Clique no menu suspenso Settings e escolha Audience name and defaults.
4. Na seção Audience ID, 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 na sua conta do Mailchimp e observe a URL no 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 possui funcionalidade básica e funciona bem, mas aqui estão alguns problemas conhecidos que trataremos no futuro:

Alteração de contas do Mailchimp

Após configurar a integração com o Mailchimp e estabelecer audiências para um boletim informativo, se você alterar para uma nova conta (por meio 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 Flemming)]

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 Flemming)]

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 Flemming)]

@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.