Mensajería

La funcionalidad de Mensajería en Modyo permite crear campañas masivas para enviar información a usuarios finales de forma segmentada y personalizada.

En Modyo, puedes enviar mensajes a los usuarios a través de dos canales:

• Correos: Envía campañas a las casillas de emails registradas en los perfiles de los usuarios. No es necesario ingresar a la plataforma para ver los mensajes.
• Notificaciones: Envía notificaciones a través del sistema de mensajería interno. Los usuarios deben ingresar a la plataforma para visualizarlos.

Campañas

En la sección de Campañas, puedes administrar todos los mensajes enviados a los usuarios finales. Utiliza el botón Tipo, para filtrar las campañas por el canal de envío.

Las campañas se organizan en las siguientes columnas:

• Nombre: Nombre asignado a la campaña. Puede contener el segmento específico al que se le envió.
• Tipo: Tipo de mensaje en que se envió la campaña.
• Enviados: Total de envíos realizados.
• Último envío: Fecha y hora en que se envió la campaña.
• Creado el: Fecha de creación de la campaña.

En cada fila de campaña, encontrarás un menú con las siguientes acciones:

• Editar campaña
• Borrar

Peligro

Si borras una campaña, no podrás recuperarla, y su registro se eliminará del sistema.

Alcance por segmentos

Si tu acceso al reino está restringido por segmentos, solo puedes dirigir campañas a segmentos dentro de tu alcance. Las campañas dirigidas a segmentos fuera de tu alcance se muestran en modo Solo lectura: puedes ver sus metadatos, pero no sus métricas ni destinatarios, y no puedes editarlas, enviarlas, duplicarlas ni borrarlas.

Crear una campaña

Las campañas te permiten contactar directamente a tus usuarios mediante correo electrónico o notificaciones directas, incluyendo soporte para notificaciones WebPush. Para generar una nueva campaña haz click en el botón Nueva Campaña

Campañas de Correo

Las campañas de correo te permiten contactar a los usuarios a través de email. Para configurar una campaña de correo, completa los campos solicitados en el formulario:

• Nombre: Identificador de la campaña.
• Tipo: Selecciona Correo para activar esta opción.
• Asunto: Texto que aparecerá en la línea de asunto del mensaje.
• Responder a: Dirección de correo electrónico para las respuestas de los usuarios. Si este campo se deja en blanco se usará el correo por defecto del reino.
• Plantilla: Selecciona una plantilla. Si no seleccionas una, se enviará una plantilla en blanco.
• Habilitar segmentación: Selecciona un segmento específico o deja esta opción desmarcada para enviar el mensaje a todos los usuarios.

Haz clic en Guardar y continuar para abrir el editor WYSIWYG, donde puedes personalizar el contenido de la plantilla seleccionada y usar variables de personalización. Una vez editado, selecciona Guardar para confirmar los cambios y acceder a la vista Estado de envío.

Campañas de Notificaciones

Las campañas de notificaciones permiten enviar mensajes directos a los usuarios. Para configurar una campaña de notificaciones, completa los siguientes campos en el formulario:

• Nombre: Identificador de la campaña.
• Tipo: Selecciona Notificación para activar esta opción.
• Asunto: Texto que aparecerá en el mensaje enviado.

Habilitar soporte para WebPush

Las campañas de notificaciones tienen la capacidad de enviar notificaciones WebPush. Esta funcionalidad permite a los usuarios recibir mensajes directamente en su navegador. Para habilitar esta función, asegúrate de cumplir con los siguientes requisitos:

• La aplicación web que envía las notificaciones debe estar vinculada al Realm donde se crean las campañas.
• La aplicación web debe estar en estado Enabled.
• En la sección PWA de la aplicación web, activa las opciones Habilitar service worker principal y Habilitar las notificaciones WebPush.

Además, para que los usuarios puedan recibir notificaciones WebPush, deben cumplir con lo siguiente:

• Deben estar autenticados.
• Las notificaciones deben estar habilitadas en su navegador.

Atención

Si utilizas una versión de Modyo anterior a la 10.0, actualiza tu plantilla con el código de soporte para WebPush (opens new window).

Estado de Envío

Antes de enviar una campaña, utiliza el botón de Vista previa para verificar el contenido. Una vez confirmado, haz clic en Enviar. El botón contextual te permite realizar estas acciones:

• Editor de Mensajes: Modifica el contenido antes de enviarlo.
• Enviar prueba: Envía un mensaje de prueba a una dirección específica (Únicamente puede a enviarse a usuarios con acceso al backend de Modyo).
• Editar: Cambia las propiedades de la campaña, como el segmento objetivo o la dirección de respuesta.
• Clonar la campaña: Crea una copia con todo el contenido de una campaña.
• Borrar la campaña: Elimina una campaña.

Una vez que una campaña queda Completada, no puedes enviarla nuevamente. Si deseas enviar de nuevo la misma campaña, selecciona la opción de clonar. Esto crea una nueva campaña con los mismos datos de nombre, segmentos y contenido, mientras que la información estadística parte de cero.

