Para ayudar a proporcionar una experiencia más coherente a su base de usuarios, FastComments proporciona una solución de personalización de correos electrónicos para que los correos enviados a sus clientes, desde FastComments, puedan ajustarse a su identidad de marca.
En esta documentación cubriremos las características de esta solución, el lenguaje de plantillas, la localización, y más.
Creación de plantillas 
El área de administración para crear plantillas se encuentra en Personalizar -> Plantillas de correo electrónico.
Aquí verás una lista de los diferentes tipos de correos electrónicos enviados por la plataforma, con una descripción para cada plantilla que explica cuándo se utiliza.
Por ejemplo, podemos personalizar el Commenter Comment Notification email, which is Sent when a commenter has a reply to their comment.
Al hacer clic en Create Template no se aplicarán los cambios de inmediato. Puedes abrir el editor
para la plantilla predeterminada y probar la vista previa, y no habrá efecto
hasta que pulses Save.
Lenguaje de plantillas
FastComments Email Templates usa el lenguaje de plantillas EJS.
La sintaxis de ejemplo es <%= object.someValue %> para imprimir variables, y las sentencias condicionales pueden hacerse así:
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>La impresión de HTML sin escapar, como para el contenido del comentario, se hace así: <%- comment.commentHTML %>. Nótese el - en lugar de =.
Consulte el enlace anterior para más documentación sobre la sintaxis.
Localización y texto personalizado
FastComments es una plataforma localizada. Todos nuestros widgets, correos electrónicos y notificaciones están localizados.
Localizado significa que mostramos un idioma y un formato diferentes, basados en la ubicación del usuario y su idioma preferido. Determinamos esto a partir de la información que nos proporciona el navegador del usuario.
Podemos personalizar el texto en el correo electrónico yendo a la pestaña Translations, seleccionando un Locale
y editando el texto. El texto que se cambia respecto al valor predeterminado aparece resaltado en la interfaz. Usted puede
cambiar entre locales y guardar al final, sin perder los cambios.
El texto localizado se accede a través del objeto TEXT, por ejemplo: <%= TEXT.INTRO %>.
Nota sobre SSO
Para las integraciones SSO, si no se especifica locale, este se actualizará cada vez que el usuario
acceda al widget de comentarios con un locale diferente. Esto significa que su preferencia de idioma
se actualizará automáticamente, y los correos electrónicos futuros se enviarán en ese locale.
Esto también se puede establecer manualmente proporcionando locale en el payload de SSO.
Plantillas por dominio
Las plantillas se pueden configurar para que sean globales - en todo su tenant para ese tipo de plantilla, o
por dominio. En la pestaña Settings seleccione el dominio deseado.
Tenga en cuenta que si configura múltiples plantillas para el mismo dominio, solo se selecciona la primera en tiempo de ejecución. La lista de plantillas le advertirá cuando ocurra esta situación.
Datos y variables
Cada plantilla funciona dentro de un contexto diferente, lo que significa que hay distintos datos disponibles.
Una forma rápida de ver de un vistazo qué datos están disponibles es comprobar los datos de prueba
proporcionados para la plantilla. Al editar una plantilla, haga clic en la pestaña Test Data para ver
una estructura JSON.
También podemos personalizar los datos de prueba en esta área, para ver cómo queda nuestra plantilla
en distintas situaciones. Los datos de prueba se pueden restablecer a los valores predeterminados con el botón Reset.
Errores de renderizado
Desde que las plantillas de correo electrónico admiten variables y lógica, es posible crear plantillas que fallen al renderizar, o a veces fallen al renderizar.
Esto puede ser muy frustrante de diagnosticar y depurar, especialmente si es un problema intermitente, o si solo ocurre cuando los datos tienen cierta apariencia.
Para ayudar, FastComments Email Templates tiene un par de características:
- Si la plantilla falla al previsualizar, no se puede guardar. Se mostrará un mensaje de error.
- Los fallos de renderizado de plantillas se rastrean e informan en la interfaz de administración.
El segundo punto describe fallos de renderizado que ocurren en producción. Es decir, creas una plantilla que se previsualiza bien, pero que más tarde falla por alguna razón. Por ejemplo, si tenemos esto en nuestra plantilla:
<% if (comment.commenterEmail.includes('test') { %>Esto puede fallar a veces si tenemos comentarios anónimos habilitados, ya que el correo electrónico no siempre estará disponible. Entonces, ¿cómo nos enteramos de eso?
La respuesta es que los errores se muestran en dos lugares. Primero, la propia lista de plantillas muestra un recuento de errores de renderizado junto a cada plantilla.
Luego, al ver una plantilla podemos ver un recuento, por error, del número de veces que la plantilla ha fallado al renderizar.
Hay un botón de restablecer ubicado junto a cada error y su recuento, para que podamos reiniciar el contador después de haber resuelto un problema.
Aplicación de cambios
Crear y editar plantillas de correo electrónico es inmediato. Esto significa que, en cuanto presiones el botón Save, la
plataforma empezará a usar la versión más reciente de ese correo.