Notificaciones

Se abre desde Administración de plataforma → Notificaciones. El encabezado de la pantalla es Centro de notificaciones.

Objetivo operativo

Esta pantalla centraliza la mensajería operacional de la empresa: configura los canales de salida (correo por SMTP y WhatsApp Business), administra las plantillas de contenido, define cómo se reintentan los envíos que fallan y muestra el historial de cada entrega. Decide cómo llegan al cliente los correos de cambio de estatus, notas de venta, restablecimientos de contraseña, recordatorios de carrito abandonado y los mensajes de WhatsApp.

Una configuración correcta asegura que las notificaciones lleguen con la marca del negocio, al destinatario correcto y con el contenido esperado. Una configuración incorrecta o incompleta puede provocar envíos que fallan sin que nadie lo note, correos marcados como spam, restablecimientos de contraseña que no llegan o mensajes de WhatsApp rechazados por Meta.

Cuándo usar esta pantalla

Para configurar o cambiar los datos del servidor de correo (SMTP).
Para revisar las preferencias de envío de WhatsApp Business y probar su conexión.
Para ajustar cuántas veces y con qué espera se reintenta un envío que falló.
Para cambiar el remitente por defecto (Correo del remitente, Nombre del remitente y Responder a).
Para crear, editar, activar o pausar plantillas de correo o WhatsApp.
Para validar una plantilla con un envío de prueba antes de usarla con clientes.
Para investigar notificaciones fallidas o que no llegaron.
Para reintentar a mano una notificación que quedó Fallido.
Para revisar el historial de envíos por canal y estado.

Áreas de trabajo

Pestaña	Qué define	Efecto en la operación
Configuración	Correo (SMTP), WhatsApp Business, Reintentos de entrega y Reintento automático.	Activa o pausa canales y define cómo se envía y se reintenta.
Avisos por estatus	Qué cambios de estatus de un pedido envían aviso y por qué canal. Solo aparece si tu rol puede consultarla.	Ver la guía de avisos por estatus de orden.
Plantillas	Plantillas por canal y código, variables requeridas y si están activas o pausadas.	Contenido que recibe el cliente en cada notificación.
Entregas	Historial de envíos con estado, intentos, fecha y error.	Permite diagnosticar entregas y reintentar de forma controlada.

Cómo operar la pantalla

Abre Administración de plataforma → Notificaciones. La pantalla abre en la pestaña Configuración; la columna lateral resume los canales activos, la espera inicial y el estado del reintento automático.
En la sección Correo saliente, activa Enviar avisos por correo y captura Servidor SMTP, Puerto, Usuario, Contraseña, Nombre del remitente, Correo del remitente y Responder a (vacío: las respuestas llegan al remitente). Marca Autenticación requerida, SSL o STARTTLS según lo que pida tu proveedor de correo.
Presiona Probar conexión antes de guardar. Si falla, corrige servidor, puerto o credenciales.
Presiona Guardar correo.
En la sección WhatsApp, decide si se envían avisos por WhatsApp con Enviar avisos por WhatsApp y presiona Guardar envío. La conexión con Meta (cuenta, número y credenciales) se administra en la misma pestaña, en los canales de mensajería; consulta la guía de canales de mensajería.
Ajusta Reintentos de entrega y Reintento automático si el volumen de la empresa lo requiere, y presiona Guardar reintentos.
Cada sección se guarda con su propio botón: lo que cambiaste en otra sección y no guardaste no se guarda.
Cambia a la pestaña Plantillas. Presiona Nuevo o elige una plantilla de la Biblioteca para editarla. En WhatsApp usa únicamente variables numeradas ({{1}}, {{2}}).
En la plantilla que quieras validar, presiona Enviar prueba, captura el Destinatario y las variables requeridas, y confirma que el mensaje llegó.
Cambia a la pestaña Entregas. Filtra por estado y canal, revisa el error con Ver error y, si aplica, presiona Reintentar en los envíos Fallido o Pendiente.

Configuración de canales

SMTP

