Integración del boletín de Discourse

[Discourse]

	Resumen	Discourse Newsletter Integration añade servicios de suscripción a boletines personalizables a tu instancia.
	Enlace al repositorio	https://github.com/discourse/discourse-newsletter-integration
	Guía de instalación	Cómo instalar complementos en Discourse

Dado que este es un complemento #oficial mantenido por el equipo de Discourse, puedes realizar solicitudes de #soporte, #contribuir:errores, #contribuir:ux y #contribuir:solicitudes de características en las categorías correspondientes aquí en Meta, etiquetándolas con la etiqueta adecuada del complemento. Haz clic en un enlace a continuación para comenzar.

 Soporte  Error  UX  Característica

Funciones

• Los administradores pueden configurar un boletín global que se sincronizará con una lista de correo en el proveedor de boletines.
• Los usuarios pueden suscribirse al boletín desde un banner del sitio
  • Una vez que se descarta el banner, no volverá a aparecer para el usuario.
• Se agrega una casilla de verificación en la página de preferencias del usuario (/my/preferences/emails), lo que permite a los usuarios cambiar su suscripción al boletín en cualquier momento.
• Los suscriptores se agregan o eliminan de la lista de correo vinculada en el proveedor de boletines a través de su API cuando los usuarios se suscriben o cancelan la suscripción.
• El complemento sincroniza el estado de suscripción entre Discourse y el proveedor de boletines.
• Actualmente, el complemento admite Mailchimp como proveedor de boletines y solo un boletín global para todos los usuarios. Se planea soporte para proveedores adicionales y boletines limitados a grupos en versiones futuras.

Guía de configuración

Para habilitar el complemento, puedes usar el interruptor en tu página /admin/plugins, o marcando la configuración de administrador discourse newsletter integration enabled. También puedes acceder a la configuración del complemento desde esta página:

Personalizar texto en el Banner y la Configuración del Usuario

Los usuarios verán un banner sobre el boletín, lo que les permitirá suscribirse o descartarlo. Este banner se puede personalizar para adaptarse mejor a las necesidades de tu foro, y solo será visible si toda la configuración relacionada con el complemento está configurada. Una vez descartado, el usuario no lo volverá a ver, pero puede optar por suscribirse desde su página de preferencias.

Puedes personalizar el texto del banner de suscripción desde el panel de administración. Aquí están las etiquetas personalizables para el 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

También puedes personalizar el nombre de tu boletín tal como lo ve cada usuario en su página de preferencias:

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

Integración con Mailchimp

Hay tres configuraciones del sitio de Discourse relacionadas con la integración de Mailchimp:

Nombre	Descripción
discourse newsletter integration mailchimp api key	Clave API para tu cuenta de Mailchimp.
discourse newsletter integration mailchimp list id	El ID de tu Audiencia de Mailchimp con la que deseas sincronizar Discourse.
discourse newsletter integration mailchimp server prefix	La parte del subdominio de la URL que ves cuando inicias sesión en tu cuenta de Mailchimp, por ejemplo, us14 y us19.

discourse newsletter integration mailchimp api key

Para generar una clave API, sigue estos pasos:

1. Navega a la sección Claves API de tu cuenta.
2. Haz clic en Crear nueva clave.
3. Nombra tu clave.
4. Haz clic en Generar clave.
5. Haz clic en Copiar clave al portapapeles. Guarda tu clave en algún lugar seguro.
6. Haz clic en Listo.

Acerca de las claves API | Mailchimp

discourse newsletter integration mailchimp list id

Cada audiencia de Mailchimp tiene un ID de audiencia único (a veces llamado ID de lista) que las integraciones, complementos y widgets pueden requerir para conectarse y transferir datos de suscriptores. El ID de audiencia es generado por el sistema de Mailchimp cuando se crea la audiencia y no se puede cambiar.

Para encontrar tu ID de audiencia, sigue estos pasos:

1. Navega a Audiencia
2. Selecciona la Audiencia que deseas
3. Haz clic en el menú desplegable Configuración y elige Nombre de la audiencia y valores predeterminados.
4. En la sección ID de audiencia, verás una cadena de letras y números. Este es tu ID de audiencia.

