Configurar y habilitar mensajes por WhatsApp

Objetivo de esta guía

El canal de WhatsApp en Coder Gym te permite mantener una comunicación directa, personalizada y fluida con tus miembros. Al configurar este canal, podrás enviar felicitaciones de cumpleaños, recordatorios de vencimientos de membresía y avisos de membresías ya vencidas de forma manual y con textos pre-cargados para ahorrar tiempo administrativo.

Esta guía detalla el proceso para habilitar el canal de WhatsApp, configurar las plantillas de mensajes y enviar las notificaciones desde la vista de membresías.

---

Ruta de navegación

1. Inicia sesión en la Admin App con una cuenta de Propietario o Administrador autorizado.
2. En el menú lateral izquierdo, ve a Ajustes.
3. En el panel de Ajustes, haz clic en Ajustes de WhatsApp.

---

Habilitar y Configurar Canal de WhatsApp

1) Activar el canal

En la pantalla de ajustes, activa el interruptor Habilitar canal de WhatsApp. Al activarlo, se desplegarán las opciones de proveedor y plantillas de mensaje.

2) Seleccionar el proveedor

El sistema cuenta con un selector de proveedores de mensajería:

• Manual (wa.me) [Activo]: Habilita un botón de WhatsApp directo en la vista de membresías para enviar los mensajes a través del cliente de WhatsApp (aplicación móvil o WhatsApp Web) de forma manual.
• Evolution API (Automatización) [Próximamente]: Integración planificada para envíos automatizados directos a través de un servidor Evolution API.
• Twilio (Automatización) [Próximamente]: Integración planificada para envíos automatizados a través del proveedor oficial Twilio.

Nota: Actualmente, la operación se realiza a través de la opción Manual (wa.me), la cual es gratuita y utiliza tu propia cuenta de WhatsApp para despachar los mensajes.

---

Configuración de Plantillas de Mensaje

Puedes definir textos específicos para tres tipos de eventos. Al redactar tus plantillas, puedes emplear variables que el sistema reemplazará automáticamente con la información del miembro:

Variables dinámicas disponibles

• {{first_name}} (o {{1}}): Se reemplaza con el primer nombre del miembro.
• {{expiration_date}} (o {{2}}): Se reemplaza con la fecha de vencimiento formateada (ej. “17 de junio de 2026”). Solo es válido para plantillas de Vencimiento y Membresía ya vencida.

Categorías de Plantilla

A. Cumpleaños

Mensaje de felicitación para miembros que cumplen años en el día en curso.

• Variable permitida: {{first_name}}
• Ejemplo predeterminado: ¡Feliz cumpleaños {{first_name}}! 🎂 Te deseamos un gran día entrenando duro en nuestro gimnasio.

B. Vencimiento de membresía (Recordatorio de renovación)

Aviso preventivo para miembros cuya membresía está activa pero está próxima a vencer.

• Variables permitidas: {{first_name}}, {{expiration_date}}
• Ejemplo predeterminado: Hola {{first_name}}, te recordamos que tu membresía vence pronto ({{expiration_date}}). ¡Renueva para seguir entrenando!

C. Membresía ya vencida

Mensaje informativo para miembros que ya tienen su membresía caducada, invitándolos a reincorporarse y renovar.

• Variables permitidas: {{first_name}}, {{expiration_date}}
• Ejemplo predeterminado: Hola {{first_name}}, tu membresía venció el {{expiration_date}}. ¡Renuévala y sigue entrenando! 💪

---

Asistentes de Redacción (IA y Generación Aleatoria)

Para facilitarte la redacción de mensajes llamativos y profesionales, cada plantilla cuenta con dos herramientas en la esquina superior derecha de su campo de texto:

1. Asistente de Plantillas / Generación asistida (Icono de IA / Cerebro): Abre una ventana emergente con múltiples opciones pre-redactadas. Al seleccionar una opción, el sistema autocompletará el nombre de tu gimnasio en el marcador {{gym_name}} de la plantilla.
2. Generación Aleatoria (Icono de Varita / Generador): Elige al azar una de las plantillas del listado del sistema y la coloca en el campo de texto, con el nombre del gimnasio ya resuelto.

Una vez que definas los textos a tu gusto, presiona el botón Guardar en la esquina superior derecha de la pantalla para almacenar tu configuración.

---

Cómo enviar mensajes desde la lista de membresías

Una vez habilitado y configurado el canal, podrás enviar los mensajes a tus clientes:

1. Ve al módulo de Membresías en la Admin App.
2. Ubica al miembro correspondiente. En su tarjeta de membresía, verás el botón Enviar mensaje con el icono de WhatsApp.
   • Nota: Si el miembro no cuenta con un número de teléfono celular registrado, el botón se mostrará como Sin celular y estará inhabilitado.
3. Haz clic en el botón Enviar mensaje. Se desplegará un menú emergente con las siguientes opciones según el estado actual del miembro:
   • Feliz cumpleaños: Disponible únicamente si el miembro cumple años hoy.
   • Membresía vencida: Disponible si la membresía se encuentra expirada.
   • Recordatorio de renovación: Disponible si la membresía sigue activa.
   • Mensaje personalizado: Abre una ventana emergente para que escribas un texto libre en el momento.
4. Al seleccionar la opción deseada, el sistema procesará la plantilla (reemplazando {{first_name}} y {{expiration_date}}), registrará el envío en el historial de la base de datos y abrirá automáticamente la aplicación de WhatsApp (o WhatsApp Web en PC) con el chat del cliente y el mensaje pre-cargado en la caja de texto.
5. Revisa el texto final y presiona Enviar dentro de WhatsApp para completar el envío.