WhatsApp (Mosend)

Nuvlyx envía y recibe mensajes de WhatsApp a través de Mosend, la plataforma de WhatsApp Business de Moshipp. Los mensajes salen desde tu propia organización de Mosend y tu número: Nuvlyx solo le indica a Mosend qué enviar y a quién.

Con Mosend conectado puedes:

• Enviar a tus clientes el código para vincular su WhatsApp y algunos avisos con plantillas aprobadas por Meta.
• Crear esas plantillas desde el panel y enviarlas a aprobación.
• Activar el bot de atención, que responde a tus clientes y los guía a comprar o recargar.
• Mostrar un chat en vivo en tu tienda web.

La conexión se hace en Integraciones, pestaña WhatsApp y Chat (Mosend). Solo el dueño de la tienda (OWNER) ve esta sección.

Qué necesitas

La configuración de Mosend solo aparece si tu plan incluye el Bot AI de WhatsApp o el Chat web, o si contrataste alguno de los dos como add-on. Si no tienes ninguno, en la pestaña verás el aviso “WhatsApp y Chat en vivo con Mosend” y el botón Ver add-ons disponibles, que te lleva al catálogo de add-ons.

Lo que aparece depende de lo que tengas:

• Solo Bot AI de WhatsApp: la conexión, el número, las plantillas y el bot.
• Solo Chat web: la conexión y la tarjeta del chat web.
• Los dos: la conexión y dos subpestañas, Chat web y WhatsApp. Lo que explica esta página está en WhatsApp.

Antes de conectar: prepara Mosend y Meta

Haz esto primero

Antes de enlazar tu tienda, tu cuenta de Mosend tiene que estar lista y tu número de WhatsApp conectado a Meta (WhatsApp Business API).

La preparación se hace una sola vez:

1. Crea tu cuenta en Mosend

   Regístrate en mosend.dev y crea tu organización. Si no tienes el enlace de registro, pídeselo a soporte de Nuvlyx.

2. Conecta tu WhatsApp (WABA) y elige el portafolio

   Al conectar tu cuenta de WhatsApp Business (WABA, WhatsApp Business Account), el asistente de Meta te pide elegir tu portafolio comercial (Business Portfolio) y completar sus datos. Elige el portafolio de tu negocio y sigue el asistente hasta el final.

3. Verifica el portafolio en Meta

   Tu portafolio comercial tiene que estar verificado en Meta (verificación de empresa). Puedes hacerlo antes o después del registro, pero sin esa verificación Meta limita el envío de mensajes.

4. Usa un número con línea real

   El número que conectes debe corresponder a una línea real, que pueda recibir el código de verificación de Meta por SMS o llamada.

5. Agrega un método de pago en Meta

   Agrega un método de pago en el WhatsApp Manager de tu portafolio. Los mensajes que inicia tu negocio (plantillas) tienen costo y Meta se los cobra a esa cuenta. Sin método de pago, las plantillas no se envían.

Conectar tu cuenta en Nuvlyx

Pulsa Conectar Mosend (o Conectar ahora). Se abre la ventana Conectar WhatsApp (Mosend), con dos pestañas:

Con mi cuenta (recomendado)

Escribe el Email de Mosend y la Contraseña de tu cuenta. Si tu cuenta tiene verificación en dos pasos, escribe también el Código 2FA. Pulsa Conectar.

• Nuvlyx crea la API key y registra el webhook por ti. Tu contraseña no se guarda: solo se usa una vez para eso.
• Si tu organización tiene varios números, eliges cuál usar y pulsas Conectar con este número.
• Con este método la conexión queda encendida de inmediato.

Con API key

Úsalo si prefieres no escribir tu contraseña:

• API key: empieza por mk_live_. Se crea en el panel de desarrolladores de Mosend. En el desplegable Permisos que necesita la API key ves qué permisos debe tener.
• Organization ID: empieza por org_ y está en Configuración → Organización, dentro del dashboard de Mosend.

