Blueprint
Celebra Global: producto, arquitectura y MVP
Decisiones concretas para arrancar el desarrollo. Precios, límites y capacidades de APIs externas deben verificarse en la documentación oficial vigente antes de construir.
1.Resumen ejecutivo
Celebra Global es una aplicación web y móvil donde configuras una vez las fechas importantes de las personas que te importan —familia, amigos, clientes o empleados— y la plataforma envía por ti la felicitación, en el canal autorizado que elijas, a la hora local del destinatario, todos los años. Configúralo una vez. Celebra siempre.
2.Problema que resuelve
- Las personas olvidan fechas importantes y luego sienten culpa social.
- Recordar no es suficiente: falta tiempo y energía para redactar un mensaje que no suene genérico.
- Las empresas felicitan de forma irregular y sin coherencia de marca ni permisos claros.
- Los equipos internacionales fallan con zonas horarias, idiomas y festividades locales.
- Las soluciones actuales son recordatorios de calendario que no envían nada.
3.Propuesta de valor
No es un recordatorio: es una ejecución. Celebra Global convierte una intención en un envío real, culturalmente adecuado y con consentimiento, sin intervención humana.
Posicionamiento: “Nunca vuelvas a llegar tarde a una fecha importante.”
4.Usuarios objetivo
| Segmento | Necesidad | Decisión de producto |
|---|---|---|
| Particulares | Recordar 10-30 fechas y enviar algo cálido | Onboarding en 3 minutos, plan gratuito |
| Familias | Calendario compartido de la familia | Espacio compartido, 5 usuarios |
| Profesionales | Fidelizar 200-1.000 clientes | Plantillas propias y tono de marca |
| Empresas | Miles de contactos, permisos y marca | Business: segmentos, roles, aprobaciones, analítica |
5.Funcionamiento de la aplicación
- Registro con email o proveedor social; se define país, idioma y zona horaria.
- Onboarding: “¿A quién no quieres olvidar nunca?” → alta de 1-3 contactos con su fecha.
- Cada contacto guarda relación, país, idioma, zona horaria, canal preferido y consentimiento.
- Se crea la celebración: tipo, fecha, hora local, recurrencia y canal.
- El asistente propone 3 mensajes según relación, evento, cultura y tono; el usuario edita o acepta.
- Se adjunta multimedia permitida: enlace de YouTube, imagen propia, GIF o tarjeta digital.
- Se eligen reglas: enviar automáticamente o pedir aprobación, y recordatorio previo.
- El planificador calcula la próxima ejecución en UTC a partir de la zona del destinatario.
- El día del evento el trabajo entra en cola, se envía por la API oficial y se registra el estado.
- El usuario recibe confirmación (enviado, entregado, leído si el canal lo reporta, o error con motivo).
6.Funciones principales
| Función | Descripción | Particular | Empresa | MVP |
|---|---|---|---|---|
| Contactos | Alta manual, relación, país, idioma, consentimiento | Sí | Sí + importación CSV | Sí |
| Celebraciones | Evento único o recurrente con hora local | Sí | Sí | Sí |
| Calendario inteligente | Personales + festividades por país y cultura | Sí | Sí | Parcial |
| Mensajes con IA | Generación por relación, tono, cultura, idioma | Sí | Sí + tono de marca | Sí |
| Plantillas | Reutilizables con variables | Sí | Corporativas y aprobadas | Sí |
| Multimedia | Enlaces, imágenes, GIF, tarjetas, vídeo propio | Sí | Sí | Solo enlaces e imagen |
| Automatizaciones | Recurrencia, aprobación, rotación de plantilla | Sí | Sí + reglas por segmento | Sí |
| Historial de envíos | Estado, motivo de error, reintentos | Sí | Sí + exportación | Sí |
| Canales | WhatsApp y Telegram | Sí | Sí | WhatsApp + Telegram |
| Segmentos y campañas | Grupos y envíos por festividad | No | Sí | No |
| Roles y aprobaciones | Varios usuarios por organización | No | Sí | No |
| Analítica | Entrega, apertura, respuesta, bajas | Básica | Avanzada | Básica |
| Facturación | Suscripción y consumo por mensaje | Sí | Sí | Sí |
7.Ejemplo completo de uso
Una usuaria en Madrid registra a su hermano, que vive en Lima. Indica relación “hermano”, fecha 14 de marzo, zona horaria America/Lima y confirma que él acepta recibir sus mensajes. Elige cumpleaños recurrente a las 08:00 hora de Lima, canal WhatsApp, tono familiar. El asistente propone tres textos; ella escoge uno, añade el enlace de una canción de cumpleaños en YouTube y activa “rotar plantilla cada año” más recordatorio 3 días antes. El sistema guarda la próxima ejecución en UTC (13:00 UTC del 14 de marzo), envía ese día por la API oficial y muestra “entregado”. Al año siguiente vuelve a ejecutarse con un texto distinto sin que ella intervenga.
8.Automatizaciones
- Recurrencia anual, mensual o única, con soporte de 29 de febrero (se ejecuta el 28 en años no bisiestos).
- Hora fija en la zona del destinatario o en la del usuario, a elección.
- Recordatorio previo configurable (1-30 días) por aviso dentro de la app.
- Envío automático sin confirmación, o aprobación previa con caducidad (si nadie aprueba, no se envía).
- Rotación de plantillas para evitar repetir el mismo texto cada año.
- Generación automática del mensaje en el momento del envío (texto siempre fresco).
- Reintentos con retroceso exponencial y ventana máxima de 6 horas; si falla, aviso al usuario.
- Pausa automática si el contacto se da de baja o si se supera el límite antispam del plan.
9.Inteligencia artificial
Un asistente genera y adapta mensajes a partir de nombre, relación, edad aproximada cuando aplica, tipo de celebración, país, cultura, idioma, formalidad, personalidad y contexto personal o corporativo. Estilos disponibles: cariñoso, divertido, emotivo, elegante, profesional, religioso, familiar, romántico, breve y creativo.
- Localización cultural, no traducción literal: se adaptan referencias, tratamiento formal y símbolos.
- Se evita contenido religioso salvo elección explícita del usuario.
- Verificación de longitud y formato según el canal (plantillas de WhatsApp con variables, límite de Telegram).
- Nunca se envía texto generado sin que exista una versión guardada y auditable.
10.Canales de comunicación
| Canal | Uso previsto | Integración | Limitaciones | Prioridad |
|---|---|---|---|---|
| Felicitaciones 1:1 personales y corporativas | WhatsApp Business Platform (API oficial vía proveedor) | Requiere opt-in del destinatario y plantilla aprobada para iniciar conversación; coste por mensaje según categoría y país; verificar tarifas y políticas vigentes | Alta (MVP) | |
| Telegram | Felicitaciones automáticas con texto, enlaces, imágenes y vídeo | Bot API oficial de Telegram (bot creado con @BotFather) | El destinatario debe haber iniciado el bot o compartir un grupo con él; sin coste por mensaje | Alta (MVP) |
| Messenger | Felicitaciones a personas que ya escribieron a la página de Facebook | Messenger Platform oficial (página de Facebook + token de página) | Solo permite escribir dentro de la ventana de 24 h desde el último mensaje de la persona, o con etiquetas de mensaje autorizadas; no permite iniciar felicitaciones a listas nuevas | Media (V1) |
Fuera de alcance: email, SMS e Instagram quedan descartados como canales de envío. También queda fuera automatizar WhatsApp personal mediante clientes no oficiales, scraping de contactos, simulación de acciones humanas y envíos sin consentimiento. Cuando WhatsApp no permita iniciar la conversación, las alternativas son Telegram y, si la persona ya escribió a tu página, Messenger.
11.Sistema internacional
- Idiomas de interfaz con archivos de traducción por locale; añadir un idioma no requiere tocar código.
- Zonas horarias por contacto: las fechas se guardan en UTC y se calculan con la base horaria IANA.
- Formatos de fecha, número y moneda derivados del locale del usuario.
- Teléfonos normalizados a E.164 con validación por país.
- Catálogo de festividades por país, religión y cultura, versionado y actualizable sin desplegar la app.
- Soporte de alfabetos latino, cirílico, árabe (RTL), chino, japonés y coreano en la capa de tipografía.
- Adaptación cultural del contenido: el mismo evento cambia de fecha o tono según el país (por ejemplo el Día de la Madre).
12.Celebra Global Business
- Organizaciones con varios usuarios, roles (propietario, administrador, editor, aprobador, lector) y auditoría.
- Importación de contactos con mapeo de campos y prueba de consentimiento obligatoria.
- Segmentos dinámicos por país, idioma, antigüedad, tipo de cliente o etiqueta.
- Felicitaciones de cumpleaños de clientes, aniversarios laborales y campañas por festividad.
- Plantillas corporativas con marca, aprobación interna y control de versiones.
- Estadísticas de entrega, apertura, respuesta, bajas y cobertura por país.
- Integración posterior con CRM (HubSpot, Salesforce, Pipedrive) y RR. HH. vía API y webhooks.
13.UX/UI
| Pantalla | Componentes | Acciones principales |
|---|---|---|
| Landing | Hero, cómo funciona, beneficios, precios, prueba social | Registrarse, ver precios |
| Registro / Login | Email + social, verificación | Crear cuenta, recuperar acceso |
| Onboarding | 3 pasos: país e idioma, primer contacto, primera celebración | Completar, saltar |
| Dashboard | Métricas, agenda de próximos envíos, estados | Programar, aprobar, editar, eliminar |
| Calendario | Vista mensual con eventos propios y festividades locales | Crear desde una fecha, filtrar por país |
| Contactos | Lista con buscador, ficha lateral, badge de consentimiento | Añadir, importar, editar, borrar |
| Crear celebración | Asistente de 3 pasos con vista previa | Generar con IA, adjuntar media, programar |
| Crear mensaje | Editor con variables, selector de tono, contador por canal | Generar, guardar como plantilla |
| Plantillas | Galería por tipo y tono, estado de aprobación | Duplicar, editar, enviar a aprobación |
| Automatizaciones | Reglas activas con interruptores | Activar, pausar, cambiar hora |
| Historial | Tabla de envíos con estado y motivo de error | Reintentar, exportar |
| Integraciones | Tarjetas de canal con estado de conexión | Conectar, verificar, desconectar |
| Configuración | Perfil, idioma, zona horaria, privacidad, datos | Exportar, eliminar cuenta |
| Facturación | Plan, consumo por mensaje, facturas | Cambiar plan, actualizar pago |
| Panel empresarial | Segmentos, campañas, usuarios, analítica | Crear campaña, invitar usuario, aprobar |
Navegación: web con barra superior y secciones Panel · Calendario · Contactos · Programar · Plantillas · Ajustes. En móvil, barra inferior de 4 destinos más un botón central de creación rápida.
14.Arquitectura técnica
Apps
Web (React + TanStack Start, SSR) Móvil (React Native / Expo)
| |
+----------------- API HTTPS ------------+
|
Backend de aplicación
(auth · contactos · celebraciones · plantillas · IA)
|
+---------------+-----+------+----------------+
| | | |
PostgreSQL Redis/cola Almacenamiento Servicio IA
(datos + (trabajos) de multimedia (mensajes y
catálogo localización)
festividades)
|
Planificador (cada minuto: eventos con next_run_at <= ahora)
|
Trabajadores de envío -> Adaptadores de canal
| WhatsApp | Telegram
Webhooks de estado -> actualización de envíos -> analítica y avisos15.Stack tecnológico recomendado
| Área | Tecnología | Motivo |
|---|---|---|
| Web | React + TanStack Start (SSR) | Rendimiento, SEO de la landing y un solo lenguaje en todo el stack |
| Móvil | React Native con Expo | Reutiliza lógica y tipos de la web; push nativo sencillo |
| Backend | TypeScript sobre funciones de servidor + trabajos en cola | Tipado compartido y escalado por demanda |
| Base de datos | PostgreSQL | Relacional, transaccional, buen soporte de fechas y zonas horarias |
| Autenticación | Auth gestionado con OAuth y MFA | Menos superficie de riesgo que una solución propia |
| Planificador | Tarea por minuto + tabla de próximas ejecuciones en UTC | Preciso, idempotente y auditable |
| Colas | Redis con reintentos y dead-letter | Aísla fallos de terceros del resto del sistema |
| Zonas horarias | Base IANA + luxon/date-fns-tz | Cálculo correcto de DST |
| IA | Pasarela de modelos con caché de resultados | Cambiar de modelo sin reescribir producto |
| Multimedia | Almacenamiento de objetos + CDN | Coste bajo y entrega rápida global |
| Pagos | Stripe (suscripción + consumo) | Cobros internacionales e impuestos |
| Analítica | Eventos de producto + panel propio | Medir activación y retención |
| Monitorización | Logs estructurados, trazas y alertas | Detectar fallos de canal antes que el usuario |
| Seguridad | Cifrado en tránsito y en reposo, secretos gestionados | Requisito legal y de confianza |
16.Modelo de datos
| Entidad | Campos clave | Relaciones |
|---|---|---|
| Usuario | id, email, idioma, país, zona horaria, rol | Pertenece a Organización; tiene Contactos |
| Organización | id, nombre, plan, país fiscal | Tiene Usuarios, Contactos, Plantillas, Suscripción |
| Contacto | id, nombre, relación, país, idioma, tz, teléfono, usuario de Telegram | Tiene Eventos y Consentimientos |
| Evento | id, contacto_id, tipo, fecha, recurrencia | Genera Celebraciones |
| Celebración | id, evento_id, hora local, next_run_at (UTC), reglas | Usa Mensaje, Canal, Automatización |
| Mensaje | id, texto, idioma, tono, plantilla_id | Referencia Multimedia |
| Plantilla | id, nombre, cuerpo, variables, estado de aprobación | Usada por Mensajes |
| Automatización | id, celebración_id, auto_envío, aprobación, recordatorio | Pertenece a Celebración |
| Canal | id, tipo, límites, estado | Usado por Envíos |
| Integración | id, org_id, canal, credenciales cifradas, estado | Habilita Canal |
| Multimedia | id, tipo, url, propiedad, licencia | Adjunto a Mensaje |
| Envío | id, celebración_id, canal, estado, proveedor_id, error | Historial y analítica |
| Suscripción | id, plan, límites, consumo, estado de pago | Pertenece a Organización o Usuario |
| Consentimiento | id, contacto_id, canal, origen, fecha, revocado_en | Bloquea Envíos si falta |
17.Seguridad, privacidad y consentimiento
- Privacidad desde el diseño: solo se piden los datos necesarios para enviar.
- Consentimiento por contacto y por canal, con origen y fecha registrados.
- Baja inmediata: palabra clave de respuesta y bloqueo permanente del contacto.
- Límites de envío por plan y detección de patrones de spam.
- Cifrado en tránsito (TLS) y en reposo; credenciales de integración en gestor de secretos.
- Exportación y eliminación de datos a petición, con plazo definido.
- Registro de actividad y auditoría de quién programó, aprobó o envió cada mensaje.
- Cumplimiento GDPR como base y adaptación a normativas locales según país de operación; revisión legal antes de lanzar cada mercado.
18.Modelo de negocio
| Plan | Contactos | Canales | IA | Usuarios | Precio orientativo |
|---|---|---|---|---|---|
| Gratis | 10 | Telegram | 10 mensajes/mes | 1 | 0 € |
| Premium | 150 | Ilimitada razonable | 1 | 4,99 €/mes | |
| Familiar | 300 | Todos los personales | Ilimitada razonable | 5 | 8,99 €/mes |
| Profesional | 1.000 | + plantillas propias | Con tono de marca | 2 | 19 €/mes |
| Business | 10.000 | + campañas y aprobaciones | Con tono de marca | 10 | 79 €/mes |
| Enterprise | Ilimitados | Todos + CRM y API | Personalizada | Ilimitados | A medida |
El consumo de WhatsApp se factura aparte según el coste real del proveedor y el país; hay que confirmar tarifas oficiales antes de publicar precios definitivos.
19.MVP
- Registro, login y onboarding con país, idioma y zona horaria.
- Contactos manuales con consentimiento obligatorio.
- Cumpleaños y aniversarios, únicos o anuales, con hora local.
- Canales: WhatsApp con plantilla aprobada y Telegram mediante bot oficial.
- Generación de mensajes con IA y 10 plantillas iniciales en español e inglés.
- Adjuntar un enlace (YouTube o imagen).
- Reglas: enviar automáticamente o pedir aprobación, y recordatorio previo.
- Panel con agenda de próximos envíos e historial con estado.
- Planes Gratis y Premium con pago por suscripción.
- Fuera del MVP: segmentos, campañas, roles, CRM, vídeo propio y analítica avanzada.
20.Roadmap
| Fase | Alcance | Objetivo |
|---|---|---|
| MVP (0-3 meses) | Lo anterior, español e inglés, España y México | Comprobar si la gente programa y paga |
| V1 (3-6 meses) | App móvil, calendario de festividades, plantillas ampliadas, plan Familiar | Retención y hábito anual |
| V2 (6-12 meses) | Business: segmentos, campañas, roles, aprobaciones, analítica, importación CSV | Primer ingreso B2B recurrente |
| Expansión internacional (12-18 meses) | 8 idiomas, festividades de 40 países, precios locales, RTL | Crecimiento por mercado |
| Avanzado (18+ meses) | CRM y RR. HH., API pública, vídeo propio, tarjetas de marca, SSO y auditoría | Enterprise |
21.Riesgos y limitaciones
- Dependencia de terceros: políticas, tarifas y límites de WhatsApp, Meta y operadores cambian sin aviso.
- Email, SMS e Instagram quedan descartados: coste, spam o imposibilidad de iniciar la conversación. Messenger se limita a conversaciones ya abiertas.
- Coste variable por mensaje: si sube, el margen del plan Premium se estrecha.
- Riesgo de percepción de spam si el consentimiento no es explícito y demostrable.
- Estacionalidad: picos enormes en Navidad y Año Nuevo exigen colas dimensionadas.
- Un mensaje que llega tarde o duplicado daña la confianza más que no enviarlo; la idempotencia es crítica.
- Complejidad cultural: un texto mal adaptado puede ofender; requiere revisión humana por mercado.
- Mitigación general: diseñar con varios proveedores por canal y capacidad de conmutar.
22.Métricas de éxito
- Activación: % de cuentas con al menos 1 celebración programada en 24 h (objetivo 60%).
- Profundidad inicial: contactos añadidos en la primera semana (objetivo 5).
- Mensajes programados por usuario activo y mensajes ejecutados con éxito (objetivo 98% de entrega).
- Retención anual: % de automatizaciones que se ejecutan un segundo año (objetivo 70%).
- Conversión a pago (objetivo 5% del gratuito) y churn mensual (objetivo <4%).
- Bajas y quejas por spam (objetivo <0,1% de los envíos).
- Clientes empresariales activos e ingreso recurrente por cuenta.
23.Próximos pasos
- 1. Validar con la documentación oficial los requisitos, plantillas y tarifas actuales de WhatsApp Business Platform.
- 2. Cerrar el alcance del MVP por escrito y congelarlo.
- 3. Definir el modelo de datos y las migraciones de las 8 entidades del MVP.
- 4. Construir el planificador y la cola con pruebas de zonas horarias y DST.
- 5. Implementar el adaptador de Telegram de punta a punta y medir entrega.
- 6. Añadir WhatsApp con plantillas aprobadas y flujo de consentimiento.
- 7. Diseñar el asistente de creación en 3 pasos y probarlo con 10 personas no técnicas.
- 8. Integrar generación de mensajes con IA y catálogo inicial de plantillas.
- 9. Añadir suscripciones y límites por plan.
- 10. Revisión legal (GDPR, consentimiento, retención) antes del lanzamiento en España y México.
Conclusión
Celebrar es un comportamiento humano universal y repetido: cada persona tiene decenas de fechas que se repiten cada año en todos los países del mundo. Celebra Global convierte ese hábito frágil en un sistema fiable con un único gesto de configuración, y cada celebración creada genera valor durante años sin coste de adquisición adicional. El mismo motor —contactos, calendario cultural, planificador y canales oficiales— sirve a una familia y a una empresa con miles de clientes, así que el crecimiento B2B reutiliza la inversión del producto de consumo. Con una arquitectura donde añadir un país o un idioma es cargar un catálogo, no reescribir la aplicación, y con el consentimiento como base del diseño, Celebra Global puede escalar internacionalmente con un margen sano y una promesa muy fácil de entender: configúralo una vez, celebra siempre.