Puedes cancelar el envío de una campaña cuando la campaña está en cola o en proceso de envío.

Atención

Una campaña puede volver a enviarse mientras no esté Completada: el botón Enviar reaparece tanto si el envío fue cancelado como si falló.

Al enviar, la casilla No enviar esta campaña a las personas que ya la recibieron. deja fuera a quienes ya recibieron un mensaje de esta campaña. Si la dejas sin marcar, el envío recorre de nuevo a todos los usuarios del alcance y el número de entregas de mensajes puede ser mayor que el alcance total de usuarios de la campaña.

Estados de una campaña

Esta vista muestra el estado actual de la campaña junto a sus métricas. Los estados posibles son:

• Inactiva: La campaña está creada y todavía no se ha enviado.
• Pendiente: El envío ya se solicitó y está en cola, pero aún no comienza a procesarse.
• Enviando: El envío está en curso y las entregas se van generando por grupos de usuarios.
• Completada: El envío terminó de recorrer a todos los destinatarios.
• Cancelada: Alguien detuvo el envío mientras estaba Pendiente o Enviando. Las entregas generadas hasta ese momento no se revierten.
• Fallida: El envío se interrumpió por un error antes de terminar. La campaña conserva las entregas que alcanzó a generar.

El botón principal de la vista cambia según el estado: en Inactiva, Cancelada y Fallida aparece Enviar; en Pendiente y Enviando aparece Cancelar. En Completada no aparece ninguno de los dos y, además, las acciones Editor de Mensajes y Editar desaparecen del menú contextual: una campaña completada ya no se puede modificar ni reenviar, solo clonar.

Resultados del envío

En campañas enviadas por correo puedes visualizar:

• Alcance: Personas a las que les llegó la campaña.
• Enviados: Número total de correos enviados.
• Abiertos: Número total de correos abiertos.
• Abiertos únicos: Número total de usuarios los cuales abrieron alguna vez la campaña.
• Clicks: Número de veces que se ha hecho click en algún vínculo de la campaña.
• Clicks únicos: Número de usuarios que han hecho click en la campaña.
• Spam: Número de usuarios a los que el correo llegó a la bandeja de spam.

Si enviaste la campaña por notificación puedes visualizar:

• Alcance: Personas a las que les llegó la campaña.
• Enviados: Número de notificaciones enviadas.
• Abiertos: Número de notificaciones abiertas.

Si envías una campaña por segmentos puedes ver a cuál grupo de usuarios le llegó la campaña. Si esta sección no aparece, es debido a que la campaña fue enviada a todos los contactos.

Atención

Si no has enviado aún la campaña, los valores de esa campaña aparecerán en cero.

Peligro

Cuando borras un envío no puedes recuperar el registro si hiciste algún cambio en él.

Borrar una campaña cuando está en proceso de envío, no significa que no llegará a los usuarios, sino que se detiene el proceso en el punto en que se encuentra.

Hacer click en el nombre de una campaña te lleva a la sección Entregas de Mensajes.

Entregas de Mensajes

En la sección Entregas de mensajes, encuentras la lista de usuarios a los cuales les ha llegado un mensaje desde la plataforma. Aquí puedes ver una lista de todos los usuarios que han recibido un correo o notificación única, denominados "Sin Campaña".

"Sin Campaña" se refiere a un correo o notificación enviado específicamente a un usuario en una fecha determinada. Estos mensajes no se consideran Campañas, ya que están personalizados y contienen información que no se envía a otros usuarios.

Estos mensajes no se crean desde el panel, sino desde la API de administración:

• POST /api/admin/customers/{realm_uid}/messaging/mailer envía un correo a un usuario del reino.
• POST /api/admin/customers/{realm_uid}/messaging/notifications envía una notificación a un usuario del reino.

En ambos casos el destinatario se identifica por su nombre de usuario, no por su correo, y tiene que estar dentro de tu alcance por segmentos: si no lo está, el correo responde 409 y la notificación 404. El detalle de los campos de cada llamada está en el catálogo de servicios, bajo los recursos Mailer y Notifications; para abrirlo, sigue Llama usando el portal Swagger.

El correo queda encolado, así que una respuesta correcta confirma que la llamada fue aceptada, no que el mensaje ya se entregó. Su cuerpo admite %{name}, %{first_name}, %{last_name}, %{email} y %{unsubscribe_link}, un subconjunto de las variables de personalización de las campañas: %{show_link} y %{show_url} no están disponibles. Si el cuerpo usa otra variable, la llamada responde 409 con el error Body content is not valid. También responde 409 si from no es una dirección de correo válida, con el error Email '…' is not valid.

La notificación, en cambio, no admite variables, aunque las campañas de notificación sí las tengan: cualquier %{…} en su cuerpo hace que la llamada responda 409 con el cuerpo null, sin detalle del error, y la notificación no se crea.

Atención

Existe además una ruta heredada, POST /api/admin/mailer, que llega a la misma acción pero no aparece en el catálogo de servicios y no lleva el reino en la URL: hay que pasarle realm_uid como parámetro o la llamada responde 404. Se mantiene por compatibilidad; en integraciones nuevas usa la ruta del reino.