Campo o control	Para qué sirve	Cómo llenarlo bien	Impacto en la operación
Servidor SMTP	Servidor de correo saliente.	`smtp.proveedor.com`.	Servidor que se usa en la prueba y en los envíos reales.
Puerto	Puerto del servidor.	`465` para SSL, `587` para STARTTLS.	Define el tipo de conexión segura.
Usuario	Cuenta con la que se entra al servidor.	Usuario o correo autorizado por tu proveedor.	Credencial con la que el sistema se identifica ante el servidor.
Contraseña	Contraseña del servidor SMTP.	Captúrala tal cual; al volver a abrir la pantalla aparece oculta (`********`).	Necesaria para enviar.
Correo del remitente	Remitente por defecto.	`noreply@dominio.tienda`; debe pertenecer al dominio autorizado en tu proveedor.	Dirección que el cliente ve como remitente.
Nombre del remitente	Nombre que acompaña al correo.	`Ecolentes MX`.	Texto que aparece junto al correo en la bandeja del destinatario.
Responder a	Dirección de respuesta.	`soporte@dominio.tienda`.	A dónde llegan las respuestas del cliente.
SMTP habilitado	Activa el canal de correo.	Casilla.	Si está desactivado, no se envían correos transaccionales.
Autenticación requerida	Pide usuario y contraseña al servidor.	Casi siempre activo.	Necesario para la mayoría de los proveedores.
SSL habilitado	Usa SSL en la conexión.	Activo para puerto 465.	Seguridad; no se combina con STARTTLS en el mismo puerto.
STARTTLS	Activa la conexión segura después de conectar.	Activo para puerto 587.	Seguridad; no se combina con SSL en el mismo puerto.

WhatsApp Business

Campo o control	Para qué sirve	Cómo llenarlo bien	Impacto en la operación
URL de la API	Dirección del servicio de WhatsApp de Meta.	Deja el valor por defecto (`https://graph.facebook.com/v22.0`) salvo indicación de soporte.	Se usa en las pruebas y en los envíos.
Plantilla predeterminada	Plantilla de WhatsApp que se usa como referencia.	`hello_world` o una plantilla aprobada por Meta.	Referencia para pruebas base.
Idioma de la plantilla	Idioma de la plantilla predeterminada.	`es_MX`, `en_US`.	Idioma con el que Meta busca la plantilla.
WhatsApp habilitado para pruebas y envío operativo	Activa el canal.	Casilla.	Si está desactivado, no se envían mensajes de WhatsApp.

El número, la cuenta y las credenciales de Meta no se capturan en esta sección: se conectan en la sección de canales de mensajería que aparece debajo.

Reintentos de entrega y reintento automático

Campo o control	Para qué sirve	Cómo llenarlo bien	Impacto en la operación
Intentos máximos	Máximo de intentos de entrega.	`5` por defecto.	Al agotarlos, el envío queda como Fallido sin reintento.
Espera inicial	Cuánto esperar antes del primer reintento.	`1 s` (acepta `30 s`, `5 min`, `1 h`).	Primer retraso tras un fallo.
Espera máxima	La espera más larga entre dos reintentos.	`1 h`.	Tope aunque el multiplicador siga creciendo.
Multiplicador de espera	Cuánto crece la espera en cada reintento.	`2.0`.	Con `2`, cada espera es el doble de la anterior.
Variación aleatoria	Pequeña variación al azar en cada espera.	`0.1` (±10 %).	Evita que muchos reintentos coincidan al mismo tiempo.
Estado (Reintento automático)	Activa o pausa el reintento automático.	Activo por defecto.	Si está Pausado, solo se reintenta con Reintentar desde Entregas.
Frecuencia de revisión	Cada cuánto se revisa la cola de envíos fallidos.	`30 s`.	Qué tan pronto se retoma un envío fallido.
Envíos por lote	Cuántos envíos fallidos se toman en cada revisión.	`100`.	Ritmo de los reintentos.
Envíos en paralelo	Cuántos reintentos se hacen al mismo tiempo.	`4`.	Más paralelos atienden la cola más rápido, pero cargan más al proveedor.

Las esperas se escriben como 30 s, 5 min o 1 h (también 90 segundos o 1 h 30 min). Con los valores por defecto, un envío que falla se reintenta tras 1 s, luego 2 s, 4 s… (el multiplicador 2 duplica cada espera, sin pasar de 1 h) hasta agotar los intentos máximos; entonces queda como Fallido sin reintento.

Plantillas y pruebas

Campos de la plantilla

Campo o control	Para qué sirve	Cómo llenarlo bien	Impacto en la operación
Código	Identificador único por canal.	`nota-venta`, `cambio_estatus_pedido`.	Es el nombre con el que el sistema busca la plantilla al enviar un aviso.
Canal	Canal de la plantilla.	Correo o WhatsApp.	Define el formato y las validaciones.
Asunto del correo	Asunto del correo.	Puede contener variables `{{variable}}`.	Asunto que ve el cliente.
Contenido	Cuerpo del mensaje.	En correo admite formato con diseño; en WhatsApp, texto con variables `{{1}}`, `{{2}}`. Revisa el resultado en Preview.	Contenido que recibe el destinatario.
Variables requeridas (separadas por comas)	Datos que la plantilla necesita.	`orderNumber,customerName`.	Son obligatorias en el envío de prueba y en el envío real.
Plantilla activa para uso operativo	Activa o pausa la plantilla.	Casilla.	Una plantilla pausada no se usa para envíos.
Origen (Empresa / Base)	Indica de dónde viene la plantilla.	Etiqueta automática.	Empresa es propia; Base viene del catálogo general de la plataforma.