Encuentra tu ID de audiencia | Mailchimp

discourse newsletter integration mailchimp server prefix

Inicia sesión en tu cuenta de Mailchimp y mira la URL en tu navegador. Verás algo como https://us19.admin.mailchimp.com/; la parte us19 es el prefijo del servidor. Ten en cuenta que tu valor específico puede ser diferente.

Problemas conocidos

Este complemento tiene funcionalidad básica y funciona bien, pero aquí hay algunos problemas conocidos que manejaremos en el futuro:

Cambio de cuentas de Mailchimp

Después de configurar la integración de Mailchimp y establecer audiencias para un boletín, si cambias a una nueva cuenta (mediante la configuración del sitio), las audiencias no se sincronizarán con la nueva cuenta.

¿Alojado por nosotros? Este complemento está disponible en nuestro plan Enterprise.

[Jagster (Jakke Flemming)]

¿Funciona sin Mailchimp o es una especie de frontend para los servicios de Mailchimp (como suele ser la situación en otras plataformas)?

[nat (Natalie T)]

La intención de este plugin es ayudar a los propietarios de sitios a trabajar con proveedores de marketing por correo electrónico para enviar mensajes de marca más personalizados.

Por ahora, el único proveedor incluido en el plugin es Mailchimp, por lo que no, este plugin no funciona sin Mailchimp. Sincroniza a los usuarios del foro Discourse que optan por participar con lo que Mailchimp define como una “audiencia”.

[ked (Kenny DuBose)]

@nat Permíteme sugerir que en un futuro próximo se incluya Zoho Campaigns.

[jordan-violet]

Una cosa que noté es que, después de habilitarlo, el banner no apareció hasta que inicié sesión con un navegador incógnito.

¿Habrá algo que podamos hacer para asegurarnos de que esto aparezca para todos los usuarios existentes que ya han visitado el sitio?

[JammyDodger]

Para que conste, apareció bien para todos mis usuarios de prueba existentes cuando lo estaba probando.

[Jonathan5]

Al igual que con el plugin de Suscripciones, sería bueno que las personas pudieran registrarse en el boletín y en el foro al mismo tiempo. Supongo que solo es posible para usuarios ya registrados.

[JammyDodger]

Creo que incluir un cuadro en el modal de crear cuenta podría ser bueno. Aunque actualmente verían el banner al iniciar sesión, ¿lo cual podría ser más prominente?

[denvergeeks]

@Jagster Lo leí en el mensaje del tema anterior…

Actualmente, el plugin admite Mailchimp como proveedor de boletines y solo un boletín global para todos los usuarios. Se planea admitir proveedores adicionales y boletines limitados a grupos en futuras versiones.

[nat (Natalie T)]

@jordan-violet

¿hay algo que podamos hacer para asegurarnos de que esto aparezca para todos los usuarios existentes?

Sospecho que podría ser un pequeño error (¡caché!) solo para tu usuario, ya que eres tú quien lo activó.

La lógica del banner para que aparezca es muy fija: si el usuario nunca ha descartado el banner antes, aparecerá.

[nathank (Nathan Kershaw)]

¿Cómo maneja este plugin una Audiencia existente que ya contiene muchos de los miembros de la comunidad?

¿Y hay alguna forma de que funcione como ‘excluir’ en lugar de ‘optar por participar’?
Con esto quiero decir que:

1. Todos los que se registren en nuestro sitio se añaden automáticamente a la Audiencia.
2. El banner ofrece una opción de ‘excluir’ (o tal vez simplemente no se muestra en absoluto).

[maiki]

@Jonathan5

Al igual que con el plugin de suscripciones, sería bueno que la gente pudiera registrarse en el boletín y en el foro al mismo tiempo. Supongo que solo es posible para usuarios ya registrados.

La sugerencia es buena, ya que agiliza el proceso.