En la vista inicial los mensajes se ordenan en estas categorías:

• Nombre: Nombre del usuario al que se le envía el mensaje. Se incluye el mail del usuario, independientemente de si fue enviado por correo o notificación.
• Campaña: Campaña bajo la cual el mensaje fue enviado.
• Tipo: Vía por la cual se envió el mensaje, ya sea correo o notificación.
• Envío: Fecha en la cual se inició la campaña.
• Enviado: Fecha en la que se envió el mensaje.
• Leído: Alerta si el usuario leyó o vio el mensaje.

Además, puedes filtrar los datos bajo los siguientes filtros:

• Tipo de Campaña: Todos, correo o notificación.
• Nombre de la Campaña: Nombre que se le dio a la campaña en general.
• Envío: Fecha en la cual se envió la campaña.

La barra de búsqueda te permite buscar por algún término en específico.

Plantillas

En la sección Plantillas, puedes crear y administrar diseños de correo para tus campañas. Para crear tu mensaje en forma de correo, necesitas una plantilla en la cual añadir tu contenido.

Crear una plantilla

• Haz clic en Nueva Plantilla.
• Asigna un nombre descriptivo a la plantilla.
• Utiliza el editor WYSIWYG para personalizar el diseño.

Editar plantillas

Cada plantilla tiene un botón de edición con las siguientes acciones:

• Vista previa: Muestra el modelo de plantilla de correo guardada.
• Copiar: Permite copiar la plantilla.
• Borrar: Borra la plantilla

Atención

Cuando haces una campaña, recuerda agregar en el footer toda la información legal que exige la regulación de tu país en cuanto a correos masivos.

Para automatizar la inserción del Footer, lee Configuración de Realms

Variables de personalización

El editor de mensajes de una campaña y el editor de plantillas admiten variables que la plataforma reemplaza por los datos de cada destinatario al momento del envío. Ambos editores las listan bajo el rótulo Atributos permitidos (serán reemplazados de forma dinámica con datos).

La sintaxis es %{variable} y la lista es cerrada: no puedes inventar variables ni usar drops de Liquid. Los correos automáticos del reino sí usan Liquid, pero las campañas y las plantillas de mensajería, no.

En las plantillas y en las campañas de correo dispones de siete variables:

Variable	Se reemplaza por
%{name}	El nombre completo del destinatario.
%{first_name}	El nombre del destinatario.
%{last_name}	El apellido del destinatario.
%{email}	El correo electrónico del destinatario.
%{show_link}	Un enlace HTML listo para insertar, con el texto "El correo electrónico no se muestra correctamente? Velo en tu navegador.", que abre la versión web del mensaje.
%{show_url}	La dirección de esa versión web, sin formato, para que armes tu propio enlace.
%{unsubscribe_link}	La dirección con la que el destinatario se da de baja de los envíos del reino.

En las campañas de notificación solo están disponibles %{name}, %{first_name} y %{last_name}.

Incluir %{unsubscribe_link} en el pie del mensaje es lo que permite al destinatario darse de baja, y esas bajas son las que aparecen en Desinscripciones.

Atención

Si escribes una variable que no está en la lista del canal, la plataforma no guarda el mensaje y muestra el error Los atributos especificados no son válidos.

El editor de plantillas no hace esa comprobación: una plantilla puede guardarse con una variable inválida, y el error recién aparece cuando una campaña de correo la usa. Si la eliges al crear la campaña, Guardar y continuar no la crea y muestra No se pudo crear la campaña. con el detalle en el formulario. Si la cargas después desde el editor de mensajes con Cambiar plantilla, la plantilla no se aplica y el aviso es Hubo un error cargando la plantilla. Intenta nuevamente en unos minutos, que no menciona la variable.

Datos incompletos

Si un destinatario no tiene cargado el dato de una variable, el resultado depende de dónde lea el mensaje. En el correo, la variable se reemplaza por un texto vacío. En la versión web del correo, la que abren %{show_link} y %{show_url}, y en las notificaciones, la variable no se reemplaza: si un usuario no tiene apellido cargado, por ejemplo, ve el texto %{last_name}. Antes de usar variables de campos opcionales, revisa que estén completos en el segmento al que apuntas.

La Vista previa de una campaña resuelve estas variables con los datos de tu propia cuenta de administrador y con un enlace de baja de ejemplo, así que sirve para revisar el diseño, no para comprobar qué datos verá cada destinatario.

Desinscripciones

En esta sección, encuentras una lista de los usuarios que se han dado de baja de las campañas de correos o notificaciones a través de su perfil web.

Usa la barra de búsqueda para encontrar un usuario específico. Puedes ingresar su nombre o correo electrónico.

Cuando haces click en el nombre del usuario, puedes ver la ficha de usuario con todas las actividades que ha hecho en la plataforma.

Al final de cada nombre de usuario hay un botón que te permite reinscribir al usuario a cualquier campaña del sitio.

Peligro

Hacer una reinscripción sin autorización del usuario puede causar problemas legales. Revisa la regulación sobre correos masivos en cada país.