Plantillas heredadas y propias

La Biblioteca muestra juntas las plantillas propias de la empresa (Empresa) y las heredadas del catálogo general de la plataforma (Base).
Las plantillas Base no se pueden eliminar.
Si editas una plantilla Base, el sistema crea una copia propia de la empresa con el mismo código y canal; la original del catálogo no cambia.
El sistema distingue las plantillas que siguen idénticas a las que trae la plataforma de las que ya se editaron a mano.

Envío de prueba

El botón Enviar prueba abre una ventana con el canal, el Destinatario y las variables requeridas.
La casilla Usar configuración actual sin guardar usa los datos de canal que escribiste en Configuración aunque todavía no los hayas guardado; es útil para validar credenciales antes de guardar.
En correo, el destinatario debe ser una dirección válida.
En WhatsApp, el destinatario es un número con lada internacional, de 8 a 15 dígitos (por ejemplo +5215512345678).
Se permiten hasta 5 envíos de prueba por minuto por empresa.

Estados de una notificación

Estado en pantalla	Significado	Efecto en la operación
Pendiente	Creada por un evento del negocio, aún sin procesar.	Espera al reintento automático o se puede reintentar a mano.
En cola	Formada para procesarse.	Espera su turno de envío.
Enviando	Se está enviando al proveedor en este momento.	No se debe reintentar hasta que termine.
Enviado	Aceptada por el proveedor.	Cuenta como envío exitoso.
Entregado	El proveedor confirmó la entrega.	Estado final exitoso.
Fallido	Falla temporal y recuperable.	Se reintenta automáticamente; también admite Reintentar.
Fallido sin reintento	Falló después de agotar los intentos, o tuvo un error que no se puede recuperar.	Requiere revisar y corregir la causa; ya no se reintenta.
Leído	El destinatario la leyó (si el canal lo reporta).	Estado final exitoso.
Cancelado	Cancelada por un usuario o por el sistema.	Estado final.
Vencido	Expiró antes de entregarse.	Estado final.

Historial de entregas

Campo o control	Para qué sirve	Cómo usarlo	Impacto en la operación
Filtro de estado (Todos los estados)	Muestra envíos por estado.	Usa Fallido para el trabajo diario y Entregado para confirmar.	Reduce la tabla a los casos relevantes.
Filtro de canal (Todos los canales)	Filtra por Correo o WhatsApp.	Elige el canal con problemas.	Aísla fallas por proveedor.
Paginación	Recorre el historial por páginas.	Muestra 25 registros por página por defecto.	Afecta la velocidad de carga.
Tabla de entregas	Lista Canal, Destinatario, Estado, Intentos y Fecha.	Identifica patrones de falla.	Permite priorizar correcciones.
Ver error	Abre el Mensaje de error y el Último intento.	Lee el mensaje que devolvió el proveedor.	Ayuda a encontrar la causa.
Reintentar	Vuelve a intentar el envío de inmediato.	Solo para Fallido o Pendiente.	Registra un intento nuevo en el historial.

Acciones disponibles y comportamiento

Acción	Qué hace	Cuándo usarla
Guardar correo / Guardar envío / Guardar reintentos	Guarda sólo su sección de Configuración: correo saliente, envío por WhatsApp o reintentos.	Después de editar esa sección.
Probar conexión (correo)	Comprueba servidor, puerto y credenciales contra el servidor de correo sin guardar.	Antes de guardar cambios del servidor de correo.
Nuevo	Abre el editor de plantilla en blanco.	Para crear una plantilla propia de la empresa.
Guardar (plantilla)	Crea o actualiza la plantilla.	Después de editar código, canal, asunto, contenido o variables.
Eliminar (plantilla)	Desactiva una plantilla propia.	Para retirar una plantilla de la empresa. No aplica a las Base.
Enviar prueba	Envía la plantilla a un destinatario de prueba.	Para validar contenido, variables y configuración del canal.
Filtros de Entregas	Recargan la tabla con el estado y el canal elegidos.	Cada vez que cambias los filtros.
Ver error	Abre el detalle de una entrega con el mensaje de error y los intentos.	Cuando una notificación está Fallido o Fallido sin reintento.
Reintentar	Reintenta de inmediato una notificación Fallido o Pendiente.	Cuando ya corregiste la causa y quieres volver a enviarla.