Sin embargo, como alguien que ha gestionado listas de correo durante años, preferiría tener al menos un nivel de verificación de cuenta antes de añadir un correo electrónico a mi lista. Proporciona más valor con el tiempo y causará menos trabajo a largo plazo.

Si lo pusiéramos disponible al registrarse, creo que aun así preferiría esperar a que inicien sesión primero.

[Jonathan5]

Sí, requerirías (como ahora) la verificación por correo electrónico para ser miembro de Discourse, y comenzarías a ser miembro de la lista de correo al comenzar a ser miembro de Discourse.

[Jagster (Jakke Flemming)]

¿Sigue siendo una acción legal en algún lugar de los países occidentales?

[nathank (Nathan Kershaw)]

Absolutamente, si se especifica explícitamente que también te registrarás en el boletín como parte de la unión al sitio.

En realidad, es esencialmente la misma solicitud que:

@Jonathan5

sería bueno si la gente pudiera registrarse en el boletín y el foro al mismo tiempo.

[RGJ (Richard - Communiteq)]

@nathank

Absolutamente, si se especifica explícitamente que también te registrarás en el boletín como parte de la adhesión al sitio.

Eso no es cierto. @Jagster tiene razón, no es legal en la UE.

La ley de telecomunicaciones holandesa exige que el usuario dé permiso explícito y separado para los boletines informativos, y el RGPD tiene un motivo diferente para el procesamiento del foro y el boletín informativo. Mientras que el foro puede considerarse como la ejecución de un contrato, el boletín informativo requiere consentimiento explícito.

Por lo tanto, necesitará al menos una casilla de verificación separada. Y si mal no recuerdo, hay jurisprudencia en los Países Bajos que indica que la casilla de verificación debe estar desmarcada por defecto.

Dicho todo esto, ¡qué gran plugin!

[Jonathan5]

Creo que estás de acuerdo. Basándonos en lo que has dicho sobre el consentimiento explícito y separado, se podría hacer obligatorio que la casilla de consentimiento de la lista de correo, inicialmente sin marcar, sea marcada para que la persona se una al foro.

[Jagster (Jakke Flemming)]

@RGJ

Jurisprudencia en NL

Eso se aplica en toda la UE. La exclusión voluntaria es simplemente ilegal.

Y… debería ser un gran no-no en todas partes de todos modos, porque es una forma pésima de obligar a los usuarios a recibir algo que no han solicitado. Pero bueno, es bueno para el marketing y los usuarios siempre pueden eliminar o marcar dicho boletín, también conocido como clientes potenciales de marketing, como spam

Bueno, me estoy yendo al tema principal, así que me saldré de esta rama lateral. Pero si recuerdo bien, Mailchimp está fuertemente en contra de la exclusión voluntaria.

[Jonathan5]

Debo añadir que, cuando hice la solicitud original, lo que tenía en mente era una casilla de verificación opcional y sin marcar para suscribirse a la lista de correo electrónico, que aparecería en la página de registro de Discourse. Creo que eso cumpliría con cualquier interpretación razonable del RGPD de la UE y de las buenas prácticas a nivel mundial.

[nathank (Nathan Kershaw)]

@RGJ

La ley de telecomunicaciones holandesa exige que el usuario dé permiso explícito y separado para los boletines informativos,

Afortunadamente, no vivo en los Países Bajos (bueno, no por el momento). Hay países ‘occidentales’ que no están sujetos a la ley de la UE.

¿Esto incluye el Resumen de Actividad? Todo depende de cuál sea la definición de Boletín informativo y dónde se encuentre en el espectro lo que realmente se envía por correo electrónico.

Además, ¿qué pasa con una categoría dedicada con Observando configurada para todos los usuarios por defecto? Eso podría interpretarse como un boletín informativo si se tuviera una interpretación liberal.

Habiendo dicho todo eso, estoy bastante seguro de que todos estamos de acuerdo en que enviar cosas electrónicamente a la gente sin su consentimiento es definitivamente malo (y generalmente ilegal). Las leyes de todo el mundo difieren en dónde se encuentra el punto exacto de aceptabilidad.