1. Introducción
Fideliza es una plataforma SaaS de fidelización de clientes. Permite a negocios crear y gestionar programas de lealtad sin necesidad de apps móviles ni hardware especial.
| Actor | Cómo accede | URL |
|---|---|---|
| Negocio (admin) | Email + contraseña o enlace mágico | app.fideliza.app/auth/login |
| Cliente final | Código de acceso (sin contraseña) | [tunegocio].fideliza.app/c |
cafeteria-roma.fideliza.app. Los datos de cada negocio están completamente aislados de los demás.2. Primeros pasos
2.1 Crear una cuenta
El registro tiene 2 pasos:
Paso 1 — Datos de cuenta
- 1Ve a app.fideliza.app/auth/register
- 2Ingresa tu nombre completo
- 3Ingresa tu correo electrónico
- 4Crea una contraseña (mínimo 8 caracteres) — el sistema muestra un indicador de fortaleza
- 5Confirma la contraseña
- 6Acepta los Términos de Servicio y la Política de Privacidad
- 7Haz clic en Continuar
Paso 2 — Datos del negocio
- 1Ingresa el nombre de tu negocio
- 2El sistema sugiere automáticamente un subdominio (ej. cafeteria-roma)
- 3Puedes editarlo — el sistema verifica en tiempo real si está disponible
- 4Una vez disponible, verás la URL de tu portal: [subdominio].fideliza.app/c
- 5Haz clic en Crear cuenta
2.2 Primer ingreso al sistema
Al ingresar por primera vez verás el dashboard con estadísticas en cero y acciones sugeridas.
Flujo recomendado de configuración inicial:
- 1Ir a Configuración → personalizar colores y mensaje de bienvenida
- 2Crear al menos un Programa de fidelización
- 3Agregar Recompensas al programa
- 4Registrar los primeros Clientes
- 5Compartir la URL del portal con tus clientes
🎥 Video tutorial (Guidde)
- 1Abrir navegador → ir a app.fideliza.app/auth/register
- 2Completar Paso 1: nombre, email, contraseña (mostrar el indicador de fortaleza), aceptar términos
- 3Clic en Continuar → aparece el Paso 2
- 4Escribir nombre del negocio → mostrar cómo el subdominio se genera automáticamente
- 5Editar manualmente el subdominio → mostrar el mensaje de disponibilidad
- 6Clic en Crear cuenta → mostrar el dashboard vacío con estadísticas en cero
4.1 Dashboard principal
Muestra un resumen en tiempo real del estado del negocio.
Clientes activos
Total de clientes con estado activo
Programas activos
Programas en estado "activo"
Transacciones hoy
Movimientos registrados en el día
Vouchers pendientes
Recompensas emitidas aún no canjeadas
- Actividad reciente — últimas 8 transacciones del sistema
- Programas activos — acceso directo a los programas en curso
- URL del portal del cliente — enlace listo para compartir
- Exportación CSV (solo plan Pro) — descarga el historial completo
🎥 Video tutorial (Guidde)
- 1Ingresar al dashboard → mostrar las 4 tarjetas de estadísticas
- 2Hacer scroll → mostrar la sección de actividad reciente
- 3Mostrar los programas activos
- 4Señalar la URL del portal del cliente y copiarla
- 5(Plan Pro) Mostrar el botón de exportación CSV
4.2 Clientes
Permite registrar, buscar y gestionar los clientes del negocio. La tabla muestra: nombre, código de acceso, teléfono, estado, fecha de registro y un enlace al detalle.
Crear un cliente
- 1Ir a Clientes en el menú lateral
- 2Clic en Agregar cliente
- 3Nombre (obligatorio, máx. 150 caracteres)
- 4Teléfono (opcional — formato internacional, ej. +52 55 1234 5678)
- 5Notas internas (opcional, máx. 500 caracteres — no visibles para el cliente)
- 6Clic en Guardar
Ver detalle de un cliente
- Encabezado: nombre, estado, código de acceso, teléfono, fecha, notas, botón activar/desactivar
- Inscripciones: cada programa al que está inscrito, balance actual y total histórico
- Vouchers: código, nombre de recompensa, estado, vencimiento
- Historial de transacciones: tipo, variación, balance resultante, nota, fecha
| Tipo | Ícono | Descripción |
|---|---|---|
| Ganar | ➕ | Puntos, sellos o visitas acumulados |
| Canjear | 🎁 | Recompensa emitida como voucher |
| Ajuste | ✏️ | Corrección manual del balance |
| Expirar | ⏰ | Puntos vencidos automáticamente |
| Reembolso | ↩️ | Devolución de puntos |
🎥 Video tutorial (Guidde)
- 1Ir a Clientes → mostrar la lista
- 2Clic en Agregar cliente
- 3Rellenar: nombre "Ana García", teléfono "+52 55 9876 5432", notas "Cliente frecuente"
- 4Clic en Guardar → mostrar el cliente en la lista con su código de acceso generado
- 5Hacer clic en Ver → mostrar el perfil completo
- 6Mostrar las secciones: Inscripciones, Vouchers, Historial
- 7Clic en el botón de estado → mostrar el cambio activo/inactivo
4.3 Programas de fidelización
| Tipo | Ícono | Descripción | Config requerida |
|---|---|---|---|
| Puntos | ⭐ | Acumulan puntos por gasto | Puntos por dólar (1–10,000) · Mínimo para canjear |
| Sellos | 🎟️ | Tarjeta de sellos digital | Sellos por tarjeta (2–100) |
| Visitas | 📍 | Recompensa por frecuencia de visitas | Visitas necesarias (2–500) |
| Cashback | 💰 | Porcentaje de retorno sobre compra | % de cashback (0.1–50%) · Compra mínima (opc.) |
Crear un programa
- 1Ir a Programas en el menú lateral
- 2Clic en Agregar programa
- 3Nombre (2–150 caracteres)
- 4Descripción (opcional, máx. 500 caracteres)
- 5Seleccionar el tipo (Puntos, Sellos, Visitas o Cashback)
- 6Completar la configuración específica del tipo elegido
- 7Máximo de inscripciones (opcional — vacío = ilimitado)
- 8Fecha de inicio y fin (opcional — fin debe ser posterior al inicio)
- 9Clic en Crear
Estados de un programa
| Estado | Descripción |
|---|---|
| Borrador | Solo visible para el admin. Los clientes no lo ven. |
| Activo | Los clientes pueden inscribirse y acumular. |
| Pausado | No acepta nuevas transacciones temporalmente. |
| Archivado | Finalizado. Solo consulta histórica. |
🎥 Video tutorial (Guidde)
- 1Ir a Programas → mostrar la lista
- 2Clic en Agregar programa
- 3Nombre: "Programa Puntos Café", tipo: Puntos
- 4Ingresar: 10 puntos por dólar, mínimo 100 puntos para canjear
- 5Clic en Crear → mostrar la tarjeta en la lista (estado: Borrador)
- 6Clic en la tarjeta → entrar al detalle
- 7Clic en Activar → mostrar el estado cambiado a "Activo"
4.4 Recompensas
Crear una recompensa
- 1Ir a Programas → seleccionar el programa
- 2En la sección Recompensas, clic en Agregar recompensa
- 3Nombre (obligatorio, 2–150 caracteres)
- 4Descripción (opcional, máx. 500 caracteres)
- 5Imagen (opcional — URL con HTTPS)
- 6Costo en puntos (obligatorio — número entero positivo)
- 7Stock (opcional — vacío = ilimitado)
- 8Días de expiración del voucher (opcional)
- 9Clic en Guardar
Verificar un voucher en caja
- 1Ir al detalle del programa correspondiente
- 2En la sección Verificar voucher, ingresar el código que muestra el cliente
- 3El sistema valida que el voucher esté pendiente y no expirado
- 4Confirmar el canje
🎥 Video tutorial (Guidde)
- 1Ir a un programa activo → sección Recompensas
- 2Clic en Agregar recompensa
- 3Nombre: "Café gratis", costo: 100 puntos, stock: 50
- 4Clic en Guardar → mostrar la recompensa en la tabla
- 5Desplazarse a Verificar voucher → escribir un código de ejemplo
4.5 Portal del cliente
Interfaz para el cliente final. Accede sin contraseña usando su código de acceso en la URL [subdominio].fideliza.app/c.
?code=XXXX — útil para compartir por WhatsApp o SMS.Las 3 pestañas del portal
⭐ Puntos
Vouchers pendientes · Tarjetas de inscripción con balance, progreso, sellos o contador de visitas
🎁 Recompensas
Catálogo de recompensas · Barra de progreso · Indicador de puntos suficientes · Botón Canjear
📋 Historial
Lista de transacciones recientes con ícono, tipo, variación y fecha
🎥 Video tutorial (Guidde)
- 1Abrir pestaña de incógnito (para simular la vista del cliente)
- 2Navegar a [subdominio].fideliza.app/c
- 3Ingresar un código de acceso válido → mostrar cómo carga el portal
- 4Pestaña Puntos: tarjetas de inscripción y progreso
- 5Pestaña Recompensas: catálogo, barra de progreso, clic en Canjear → voucher generado
- 6Pestaña Historial: lista de transacciones
4.6 Configuración y marca
| Campo | Descripción | Restricción |
|---|---|---|
| Color primario | Color del encabezado y botones del portal | Formato hex (#RRGGBB) |
| Color secundario | Degradado del encabezado del portal | Formato hex (#RRGGBB) |
| Mensaje de bienvenida | Texto que ve el cliente al entrar al portal | Máx. 500 caracteres |
| Etiqueta del programa | Nombre alternativo para los puntos (ej. "Estrellas") | 1–50 caracteres |
| Ícono de sello | Emoji o nombre de ícono para los sellos | 1–50 caracteres |
| URL de términos | Enlace a tus términos y condiciones | Solo HTTPS |
🎥 Video tutorial (Guidde)
- 1Ir a Configuración en el menú
- 2Cambiar el color primario → seleccionar un nuevo color
- 3Escribir mensaje de bienvenida: "¡Gracias por visitarnos!"
- 4Cambiar etiqueta del programa a "Estrellas"
- 5Clic en Guardar
- 6Abrir el portal del cliente en otra pestaña → verificar los cambios aplicados
4.7 Facturación y planes
Desde Configuración → Facturación puedes ver tu plan actual, hacer upgrade y administrar el método de pago. Los pagos son gestionados por Stripe. Fideliza no almacena datos de tarjetas.
🎥 Video tutorial (Guidde)
- 1Ir a Configuración → sección Facturación
- 2Mostrar el plan actual con sus límites
- 3Clic en upgrade → mostrar la previsualización de costo
- 4Mostrar la redirección a Stripe Checkout (sin completar el pago)
- 5Volver → mostrar el botón "Administrar método de pago"
4.8 Registro rápido
Modo de entrada rápida pensado para el personal en tienda. Disponible en /dashboard/quick.
- 1Ir a Registro rápido en el menú lateral
- 2Ingresar el código de acceso del cliente
- 3El sistema carga automáticamente el cliente y sus inscripciones activas
- 4Seleccionar el programa y registrar la transacción
- 5Confirmar — la transacción queda registrada inmediatamente
🎥 Video tutorial (Guidde)
- 1Ir a Registro rápido desde el menú
- 2Escribir el código de acceso de un cliente existente
- 3Mostrar cómo carga los datos del cliente y sus programas
- 4Seleccionar el programa → ingresar el monto o acción
- 5Confirmar → mostrar la confirmación en pantalla
5. Planes y limitaciones
| Característica | Gratis | Starter | Pro |
|---|---|---|---|
| Clientes máximos | 50 | 500 | Ilimitado |
| Programas máximos | 1 | 3 | Ilimitado |
| Tipos de programa | Puntos, Sellos | Puntos, Sellos, Visitas | Puntos, Sellos, Visitas, Cashback |
| Historial de transacciones | Últimas 50 | Ilimitado | Ilimitado |
| Catálogo de recompensas | ✗ | ✓ | ✓ |
| Exportación CSV | ✗ | ✗ | ✓ |
| Soporte prioritario | ✗ | ✗ | ✓ |
6. Errores y validaciones
Clientes
| Error | Causa | Solución |
|---|---|---|
| A customer with this phone number already exists | El teléfono ya está registrado | Verificar si el cliente ya existe en la lista |
| Failed to generate unique access code after 5 attempts | Error interno | Intentar de nuevo; contactar soporte si persiste |
Programas
| Error | Causa | Solución |
|---|---|---|
| Tu plan [X] permite máximo [N] programas | Límite del plan alcanzado | Actualizar el plan desde Configuración |
| El tipo "[tipo]" no está disponible en el plan [X] | Tipo no incluido en el plan | Actualizar el plan |
| ends_at must be after starts_at | La fecha de fin es anterior a la de inicio | Corregir las fechas |
Transacciones
| Error | Causa | Solución |
|---|---|---|
| Customer not found or inactive | El cliente no existe o está desactivado | Verificar el cliente en la lista |
| Program not found or not active | El programa está pausado o archivado | Cambiar estado del programa a Activo |
| Adjustment would result in negative balance | El ajuste dejaría balance negativo | Ingresar un ajuste menor |
| Customer must be enrolled in this program first | Cliente no inscrito | Inscribir al cliente en el programa |
Canjes
| Error | Causa | Solución |
|---|---|---|
| Reward is out of stock | La recompensa agotó su stock | Actualizar el stock o desactivar la recompensa |
| [cliente] does not have enough [label] to redeem | Balance insuficiente | El cliente debe seguir acumulando |
| Redemption code not found | El código de voucher no existe | Verificar que el código esté escrito correctamente |
| Redemption voucher has expired | El voucher venció | El cliente debe solicitar uno nuevo |
| Redemption is not pending | El voucher ya fue usado o cancelado | El voucher no es válido para canje |
Portal del cliente
| Error | Causa | Solución |
|---|---|---|
| Código no encontrado. Verifícalo e inténtalo de nuevo. | El código de acceso es incorrecto | Verificar el código en el panel de admin |
7. Buenas prácticas
Configuración inicial
- Define los colores antes de lanzar el portal. El cliente verá la identidad de tu marca desde el primer acceso.
- Escribe un mensaje de bienvenida. Aparece en el portal y mejora la experiencia.
- Personaliza la etiqueta de puntos: "Estrellas", "Granos", "Millas".
Gestión de programas
- Empieza con un solo programa. Es más fácil de comunicar y escalar.
- Usa el estado Borrador para preparar un programa antes de lanzarlo.
- No elimines programas. Usa Archivado para mantener el historial.
Gestión de clientes
- Agrega el teléfono del cliente cuando sea posible.
- Usa notas internas para registrar preferencias especiales.
- No desactives clientes sin motivo — perderán acceso al portal.
Recompensas
- Configura stock en recompensas físicas para evitar sobre-emitir.
- Usa días de expiración para crear urgencia (ej. 30 días).
- Desactiva recompensas en lugar de eliminarlas.
Operación diaria
- Usa Registro rápido en tienda para agilizar la atención.
- Revisa el Dashboard al inicio del día.
- Exporta el CSV mensualmente (plan Pro) para tener respaldo.
8. Preguntas frecuentes
¿Los clientes necesitan instalar una app?
No. El portal es una web que funciona desde cualquier navegador. Sin instalación.
¿Cómo recibe el cliente su código de acceso?
Tú se lo entregas al registrarlo. Aparece en la lista de clientes y en su ficha de detalle.
¿Puede un cliente perder sus puntos si pierde el código?
No. Puedes buscar al cliente por nombre o teléfono, recuperar su código y compartírselo.
¿Se pueden tener varios negocios en una sola cuenta?
No. Cada cuenta está asociada a un único negocio. Para múltiples negocios necesitas cuentas separadas.
¿Se pueden eliminar transacciones?
No. El historial es inmutable. Si hay un error, usa una transacción de tipo Ajuste.
¿El cliente puede ver datos de otros clientes?
No. El portal solo muestra información de ese cliente específico.
¿Qué son los "vouchers pendientes"?
Recompensas que el cliente ya canjeó desde el portal pero que aún no fueron verificadas físicamente en caja.
¿Cuándo expiran los vouchers?
Depende de la configuración de la recompensa. Sin configuración de expiración, el voucher no vence.
¿Puedo pausar un programa sin perder datos?
Sí. El estado Pausado detiene nuevas transacciones pero conserva todos los balances e historial.
¿Qué pasa si cambio de plan?
Si subes, las funciones quedan disponibles de inmediato. Si bajas (o hay problema de pago), se aplican las restricciones del plan Gratis pero los datos se conservan.