Errores comunes y prevención

Situación	Cómo prevenirla
"SMTP host is required" en la prueba	Captura el Servidor SMTP antes de probar la conexión.
"WhatsApp token is required" / "phoneNumberId is required"	Completa el token y el número en la conexión de WhatsApp (sección de canales de mensajería).
"SMTP connection failed"	Revisa servidor, puerto, SSL/STARTTLS, credenciales y que tu red permita la salida al servidor de correo.
"WhatsApp connection failed"	Valida que el token no haya vencido y que el número esté autorizado en Meta.
"Campo obligatorio." al guardar la plantilla	Código y Contenido son obligatorios.
"Formato inválido para WhatsApp"	En WhatsApp usa solo variables numeradas: `{{1}}`, `{{2}}`.
"Template already exists"	No repitas el mismo Código en el mismo canal dentro de la empresa.
"Cannot delete inherited template"	Las plantillas Base no se eliminan; edítalas para crear una copia propia.
"Rate limit exceeded" al enviar prueba	Espera un minuto; el límite es de 5 envíos de prueba por empresa.
"Notification is not retryable"	Solo se reintenta a mano si está Fallido o Pendiente.
No aparecen entregas aunque se envió algo	Revisa que los filtros de estado y canal no sean demasiado restrictivos y que estés en la página correcta.
La prueba de WhatsApp no llega al destinatario	Confirma que el número es válido, que el destinatario tiene WhatsApp activo y que el país acepta mensajes de la cuenta.
El correo llega a spam	Pide a quien administra tu dominio que configure SPF, DKIM y DMARC para el dominio del Correo del remitente, y evita un Nombre del remitente genérico.

Checklist operativo

Verifiqué los datos de SMTP con Probar conexión antes de guardar.
Verifiqué la conexión de WhatsApp Business (token y número) con Probar conexión.
Configuré Correo del remitente y Nombre del remitente coherentes con la marca de la empresa.
Configuré Responder a con un buzón de soporte que alguien atiende.
Revisé que Intentos máximos, Espera inicial y Frecuencia de revisión sean razonables para el volumen de la empresa.
Creé o edité plantillas con las variables correctas y las probé antes de activarlas.
En plantillas de WhatsApp usé únicamente variables numeradas ({{1}}, {{2}}).
Reviso la pestaña Entregas al menos una vez al día para detectar envíos Fallido y Fallido sin reintento.
Reintento a mano solo después de corregir la causa (credenciales, token, plantilla o destinatario).
No intento eliminar plantillas Base; si las edito, entiendo que se crea una copia propia.
Respeto el límite de envíos de prueba para no quedar bloqueado un minuto.

Preguntas frecuentes

1. ¿Cuál es la diferencia entre "Probar conexión" y "Guardar correo"?

Probar conexión comprueba los datos contra el servidor de correo sin guardar nada. Guardar correo guarda la configuración de la empresa; lo que no personalices conserva los valores predeterminados de la plataforma.

2. ¿Puedo usar la configuración sin guardarla para un envío de prueba?

Sí. La ventana de prueba tiene la opción Usar configuración actual sin guardar, que usa los datos escritos en Configuración sin guardarlos. Es útil para validar credenciales antes de dejarlas fijas.

3. ¿Por qué no puedo eliminar una plantilla que aparece como "Base"?

Es una plantilla heredada del catálogo general de la plataforma, compartido con otras empresas, por eso no se puede eliminar. Si la editas, el sistema crea automáticamente una copia propia de la empresa.

4. ¿Qué pasa si cambio el código de una plantilla existente?

El Código junto con el Canal identifican a la plantilla. Si cambias el código, los avisos que buscaban la plantilla con el código anterior dejan de encontrarla y los envíos pueden fallar con el error TEMPLATE_NOT_FOUND.

5. ¿Por qué una notificación sigue en "Fallido" aunque ya presioné Reintentar?

Si el reintento manual falla otra vez, el estado vuelve a Fallido y el reintento automático seguirá intentando hasta llegar a Intentos máximos. Cuando se agotan, pasa a Fallido sin reintento. Revisa el mensaje con Ver error antes de reintentar.

6. ¿Cuántos reintentos automáticos se hacen?

Hasta el valor de Intentos máximos (5 por defecto). La espera entre intentos crece según Espera inicial, Multiplicador de espera, Espera máxima y Variación aleatoria.

7. ¿Dónde se guardan las contraseñas y tokens de SMTP y WhatsApp?

Se guardan en la configuración de la empresa dentro de la plataforma y nunca se vuelven a mostrar: al abrir la pantalla aparecen como ********. Si guardas sin cambiarlos, se conserva el valor real.