Pulsa Verificar y conectar: Nuvlyx comprueba los datos con Mosend antes de guardarlos. Si tu organización tiene un solo número, se elige solo. Con este método la conexión queda apagada hasta que enciendas Mosend activo, y el webhook del bot lo vinculas tú (ver Activar el bot).

Nota

La API key se guarda cifrada. En el panel solo ves su comienzo.

La tarjeta de conexión

Arriba de todo queda la tarjeta con el estado de la conexión:

• Mosend activo: el interruptor principal. Apagado, no sale ningún WhatsApp, ni siquiera los códigos de verificación. Sirve para pausar los envíos sin borrar la conexión.
• Credenciales: para cambiar la API key o el Organization ID. Deja vacío lo que no quieras cambiar.
• Desconectar: borra la conexión y la tienda deja de enviar WhatsApp. Tu cuenta de Mosend no se toca, y puedes volver a conectarla cuando quieras.
• Detalles de conexión: la organización, el comienzo de la API key y la fecha de la última actualización.
• Último error: aparece si Mosend rechazó algo, con la fecha.

Terminar la configuración

Mientras falten pasos, el panel muestra una lista con lo pendiente: Credenciales verificadas, Número de WhatsApp seleccionado, Template de OTP mapeado, Mosend activo y, como opcional, Webhook del bot vinculado (opcional). La lista desaparece cuando completas los obligatorios.

1. Elige el número

   En la tarjeta Número de WhatsApp, pulsa Elegir número (o Cambiar), elige el número desde el que saldrán los mensajes y pulsa Guardar.

2. Asigna las plantillas

   En la tarjeta Plantillas transaccionales, asigna una plantilla aprobada a cada aviso. Como mínimo, la del Código OTP de vinculación de WhatsApp. Ver Plantillas de WhatsApp.

3. Enciende Mosend

   Activa el interruptor Mosend activo en la tarjeta de conexión.

Plantillas de WhatsApp

Meta exige que los mensajes que inicia tu negocio usen plantillas aprobadas. En la tarjeta Plantillas transaccionales ves cada aviso con la plantilla que tiene asignada y su estado: Aprobada, En revisión, Rechazada, Deshabilitada o Pausada.

Aviso	Cuándo se usa
Código OTP de vinculación de WhatsApp	El código que recibe el cliente para vincular su WhatsApp a su cuenta. Es obligatorio.
Pedido entregado	Avisa al cliente que su pedido se procesó.
Backfill de items pendientes	Avisa que se entregaron productos que estaban pendientes por falta de stock.
Recarga aprobada	Confirma que el saldo se acreditó.
Recarga rechazada	Avisa que la recarga no se aprobó, con el motivo.
Producto disponible (lista de espera)	Avisa que volvió el stock de un producto que el cliente esperaba.

En cada fila puedes:

• Elegir una plantilla aprobada en Usar una aprobada…. Las variables se completan en el orden predeterminado. Si no tienes ninguna aprobada, verás Sin plantilla.
• Editar la asignación o Quitar la plantilla.
• + Crear plantilla: abre el constructor con un texto sugerido para ese aviso (ver abajo).

La plantilla del código OTP no se crea desde Nuvlyx: Meta le exige un formato fijo, así que se crea en el dashboard de Mosend.

Arriba de la tarjeta están los botones Estado (actualiza el estado de las plantillas), Nueva (crea una plantilla desde cero) y Mapear.

Mapear las variables

Mapear abre la ventana Mapeo de templates. Para cada aviso eliges una de tus plantillas aprobadas y defines qué dato va en cada variable ({{1}}, {{2}}…): por ejemplo, el nombre del cliente o el número del pedido. Si tu plantilla tiene botones con enlace dinámico o de copiar código, complétalos en Variables de botones URL dinámicos; si no, deja ese campo vacío. Pulsa Guardar templates.

Crear una plantilla con el constructor

