💳 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 Moneda mostrada en la app En la sección de Facturación, dentro de la plataforma, los precios de los planes y el aviso de mejora de plan se muestran en dólares estadounidenses (USD) de forma clara y consistente, para evitar ambigüedad de moneda al momento de decidir un upgrade. Los valores de esta tabla son de referencia — confirma el precio vigente en tu pantalla de Facturación. :::
:::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_unlimitedno 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
Si al confirmar un pago o una mejora de plan algo falla al crear la sesión de pago, verás un mensaje de error claro indicando qué pasó, en vez de quedarte sin respuesta. Puedes reintentar de inmediato.
En Hoteles → [tu hotel] → Facturación también encuentras un panel con el estado de tus cobros: si tu pasarela de pago (Stripe Connect u otra) está lista para recibir pagos y hacer retiros, y el estado general de tu cuenta de pagos.
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)
Para convertirse en PMS Admin: contactar al equipo de UNOZERO.