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

SegmentoNecesidadDecisión de producto
ParticularesRecordar 10-30 fechas y enviar algo cálidoOnboarding en 3 minutos, plan gratuito
FamiliasCalendario compartido de la familiaEspacio compartido, 5 usuarios
ProfesionalesFidelizar 200-1.000 clientesPlantillas propias y tono de marca
EmpresasMiles de contactos, permisos y marcaBusiness: 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ónDescripciónParticularEmpresaMVP
ContactosAlta manual, relación, país, idioma, consentimientoSí + importación CSV
CelebracionesEvento único o recurrente con hora local
Calendario inteligentePersonales + festividades por país y culturaParcial
Mensajes con IAGeneración por relación, tono, cultura, idiomaSí + tono de marca
PlantillasReutilizables con variablesCorporativas y aprobadas
MultimediaEnlaces, imágenes, GIF, tarjetas, vídeo propioSolo enlaces e imagen
AutomatizacionesRecurrencia, aprobación, rotación de plantillaSí + reglas por segmento
Historial de envíosEstado, motivo de error, reintentosSí + exportación
CanalesWhatsApp y TelegramWhatsApp + Telegram
Segmentos y campañasGrupos y envíos por festividadNoNo
Roles y aprobacionesVarios usuarios por organizaciónNoNo
AnalíticaEntrega, apertura, respuesta, bajasBásicaAvanzadaBásica
FacturaciónSuscripción y consumo por mensaje

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

CanalUso previstoIntegraciónLimitacionesPrioridad
WhatsAppFelicitaciones 1:1 personales y corporativasWhatsApp 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 vigentesAlta (MVP)
TelegramFelicitaciones automáticas con texto, enlaces, imágenes y vídeoBot API oficial de Telegram (bot creado con @BotFather)El destinatario debe haber iniciado el bot o compartir un grupo con él; sin coste por mensajeAlta (MVP)
MessengerFelicitaciones a personas que ya escribieron a la página de FacebookMessenger 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 nuevasMedia (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

PantallaComponentesAcciones principales
LandingHero, cómo funciona, beneficios, precios, prueba socialRegistrarse, ver precios
Registro / LoginEmail + social, verificaciónCrear cuenta, recuperar acceso
Onboarding3 pasos: país e idioma, primer contacto, primera celebraciónCompletar, saltar
DashboardMétricas, agenda de próximos envíos, estadosProgramar, aprobar, editar, eliminar
CalendarioVista mensual con eventos propios y festividades localesCrear desde una fecha, filtrar por país
ContactosLista con buscador, ficha lateral, badge de consentimientoAñadir, importar, editar, borrar
Crear celebraciónAsistente de 3 pasos con vista previaGenerar con IA, adjuntar media, programar
Crear mensajeEditor con variables, selector de tono, contador por canalGenerar, guardar como plantilla
PlantillasGalería por tipo y tono, estado de aprobaciónDuplicar, editar, enviar a aprobación
AutomatizacionesReglas activas con interruptoresActivar, pausar, cambiar hora
HistorialTabla de envíos con estado y motivo de errorReintentar, exportar
IntegracionesTarjetas de canal con estado de conexiónConectar, verificar, desconectar
ConfiguraciónPerfil, idioma, zona horaria, privacidad, datosExportar, eliminar cuenta
FacturaciónPlan, consumo por mensaje, facturasCambiar plan, actualizar pago
Panel empresarialSegmentos, campañas, usuarios, analíticaCrear 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 avisos

15.Stack tecnológico recomendado

ÁreaTecnologíaMotivo
WebReact + TanStack Start (SSR)Rendimiento, SEO de la landing y un solo lenguaje en todo el stack
MóvilReact Native con ExpoReutiliza lógica y tipos de la web; push nativo sencillo
BackendTypeScript sobre funciones de servidor + trabajos en colaTipado compartido y escalado por demanda
Base de datosPostgreSQLRelacional, transaccional, buen soporte de fechas y zonas horarias
AutenticaciónAuth gestionado con OAuth y MFAMenos superficie de riesgo que una solución propia
PlanificadorTarea por minuto + tabla de próximas ejecuciones en UTCPreciso, idempotente y auditable
ColasRedis con reintentos y dead-letterAísla fallos de terceros del resto del sistema
Zonas horariasBase IANA + luxon/date-fns-tzCálculo correcto de DST
IAPasarela de modelos con caché de resultadosCambiar de modelo sin reescribir producto
MultimediaAlmacenamiento de objetos + CDNCoste bajo y entrega rápida global
PagosStripe (suscripción + consumo)Cobros internacionales e impuestos
AnalíticaEventos de producto + panel propioMedir activación y retención
MonitorizaciónLogs estructurados, trazas y alertasDetectar fallos de canal antes que el usuario
SeguridadCifrado en tránsito y en reposo, secretos gestionadosRequisito legal y de confianza

16.Modelo de datos

EntidadCampos claveRelaciones
Usuarioid, email, idioma, país, zona horaria, rolPertenece a Organización; tiene Contactos
Organizaciónid, nombre, plan, país fiscalTiene Usuarios, Contactos, Plantillas, Suscripción
Contactoid, nombre, relación, país, idioma, tz, teléfono, usuario de TelegramTiene Eventos y Consentimientos
Eventoid, contacto_id, tipo, fecha, recurrenciaGenera Celebraciones
Celebraciónid, evento_id, hora local, next_run_at (UTC), reglasUsa Mensaje, Canal, Automatización
Mensajeid, texto, idioma, tono, plantilla_idReferencia Multimedia
Plantillaid, nombre, cuerpo, variables, estado de aprobaciónUsada por Mensajes
Automatizaciónid, celebración_id, auto_envío, aprobación, recordatorioPertenece a Celebración
Canalid, tipo, límites, estadoUsado por Envíos
Integraciónid, org_id, canal, credenciales cifradas, estadoHabilita Canal
Multimediaid, tipo, url, propiedad, licenciaAdjunto a Mensaje
Envíoid, celebración_id, canal, estado, proveedor_id, errorHistorial y analítica
Suscripciónid, plan, límites, consumo, estado de pagoPertenece a Organización o Usuario
Consentimientoid, contacto_id, canal, origen, fecha, revocado_enBloquea 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

PlanContactosCanalesIAUsuariosPrecio orientativo
Gratis10Telegram10 mensajes/mes10 €
Premium150+ WhatsAppIlimitada razonable14,99 €/mes
Familiar300Todos los personalesIlimitada razonable58,99 €/mes
Profesional1.000+ plantillas propiasCon tono de marca219 €/mes
Business10.000+ campañas y aprobacionesCon tono de marca1079 €/mes
EnterpriseIlimitadosTodos + CRM y APIPersonalizadaIlimitadosA 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

FaseAlcanceObjetivo
MVP (0-3 meses)Lo anterior, español e inglés, España y MéxicoComprobar si la gente programa y paga
V1 (3-6 meses)App móvil, calendario de festividades, plantillas ampliadas, plan FamiliarRetención y hábito anual
V2 (6-12 meses)Business: segmentos, campañas, roles, aprobaciones, analítica, importación CSVPrimer ingreso B2B recurrente
Expansión internacional (12-18 meses)8 idiomas, festividades de 40 países, precios locales, RTLCrecimiento por mercado
Avanzado (18+ meses)CRM y RR. HH., API pública, vídeo propio, tarjetas de marca, SSO y auditoríaEnterprise

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.