Pulsa Nueva o + Crear plantilla para abrir Nueva plantilla de WhatsApp. Con + Crear plantilla, el formulario llega prellenado con un texto en español y las variables en el orden correcto para ese aviso.

• Nombre: se convierte solo a minúsculas con guiones bajos. Debajo ves cómo se guardará (“Se guardará como”).
• Idioma: Español (ES), Español, Español (CO), Español (MX), Inglés (US) o Portugués (BR).
• Categoría: Utilidad o Marketing.
• Cuenta de WhatsApp (WABA): solo aparece si tienes más de una.
• Encabezado (opcional): una línea de texto de hasta 60 caracteres.
• Cuerpo del mensaje (obligatorio): hasta 1024 caracteres, con botones para poner el texto en negrilla, cursiva, tachado o monoespaciado. + variable inserta la siguiente variable ({{1}}, {{2}}…). Por cada variable tienes que escribir un ejemplo, porque Meta lo pide para revisar la plantilla.
• Pie de página (opcional): hasta 60 caracteres.
• Botones (opcional, máx 3): + Respuesta, + URL o + Teléfono, con un texto de hasta 25 caracteres.
• Vista previa: muestra cómo se verá el mensaje en WhatsApp.

Pulsa Enviar a aprobación de Meta. La plantilla queda En revisión hasta que Meta responda. Mientras haya plantillas en revisión, el estado se actualiza solo; también puedes pulsar Estado. Las que están en revisión o fueron rechazadas aparecen en Plantillas en revisión / rechazadas, y las rechazadas muestran el Motivo. Solo las aprobadas se pueden asignar.

Qué mensajes salen por WhatsApp

• Código de vinculación. Cuando el cliente vincula su WhatsApp desde su cuenta en la tienda, recibe el código por WhatsApp. Requiere la plantilla OTP asignada y Mosend activo.
• Avisos de pedido, recarga y stock. Pedido entregado, Recarga aprobada y Producto disponible se envían por WhatsApp solo a los clientes que eligieron WhatsApp en sus preferencias de notificación. Los demás los reciben por el canal que eligieron, normalmente el correo.
• Ventas del Punto de venta. Puedes enviar las credenciales al cliente desde el Punto de venta.
• Conversaciones del bot. Ver Bot de WhatsApp.

Lo que hoy no sale por WhatsApp

• Las plantillas Recarga rechazada y Backfill de items pendientes se pueden asignar, pero hoy Nuvlyx no envía esos avisos por WhatsApp.
• Para que un cliente pueda elegir WhatsApp en sus preferencias, el canal WhatsApp tiene que estar activo en tu tienda, y hoy ese canal no se activa desde Configuración → Notificaciones. Consulta Correos y avisos.

Activar el bot

El bot se configura en la tarjeta Bot AI conversacional, en la misma pestaña. Para que responda solo, primero hay que vincular el webhook, que es por donde Mosend le pasa a Nuvlyx los mensajes que recibes.

1. Vincula el webhook

   En Webhook entrante (HMAC), copia la URL con Copiar. En Mosend, entra a Configuración → Webhooks salientes y registra esa URL. Mosend te devuelve una clave (signing secret): pégala en el campo y pulsa Vincular. El estado pasa de Pendiente a Vinculado.

   Si conectaste con Con mi cuenta, este paso ya quedó hecho.

2. Enciende la respuesta automática

   Activa Auto-respuesta AI. El interruptor se habilita cuando el webhook está vinculado. Si lo dejas apagado, los mensajes igual llegan para que los respondas a mano.

El resto de las opciones del bot (auto-registro, sugerencias, recordatorios, límites de compra y consumo de IA) está en Bot de WhatsApp.

Relación con otras secciones

• Qué hace el bot y qué controlas tú: Bot de WhatsApp.
• Chat en vivo en tu tienda con la misma conexión: Chat web (Mosend).
• Canales y avisos que reciben tus clientes: Correos y avisos.
• Cómo el cliente elige por dónde recibir los avisos: Notificaciones y app.