💳 Planes, Límites y Feature Gating

Referencia clara de qué puede hacer cada plan y cómo el sistema controla el acceso.

Tabla de planes

Funcionalidad	Freemium	Matrix	Pro	Pro Unlimited
Precio	Gratis	39€/mes	69€/mes	A convenir
Conversaciones incluidas/mes	30	900	1.500	Sin límite
Excedente por conversación	No disponible	0,09€	0,09€	No aplica
Paquetes adicionales (+30 conv)	No	5€	5€	No aplica
Canal Web Chat (widget)	✅	✅	✅	✅
Canal WhatsApp Business	❌	✅	✅	✅
Canal Instagram / Facebook	❌	✅	✅	✅
Google Calendar sync	❌	✅	✅	✅
Disponibilidad real (PMS)	❌	✅	✅	✅
Reserva directa vía chat	❌	✅	✅	✅
Comparación precios OTA	❌	❌	✅	✅
Cadenas Hoteleras	❌	❌	✅	✅
Promociones activas	Máx. 3	Ilimitadas	Ilimitadas	Ilimitadas
Paquetes de viajero	❌	Máx. 10	Ilimitados	Ilimitados
Reglas de descuento	❌	Máx. 10	Ilimitadas	Ilimitadas
Marca blanca (PMS Admin)	❌	✅	✅	✅
Exportar conversaciones	✅	✅	✅	✅
Dashboard de analytics	Básico	Completo	Completo	Completo
Soporte	Comunidad	24h SLA	12h SLA	12h SLA
Usuarios por hotel	2	10	Ilimitados	Ilimitados

:::info Códigos de plan Los nombres de marketing son Freemium / Matrix / Pro / Pro Unlimited. En el sistema (base de datos y API) corresponden a los códigos free, matrix, pro y pro_unlimited. El plan pro_unlimited elimina el contador de conversaciones y no genera cargos por excedente. :::

Cómo funciona el control de límites (Feature Gating)

El sistema controla el acceso a funcionalidades por plan_code en tiempo real. La lógica vive en el backend (subscriptions + conversation_counters).

Flujo de conversación con límite

Usuario inicia conversación
        ↓
Backend: ¿conversation_counter >= conversations_limit?
    ├── NO  → Conversación permitida, incrementa contador
    └── SÍ  → Bot envía autorespuesta: "Límite alcanzado"
              Sistema registra overage_conversations
              Envía warning_email_sent_at (si no enviado)

Cómo se cuenta una «conversación»

• Una sesión de chat se cuenta como 1 conversación al iniciarse
• La sesión tiene ventana de 24 horas — mensajes dentro del mismo día = 1 conversación
• Si el huésped vuelve al día siguiente, es una nueva conversación

Reset del contador

• El contador se reinicia automáticamente cada 30 días desde billing_cycle_start_date
• Para paquetes adicionales (+30 conv por 5€), el límite aumenta inmediatamente después del pago
• En el plan pro_unlimited no hay contador activo — las conversaciones son ilimitadas

Feature gating — qué ve el usuario según plan

Si intenta acceder a una función bloqueada

• Aparece un banner o modal con el mensaje: «Esta función requiere plan [Matrix/Pro]. Actualiza tu plan para acceder.»
• CTA directo: «Ver planes» → redirige a la sección de Facturación
• Nunca se muestra un error técnico al usuario final

Funciones bloqueadas en Freemium — comportamiento del bot

Situación	Comportamiento
Huésped pide disponibilidad exacta	Bot responde con «tarifa base aproximada» — no disponibilidad real
Huésped quiere reservar directamente	Bot genera pre-reserva: captura datos + notifica al hotel manualmente
Huésped pide comparar con Booking.com	Bot ignora la comparación, enfoca en valor del hotel
Límite de 30 conv alcanzado	Bot envía autorespuesta y deja de responder hasta el próximo ciclo
Lead generado sin canal configurado	El lead no genera notificación (requiere WhatsApp o email configurado)

SLAs de soporte por plan

Plan	SLA garantizado	Prioridad interna
Pro / Pro Unlimited	12 horas	Alta
Matrix	24 horas	Media
Freemium (o sin plan activo)	72 horas	Baja

Ciclo de facturación (Stripe Connect)

Registro en plan Matrix/Pro
        ↓
Stripe crea suscripción mensual (stripe_subscription_id)
        ↓
Pago automático cada 30 días
        ↓
Si pago falla → Hotel pasa a Freemium hasta regularizar
        ↓
Si excede conversaciones → Se factura overage automáticamente
        ↓
Descarga de factura disponible en Hoteles → [tu hotel] → Facturación

aviso

Los pagos en Colombia (PSE/Nequi) vía Wompi son funcionalidad planificada para Fase 3 (aún no disponible en todos los planes). Actualmente solo Stripe (tarjeta internacional) y Wompi para mercados específicos.

Marca blanca (PMS Admin)

Los pms_admin son revendedores que pueden gestionar múltiples hoteles bajo su propia marca:

• Tienen su propio panel de administración con lista de hoteles referidos
• Reciben comisión por hotel activo (configurada en platform_commission_configs)
• Pueden personalizar el branding del chatbot para sus clientes
• El hotelero ve el chatbot con la marca del PMS Admin, no de HotelChatBook
• Subdominios personalizados disponibles (ej: pms-lamaravilla.hotelchatbook.io)

tip

Para convertirse en PMS Admin: contactar al equipo de UNOZERO.