AchieveApex: app events

Generado desde achieveApex-Frontend/public/ai-docs el 2026-10-15. Contiene 47 archivos de la app events. Para el contexto general del producto ver apex-resumen.md.

Events

Eventos, invitados, check-in e insights.

• Etapa: Produccion
• Landing: /{orgId}/events

Modulos

Funcionalidades internas

40 funcionalidades documentadas en 6 modulos. Ver la tabla de cada modulo.

id: check-in app: events nombre: Check-in estado: shipped permiso: can_access_events

Check-in

Convierte el ticket del asistente en una asistencia registrada durante el evento.

Para que sirve

• Un organizador de conferencias valida entradas QR y conoce la asistencia real mientras se realiza el evento.
• Una universidad registra la llegada de participantes a una feria o seminario sin listas en papel.
• Un gimnasio controla la entrada a una clase especial con una lista de asistentes aprobados.

Que lo hace diferente

• El check-in actualiza el mismo registro ligado al contacto del CRM.
• La entrada confirmada puede disparar automatizaciones para seguimiento o entrega de materiales.
• Los conteos se reflejan en la analítica del evento sin exportar ni reconciliar listas.

Acceso

• Ruta principal: /[orgId]/events/check-in
• Como se llega: Events > Check-in
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventCheckInView.tsx.
• Backend: event-registrations y la automatización de check-in.
• Integraciones externas: cámara del navegador mediante BarcodeDetector.

Funcionalidades internas

Relaciones

• Depende de: Guests y Tickets.
• Dispara / afecta: Insights y automatizaciones de asistencia.

Limitaciones y notas

• Solo los invitados approved pueden hacer check-in; un ticket ya registrado se informa sin duplicarlo.

id: live-attendance modulo: check-in app: events nombre: Seguir asistencia en vivo tipo: vista

Seguir asistencia en vivo

Presenta la ocupación y los últimos check-ins del evento seleccionado.

Que se logra

• Resultado: Muestra el avance de asistencia y los ingresos recientes durante la operación.
• Caso de uso: Un equipo de eventos controla en vivo cuántos asistentes ya llegaron al auditorio.
• Se combina con: Check-in e Insights.

Donde esta

• Ruta: /[orgId]/events/check-in
• Acceso en UI: Events > Check-in
• Componente(s): EventCheckInView.tsx

Como funciona

1. Se selecciona un evento publicado.
2. Se revisan aprobados, asistentes registrados y porcentaje.
3. Se consulta la lista de entradas recientes.

Reglas y validaciones

• El porcentaje se calcula sobre asistentes aprobados.

Backend

• Servicios: events (get), event-registrations (find).

Relaciones

• Requiere: Check-in y Guests.

Notas

• Muestra hasta 20 registros recientes.

id: manual-check-in modulo: check-in app: events nombre: Registrar check-in manualmente tipo: accion

Registrar check-in manualmente

Marca asistencia mediante código escrito o búsqueda de invitado.

Que se logra

• Resultado: Permite confirmar entradas aunque no haya lectura de QR disponible.
• Caso de uso: Una iglesia busca por nombre a un asistente y registra su llegada.
• Se combina con: Guests e Insights.

Donde esta

• Ruta: /[orgId]/events/check-in
• Acceso en UI: Events > Check-in
• Componente(s): EventCheckInView.tsx

Como funciona

1. Se escribe o pega el código de ticket, o se busca por nombre/email.
2. Se pulsa la acción Check in.

Reglas y validaciones

• La búsqueda requiere al menos dos caracteres.
• Solo se puede registrar a una persona aprobada.

Backend

• Servicios: event-registrations (find, patch).

Relaciones

• Requiere: Guests.

Notas

• Puede revertirse con Undo check-in.

id: scan-qr modulo: check-in app: events nombre: Escanear ticket QR tipo: accion

Escanear ticket QR

Lee un ticket con la cámara y registra la asistencia.

Que se logra

• Resultado: Agiliza la validación presencial leyendo el ticket del asistente.
• Caso de uso: Un organizador de conferencias acredita participantes desde la cámara del navegador.
• Se combina con: Guests y automatizaciones de check-in.

Donde esta

• Ruta: /[orgId]/events/check-in
• Acceso en UI: Events > Check-in > Start camera
• Componente(s): EventCheckInView.tsx

Como funciona

1. Se escoge un evento publicado.
2. Se inicia la cámara y se muestra el QR.
3. El resultado confirma, rechaza o advierte que ya ingresó.

Reglas y validaciones

• Solo admite QR y requiere permiso de cámara y BarcodeDetector.

Backend

• Servicios: event-registrations (find, patch).
• Efectos: actualiza contadores y dispara automatización de check-in.

Relaciones

• Afecta: Guests e Insights.

Notas

• Ignora el mismo código repetido durante cuatro segundos.

id: eventos-publicos app: events nombre: Eventos públicos estado: public permiso: ninguno

Eventos públicos

Expone la agenda y el registro de eventos sin iniciar sesión, incluida la gestión del ticket del asistente.

Para que sirve

• Un organizador de conferencias publica una agenda y permite registro con ticket desde su enlace.
• Una iglesia comparte actividades abiertas, recibe inscripciones y entrega un ticket QR por email.
• Una universidad publica jornadas y eventos de admisión con información, ubicación y cupos.

Que lo hace diferente

• Un registro público crea o relaciona un contacto dentro del CRM de Apex.
• La página usa los tickets, cupones, pagos y reglas de capacidad definidos por la organización.
• Las visitas y registros alimentan Insights; el asistente recibe comunicaciones y ticket desde el mismo producto.
• Los registros públicos pueden disparar automatizaciones de Apex.

Acceso

• Ruta principal: /events/[orgId]
• Como se llega: enlace público de la organización o del evento.
• Permiso requerido: ninguno.

Alcance tecnico

• Frontend: rutas /events/[orgId], /events/[orgId]/[slug], ticket y feedback; componentes public/PublicOrganizationEventsView.tsx.
• Backend: public-event-registration, public-event-ticket, event-page-views.
• Integraciones externas: gateways de pago, email con ticket/ICS y Google Maps embebido.

Funcionalidades internas

Relaciones

• Depende de: Gestión de eventos, Tickets, Coupons, Guests y Payment gateways.
• Dispara / afecta: emails, métricas de Insights y automatizaciones de registros.

Limitaciones y notas

• El enlace de ticket se basa en un código de check-in; debe tratarse como un enlace privado.

id: attendee-ticket modulo: eventos-publicos app: events nombre: Gestionar ticket de asistente tipo: publico

Gestionar ticket de asistente

Permite consultar el QR, estado y acciones de una inscripción.

Que se logra

• Resultado: Permite consultar el estado de la inscripción y continuar acciones habilitadas sobre ella.
• Caso de uso: Un asistente revisa su ticket antes de una conferencia y completa un pago pendiente.
• Se combina con: Guests, pagos y Check-in.

Donde esta

• Ruta: /events/[orgId]/[slug]/ticket/[code]
• Acceso en UI: enlace recibido en la confirmación.
• Componente(s): página de ticket público.

Como funciona

1. Se abre el enlace del ticket.
2. Se muestra QR, estado de registro y check-in.
3. Si corresponde, se usa Pay now o Cancel registration.

Reglas y validaciones

• El ticket se localiza por su código de check-in.

Backend

• Servicios: public-event-ticket (get, patch).

Relaciones

• Requiere: registro público.

Notas

• El código QR es el usado en Check-in.

id: public-event-calendar modulo: eventos-publicos app: events nombre: Consultar agenda pública tipo: publico

Consultar agenda pública

Muestra la agenda pública de una organización.

Que se logra

• Resultado: Ofrece una agenda pública para descubrir y abrir eventos publicados.
• Caso de uso: Una iglesia publica sus próximos encuentros para que la comunidad encuentre el adecuado.
• Se combina con: Gestión de eventos y páginas públicas.

Donde esta

• Ruta: /events/[orgId]
• Acceso en UI: enlace público compartido.
• Componente(s): PublicOrganizationEventsView.tsx

Como funciona

1. Se abre la página con el identificador o slug público de la organización.
2. Se selecciona un evento publicado para ver su detalle.

Backend

• Servicios: public-event-registration (find).

Relaciones

• Requiere: Configuración de organización.

Notas

• La organización puede desactivar su página pública.

id: public-event-page modulo: eventos-publicos app: events nombre: Consultar página pública de evento tipo: publico

Consultar página pública de evento

Presenta los detalles y el registro de un evento publicado.

Que se logra

• Resultado: Presenta información suficiente para que un visitante decida registrarse.
• Caso de uso: Una conferencia muestra anfitriones, agenda, lugar y cupos en una sola página.
• Se combina con: Tickets, registro público y mapa.

Donde esta

• Ruta: /events/[orgId]/[slug]
• Acceso en UI: enlace del evento.
• Componente(s): página pública de evento.

Como funciona

1. Se revisa fecha, ubicación o enlace, anfitriones y descripción.
2. Se inicia el registro desde la tarjeta Registration.

Reglas y validaciones

• La dirección puede reservarse para asistentes.

Backend

• Servicios: public-event-registration (get, create).
• Efectos: registra vistas anónimas para Insights.

Relaciones

• Requiere: evento publicado.

Notas

• La copia y diseño pueden ser personalizados por evento.

id: public-feedback modulo: eventos-publicos app: events nombre: Enviar feedback público tipo: publico

Enviar feedback público

Recoge valoración y comentario de un asistente tras el evento.

Que se logra

• Resultado: Recoge una valoración después del evento desde una superficie sin login.
• Caso de uso: Un organizador solicita feedback a asistentes de una sesión al terminar.
• Se combina con: Guests e Insights.

Donde esta

• Ruta: /events/[orgId]/[slug]/feedback?code=
• Acceso en UI: enlace de feedback.
• Componente(s): página de feedback público.

Como funciona

1. Se abre el enlace asociado al ticket.
2. Se selecciona una valoración y se añade un comentario opcional.
3. Se envía el formulario.

Reglas y validaciones

• El feedback se asocia al registro del código entregado.

Backend

• Servicios: public-event-registration (create), event-feedback.

Relaciones

• Afecta: Insights.

Notas

• La valoración disponible va de una a cinco estrellas.

id: public-payment-ticket modulo: eventos-publicos app: events nombre: Pagar y recibir ticket tipo: publico

Pagar y recibir ticket

Deriva el registro de pago a un enlace y entrega el ticket QR.

Que se logra

• Resultado: Lleva al asistente desde una entrada de pago hasta su ticket de acceso.
• Caso de uso: Una academia cobra un taller y entrega la confirmación al participante.
• Se combina con: Payment gateways, Guests y ticket público.

Donde esta

• Ruta: /events/[orgId]/[slug]
• Acceso en UI: Pay now
• Componente(s): página pública de evento y ticket.

Como funciona

1. Se crea el registro con ticket pagado.
2. Se continúa mediante el enlace de pago.
3. Tras el cobro, el ticket queda disponible.

Reglas y validaciones

• La organización necesita un gateway configurado para cobrar.

Backend

• Servicios: public-event-registration (create), public-event-ticket (get).
• Efectos: la confirmación de pago actualiza el estado y habilita el ticket.

Relaciones

• Requiere: Payment gateways y Tickets.

Notas

• El flujo público permite pagar y consultar el ticket; no expone una acción de reembolso.

id: public-registration modulo: eventos-publicos app: events nombre: Registrarse a un evento tipo: publico

Registrarse a un evento

Permite a una persona crear su registro desde la página pública.

Que se logra

• Resultado: Convierte una visita en una inscripción vinculada al evento.
• Caso de uso: Una universidad recibe el registro de un aspirante a una jornada de puertas abiertas.
• Se combina con: Contacts, Guests y Automatizaciones.

Donde esta

• Ruta: /events/[orgId]/[slug]
• Acceso en UI: Registration
• Componente(s): página pública de evento.

Como funciona

1. Se identifican o completan los datos solicitados.
2. Se elige un ticket disponible.
3. Se envía el formulario y se recibe confirmación, espera o pago.

Reglas y validaciones

• El estado depende de aprobación, disponibilidad y pago.

Backend

• Servicios: public-event-registration (create).
• Efectos: crea o vincula contacto, notifica y puede activar automatizaciones.

Relaciones

• Requiere: formulario, tickets y configuración de registro.

Notas

• Las invitaciones pueden prellenar la información.

id: ticket-selection modulo: eventos-publicos app: events nombre: Seleccionar ticket y cupón tipo: publico

Seleccionar ticket y cupón

Calcula disponibilidad, precio y descuento antes de registrar.

Que se logra

• Resultado: Permite elegir una modalidad disponible y calcular su precio o descuento.
• Caso de uso: Un organizador ofrece entradas general y VIP, con cupón para aliados.
• Se combina con: Tickets, Cupones y pagos.

Donde esta

• Ruta: /events/[orgId]/[slug]
• Acceso en UI: Registration > Tickets
• Componente(s): página pública de evento.

Como funciona

1. Se elige un ticket disponible.
2. Se ingresa un cupón opcional y se pulsa Apply.
3. Se confirma el total y se continúa.

Reglas y validaciones

• Respeta ventana de venta, visibilidad, capacidad y aprobación del ticket.

Backend

• Servicios: public-event-registration (create).
• Efectos: valida cupón y calcula pago.

Relaciones

• Requiere: Tickets y Coupons.

Notas

• Un ticket sin capacidad propia hereda el límite del evento cuando existe.

id: gestion app: events nombre: Gestión de eventos estado: shipped permiso: can_access_events

Gestión de eventos

Permite crear, configurar y operar eventos de una organización, desde el borrador hasta su publicación y comunicaciones.

Para que sirve

• Un organizador de conferencias crea, publica y comunica eventos con entradas, anfitriones y página propia.
• Una universidad habilita registros con aprobación y capacidad para charlas, ferias y actividades de admisión.
• Una iglesia coordina encuentros presenciales o virtuales, envía invitaciones y mantiene informados a sus asistentes.
• Un equipo de formación vende cupos, aplica cupones y centraliza la operación del evento.

Que lo hace diferente

• Los asistentes se vinculan con contactos del CRM en vez de quedar aislados en una lista de tickets.
• El registro, sus cambios de estado y el check-in pueden disparar automatizaciones de Apex.
• Puede cobrar tickets mediante los gateways de pago configurados por la organización.
• Las comunicaciones del evento se envían por email o WhatsApp desde la misma organización.
• Puede sincronizarse con Google Calendar y generar enlaces de Google Meet cuando existe una integración activa.

Acceso

• Ruta principal: /[orgId]/events
• Como se llega: Header app switcher > Events
• Permiso requerido: can_access_events; las acciones quedan sujetas a permisos granulares de Events.

Alcance tecnico

• Frontend: rutas de lista, creación y /[orgId]/events/[eventId]; EventManageView.tsx, EventCoreFields.tsx, EventTicketTypesSection.tsx, EventCouponsSection.tsx, EventHostsCard.tsx, EventBlastsSection.tsx y EventDetailView.tsx.
• Backend: events, event-ticket-types, event-coupons, event-hosts, event-blasts y organization-events-settings.
• Superficies publicas: el evento publicado se expone bajo /events/[orgId]/[slug].
• Integraciones externas: Google Calendar/Meet, S3, gateways de pago, email y WhatsApp.

Funcionalidades internas

Relaciones

• Depende de: Currencies, Payment gateways, Document settings, Contacts y Calendar sync.
• Usado por: Guests, Check-in, People, Insights, Automatizaciones y Eventos públicos.

Limitaciones y notas

• La capacidad efectiva considera el límite del evento y el de cada ticket.
• Un anfitrión creador no se puede eliminar.
• La sincronización con Google Calendar puede informar un error sin impedir que se guarde el evento.

id: coupons modulo: gestion app: events nombre: Gestionar cupones tipo: configuracion

Gestionar cupones

Aplica descuentos a tickets pagados.

Que se logra

• Resultado: Aplica descuentos controlados a tickets elegibles.
• Caso de uso: Una academia entrega un código de descuento a estudiantes para un taller pagado.
• Se combina con: Tickets, pagos y registro público.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=registration
• Acceso en UI: Manage event > Registration > Add coupon
• Componente(s): EventCouponsSection.tsx

Como funciona

1. Se añade código, descuento, ticket objetivo y vigencia.
2. Se activa, desactiva o elimina el cupón.

Reglas y validaciones

• Requiere al menos un ticket pagado.
• El porcentaje debe estar entre 1 y 100.

Backend

• Servicios: event-coupons (find, create, patch, remove).

Relaciones

• Requiere: Tickets.
• Afecta: registro y pagos públicos.

Notas

• El límite de usos es opcional.

id: create-event modulo: gestion app: events nombre: Crear evento tipo: accion

Crear evento

Inicia un evento como borrador.

Que se logra

• Resultado: Crea una base operativa para publicar un evento, abrir registros y medir su resultado.
• Caso de uso: Un organizador de conferencias inicia la ficha de una charla y luego define entradas, anfitriones y comunicación.
• Se combina con: Tickets, Eventos públicos y Automatizaciones.

Donde esta

• Ruta: /[orgId]/events/new
• Acceso en UI: Events > Create event
• Componente(s): CreateEventView.tsx, EventCoreFields.tsx

Como funciona

1. Se completa Event name, fecha, zona horaria y modalidad.
2. Se guarda el borrador para continuar su configuración.

Campos y opciones

Reglas y validaciones

• El enlace de reunión debe usar HTTP o HTTPS.

Backend

• Servicios: events (create).
• Efectos: crea un anfitrión creador y un ticket gratuito inicial.

Relaciones

• Requiere: Gestión de eventos.
• Dispara / afecta: Tickets y Hosts.

Notas

• Se aplican valores predeterminados de la organización.

id: edit-event modulo: gestion app: events nombre: Editar detalles del evento tipo: accion

Editar detalles del evento

Actualiza la información operativa de un evento.

Que se logra

• Resultado: Mantiene fecha, formato, ubicación y presentación del evento alineados con su operación real.
• Caso de uso: Una universidad actualiza el auditorio o la modalidad de una jornada sin crear un evento nuevo.
• Se combina con: Eventos públicos, Guests y Google Calendar.

Donde esta

• Ruta: /[orgId]/events/[eventId]
• Acceso en UI: Manage event > Overview
• Componente(s): EventManageView.tsx, EventCoreFields.tsx

Como funciona

1. Se modifica título, fechas, modalidad, ubicación, enlace o descripción.
2. Se pulsa Save.

Campos y opciones

Reglas y validaciones

• Webinar no muestra ubicación; eventos presenciales no muestran enlace de reunión.

Backend

• Servicios: events (get, patch).
• Efectos: cambios de detalles pueden notificar a asistentes.

Relaciones

• Afecta: página pública y comunicaciones.

Notas

• La portada se almacena en S3.

id: event-lifecycle modulo: gestion app: events nombre: Duplicar, cancelar o eliminar evento tipo: accion

Duplicar, cancelar o eliminar evento

Ofrece operaciones administrativas para el ciclo de vida del evento.

Que se logra

• Resultado: Permite administrar el estado operativo del evento, incluido cancelarlo o retirarlo.
• Caso de uso: Un organizador cancela una fecha y notifica a los invitados afectados.
• Se combina con: Guests y comunicaciones del evento.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=more
• Acceso en UI: Manage event > More
• Componente(s): EventManageView.tsx

Como funciona

1. Se cambia el slug público si es necesario.
2. Se pulsa Clone, Cancel event o Delete y se confirma.

Reglas y validaciones

• La cancelación no elimina el evento; la eliminación usa borrado lógico.

Backend

• Servicios: events (create, patch, remove).
• Efectos: la cancelación notifica a los asistentes.

Relaciones

• Afecta: Guests y Eventos públicos.

Notas

• El clon se crea con el nombre original seguido de (copy).

id: event-page modulo: gestion app: events nombre: Personalizar página pública del evento tipo: configuracion

Personalizar página pública del evento

Configura la dirección y contenido principal del evento público.

Que se logra

• Resultado: Publica una página con información y contenido propios para convertir visitas en registros.
• Caso de uso: Una iglesia comparte los detalles de su retiro en una página con fecha, lugar y registro.
• Se combina con: Página pública y diseño de página.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=page
• Acceso en UI: Manage event > Event page
• Componente(s): EventDetailView.tsx

Como funciona

1. Se define el slug, mensaje de agradecimiento y política.
2. Se suben o cambian logo y portada.
3. Se guarda y se revisa la vista previa si está publicado.

Reglas y validaciones

• El slug usa minúsculas, números y guiones.

Backend

• Servicios: events (patch), s3-url-signing (create).

Relaciones

• Afecta: página pública y ticket.

Notas

• La vista previa solo está disponible con evento publicado y slug.

id: event-payments modulo: gestion app: events nombre: Configurar pagos de eventos tipo: configuracion

Configurar pagos de eventos

Habilita cobros para tickets pagados.

Que se logra

• Resultado: Permite cobrar entradas de pago mediante un gateway configurado por la organización.
• Caso de uso: Un productor de eventos cobra cupos de una capacitación sin gestionar pagos fuera de Apex.
• Se combina con: Tickets, Payment gateways y ticket público.

Donde esta

• Ruta: /[orgId]/events/settings
• Acceso en UI: Events > Settings > Payments
• Componente(s): EventsSettingsView.tsx, EventCouponsSection.tsx

Como funciona

1. Se selecciona un gateway predeterminado.
2. Se añade la política de reembolso.
3. Se verifican avisos de preparación en tickets.

Reglas y validaciones

• Tickets pagados requieren un gateway activo y una configuración de documentos para pagos.

Backend

• Servicios: organization-events-settings (patch), organization-payment-gateways (find).

Relaciones

• Requiere: Payment gateways y Document settings.

Notas

• Sin gateway el registro puede crear la inscripción, pero el pago no queda listo.

id: google-meet modulo: gestion app: events nombre: Generar enlace de Google Meet tipo: integracion

Generar enlace de Google Meet

Genera un enlace de reunión para eventos virtuales o híbridos.

Que se logra

• Resultado: Entrega un enlace de reunión asociado al evento virtual cuando la organización tiene una integración activa.
• Caso de uso: Una escuela en línea programa una clase y da a los inscritos un acceso de Google Meet.
• Se combina con: Eventos públicos y comunicaciones a invitados.

Donde esta

• Ruta: /[orgId]/events/new y /[orgId]/events/[eventId]
• Acceso en UI: Generate Google Meet link
• Componente(s): EventCoreFields.tsx

Como funciona

1. Se selecciona Generate Google Meet link.
2. Se elige una integración activa de Google Calendar.
3. Se guarda el evento.

Reglas y validaciones

• Requiere una integración activa; si no existe, se dirige a Calendar sync.

Backend

• Servicios: events (create, patch).
• Efectos: sincroniza el evento con Google Calendar y solicita conferencia Meet.

Relaciones

• Requiere: Calendar sync.

Notas

• Un fallo de sincronización se muestra al usuario sin anular el guardado.

id: guest-blasts modulo: gestion app: events nombre: Enviar comunicaciones a asistentes tipo: accion

Enviar comunicaciones a asistentes

Envía o programa mensajes a segmentos de asistentes.

Que se logra

• Resultado: Comunica novedades, recordatorios o invitaciones a segmentos de asistentes.
• Caso de uso: Un organizador avisa por email o WhatsApp a inscritos sobre un cambio de sala.
• Se combina con: Guests y recordatorios del evento.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=blasts
• Acceso en UI: Manage event > Blasts > New blast
• Componente(s): EventBlastsSection.tsx

Como funciona

1. Se seleccionan canal y audiencia.
2. Se escribe email o se elige una plantilla WhatsApp aprobada.
3. Se envía ahora o se programa.

Reglas y validaciones

• Email requiere asunto y mensaje; WhatsApp requiere plantilla.
• Una programación debe ser futura.

Backend

• Servicios: event-blasts (find, create).
• Efectos: entrega por email o WhatsApp; el cron procesa envíos programados.

Relaciones

• Requiere: Guests y plantillas WhatsApp.

Notas

• Se ven estado y contadores de entrega.

id: manage-hosts modulo: gestion app: events nombre: Gestionar anfitriones tipo: configuracion

Gestionar anfitriones

Asigna miembros de la organización como anfitriones del evento.

Que se logra

• Resultado: Muestra responsables del evento y define qué anfitriones aparecen en la página pública.
• Caso de uso: Una conferencia presenta a sus ponentes visibles y mantiene responsables internos para coordinarla.
• Se combina con: Página pública del evento.

Donde esta

• Ruta: /[orgId]/events/[eventId]
• Acceso en UI: Manage event > Overview > Hosts
• Componente(s): EventHostsCard.tsx

Como funciona

1. Se pulsa Add y se elige un miembro disponible.
2. Se puede ocultar o retirar un anfitrión.

Reglas y validaciones

• El anfitrión creador no se puede eliminar.

Backend

• Servicios: event-hosts (find, create, patch, remove).

Relaciones

• Afecta: página pública del evento.

Notas

• Los anfitriones añadidos tienen acceso de gestor.

id: organization-settings modulo: gestion app: events nombre: Configurar Events de la organización tipo: configuracion

Configurar Events de la organización

Define la agenda pública y valores predeterminados de nuevos eventos.

Que se logra

• Resultado: Establece la identidad y reglas predeterminadas de la agenda pública de la organización.
• Caso de uso: Una universidad define el nombre, marca y preferencias que usarán sus futuros eventos.
• Se combina con: Eventos públicos y Gestión de eventos.

Donde esta

• Ruta: /[orgId]/events/settings
• Acceso en UI: Events > Settings
• Componente(s): EventsSettingsView.tsx

Como funciona

1. Se configura marca, slug, enlaces y página pública.
2. Se definen valores predeterminados y pagos.
3. Se pulsa Save.

Reglas y validaciones

• El slug debe tener tres caracteres o más, usar minúsculas, números o guiones y no puede ser solo numérico.

Backend

• Servicios: organization-events-settings (get, create, patch).

Relaciones

• Afecta: agenda pública y creación de eventos.

Notas

• Imágenes de avatar y portada aceptan hasta 5 MB.

id: page-design modulo: gestion app: events nombre: Diseñar página pública tipo: configuracion

Diseñar página pública

Controla el aspecto visual del evento público.

Que se logra

• Resultado: Adapta la apariencia de la página pública a la identidad del evento.
• Caso de uso: Una conferencia utiliza sus colores y portada para que la agenda sea reconocible por sus asistentes.
• Se combina con: Página pública del evento.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=page
• Acceso en UI: Manage event > Event page > Design
• Componente(s): EventDetailView.tsx

Como funciona

1. Se selecciona Light, Dark o Custom.
2. Se ajustan colores y subtítulo cuando corresponde.
3. Se guarda y actualiza la vista previa.

Backend

• Servicios: events (patch).

Relaciones

• Afecta: página pública del evento.

Notas

• El modo personalizado conserva campos de color editables.

id: page-language modulo: gestion app: events nombre: Personalizar idioma y etiquetas públicas tipo: configuracion

Personalizar idioma y etiquetas públicas

Selecciona el texto de la página pública o modifica sus etiquetas.

Que se logra

• Resultado: Presenta los textos del flujo público en el idioma adecuado para sus asistentes.
• Caso de uso: Una universidad internacional ofrece el registro de un seminario con textos adaptados a su audiencia.
• Se combina con: Página pública del evento.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=page
• Acceso en UI: Manage event > Event page > Language
• Componente(s): EventDetailView.tsx

Como funciona

1. Se elige English, Español o Custom.
2. Con Custom, se edita el texto de formularios, tickets y feedback.
3. Se guarda.

Backend

• Servicios: events (patch).

Relaciones

• Afecta: registro, ticket y feedback públicos.

Notas

• Los presets restauran su conjunto de textos.

id: publish-event modulo: gestion app: events nombre: Publicar evento tipo: accion

Publicar evento

Hace visible un evento configurado o lo devuelve a borrador.

Que se logra

• Resultado: Hace disponible o retira el evento del calendario y registro públicos.
• Caso de uso: Una academia termina de revisar su taller y lo publica para comenzar a recibir inscripciones.
• Se combina con: Eventos públicos.

Donde esta

• Ruta: /[orgId]/events/[eventId]
• Acceso en UI: Manage event > Publish o Unpublish
• Componente(s): EventManageView.tsx

Como funciona

1. Se pulsa Publish para publicar.
2. Se pulsa Unpublish para devolverlo a borrador.

Reglas y validaciones

• Un evento cancelado no presenta esta acción.

Backend

• Servicios: events (patch).
• Efectos: registra la transición y actualiza la página pública.

Relaciones

• Afecta: Eventos públicos.

Notas

• El enlace público requiere un slug.

id: registration-form modulo: gestion app: events nombre: Diseñar formulario de registro tipo: configuracion

Diseñar formulario de registro

Define los datos solicitados a quien se registra públicamente.

Que se logra

• Resultado: Recoge información necesaria para atender o segmentar a cada asistente.
• Caso de uso: Una clínica organiza una charla de salud y solicita datos relevantes antes de confirmar cupo.
• Se combina con: Contacts y Eventos públicos.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=registration
• Acceso en UI: Manage event > Registration > Registration questions
• Componente(s): EventDetailView.tsx, EventContactCustomFieldsSection.tsx

Como funciona

1. Se eligen los campos de contacto visibles.
2. Opcionalmente se identifica al contacto por email o teléfono.
3. Se agregan preguntas propias y se guardan.

Reglas y validaciones

• Debe permanecer habilitado email o teléfono.
• Las preguntas Select y Multi-select usan opciones separadas por comas.

Backend

• Servicios: events (patch), public-event-registration (create).

Relaciones

• Requiere: Contacts.
• Afecta: registro público.

Notas

• Cada pregunta puede ser obligatoria.

id: registration-settings modulo: gestion app: events nombre: Configurar registro tipo: configuracion

Configurar registro

Controla quién puede registrarse y bajo qué condiciones.

Que se logra

• Resultado: Controla quién puede registrarse y cómo responder ante cupos, aprobación y visibilidad.
• Caso de uso: Una universidad abre un evento solo con aprobación para administrar plazas limitadas.
• Se combina con: Eventos públicos, Guests y Tickets.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=registration
• Acceso en UI: Manage event > Registration
• Componente(s): EventManageView.tsx

Como funciona

1. Se activa o cierra el registro.
2. Se configura aprobación, capacidad, espera, lista pública y ventana.
3. Se pulsa Save.

Reglas y validaciones

• La lista de espera solo se habilita si hay una capacidad positiva.
• La capacidad efectiva también puede depender del ticket.

Backend

• Servicios: events (patch), event-registrations (create).

Relaciones

• Afecta: Eventos públicos y Guests.

Notas

• La visibilidad puede ser Public o Private.

id: ticket-types modulo: gestion app: events nombre: Gestionar tipos de ticket tipo: configuracion

Gestionar tipos de ticket

Crea y mantiene las entradas disponibles para el evento.

Que se logra

• Resultado: Ofrece modalidades de entrada con precio, cupo y reglas diferenciadas.
• Caso de uso: Un organizador vende entrada general y VIP para una conferencia con disponibilidad independiente.
• Se combina con: Cupones, pagos y registro público.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=registration
• Acceso en UI: Manage event > Registration > Add ticket
• Componente(s): EventTicketTypesSection.tsx

Como funciona

1. Se crea o edita una entrada.
2. Se define Free o Paid, disponibilidad y condiciones.
3. Se guarda o elimina tras confirmación.

Reglas y validaciones

• El nombre es obligatorio; un ticket pagado requiere precio positivo.
• No se permite eliminar un ticket ya usado.

Backend

• Servicios: event-ticket-types (find, create, patch, remove).

Relaciones

• Requiere: Payments para tickets pagados.
• Afecta: registro público y cupones.

Notas

• Los tickets ocultos no se muestran públicamente.

id: guests app: events nombre: Invitados estado: shipped permiso: can_access_events

Invitados

Gestiona el roster de asistentes de toda la organización o de un evento concreto.

Para que sirve

• Un organizador de conferencias controla invitaciones, aprobaciones y asistencia de cientos de ponentes y participantes.
• Una universidad registra asistentes de jornadas académicas y los relaciona con prospectos del CRM.
• Una iglesia invita miembros a retiros y conserva una lista operativa para el día del evento.

Que lo hace diferente

• Cada asistente se asocia o crea como contacto CRM, por lo que el historial no queda separado del resto de la relación.
• Los cambios de registro y el check-in pueden activar automatizaciones.
• Las invitaciones y notificaciones pueden salir por email o WhatsApp desde Apex.
• El estado de pago, ticket y feedback se consulta junto con el registro.

Acceso

• Ruta principal: /[orgId]/events/guests
• Como se llega: Events > Guests o Manage event > Guests
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventGuestsTable.tsx y EventInviteGuestsDialog.tsx.
• Backend: event-registrations, event-feedback.
• Integraciones externas: email y WhatsApp para invitaciones y notificaciones.

Funcionalidades internas

Relaciones

• Depende de: Gestión de eventos, Contacts y Tickets.
• Usado por: Check-in, People, Insights y Eventos públicos.

Limitaciones y notas

• La exportación contiene únicamente los resultados de la página y filtro actuales.

id: add-guest modulo: guests app: events nombre: Añadir invitado manualmente tipo: accion

Añadir invitado manualmente

Registra una persona desde el roster de un evento.

Que se logra

• Resultado: Añade al roster a una persona recibida por un canal distinto al registro público.
• Caso de uso: Una iglesia inscribe manualmente a un miembro que se anotó por teléfono.
• Se combina con: Contacts y Check-in.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=guests
• Acceso en UI: Manage event > Guests > Add
• Componente(s): EventGuestsTable.tsx

Como funciona

1. Se introduce email y datos opcionales.
2. Se seleccionan ticket y estado.
3. Se guarda y, si aplica, se envía invitación.

Campos y opciones

Reglas y validaciones

• Al marcar Send invite, el estado es invitado.

Backend

• Servicios: event-registrations (create).
• Efectos: crea o vincula el contacto y notifica salvo exclusión.

Relaciones

• Requiere: Guests y Contacts.

Notas

• Se pueden añadir notas internas.

id: export-guests modulo: guests app: events nombre: Exportar roster tipo: accion

Exportar roster

Descarga los invitados visibles en formato CSV.

Que se logra

• Resultado: Obtiene una lista utilizable de los asistentes que cumplen el filtro actual.
• Caso de uso: Un equipo de recepción descarga el roster aprobado para preparar acreditaciones.
• Se combina con: Guests y Check-in.

Donde esta

• Ruta: /[orgId]/events/guests
• Acceso en UI: Guests > Export
• Componente(s): EventGuestsTable.tsx

Como funciona

1. Se aplica el filtro necesario.
2. Se pulsa Export.

Backend

• Servicios: event-registrations (find).

Relaciones

• Requiere: roster.

Notas

• Incluye nombre, contacto, empresa, estado, ticket, pago, registro y check-in de la página actual.

id: guest-check-in modulo: guests app: events nombre: Gestionar asistencia desde invitados tipo: accion

Gestionar asistencia desde invitados

Permite marcar o revertir el ingreso sin abrir el escáner.

Que se logra

• Resultado: Registra desde el roster si una persona llegó al evento.
• Caso de uso: Una universidad marca la llegada de asistentes que no usan QR.
• Se combina con: Check-in e Insights.

Donde esta

• Ruta: /[orgId]/events/guests
• Acceso en UI: Guests > menú de acciones > Check in
• Componente(s): EventGuestsTable.tsx

Como funciona

1. Se abre el menú de un invitado aprobado.
2. Se elige Check in o Undo check-in.

Reglas y validaciones

• El check-in solo se habilita para un invitado aprobado.

Backend

• Servicios: event-registrations (patch).
• Efectos: actualiza contadores y automatizaciones.

Relaciones

• Afecta: Check-in e Insights.

Notas

• Revertir desde el roster omite notificaciones.

id: guest-crm-contact modulo: guests app: events nombre: Acceder al contacto CRM tipo: vista

Acceder al contacto CRM

Abre el perfil de CRM que corresponde al registro.

Que se logra

• Resultado: Conecta la inscripción con el historial comercial o relacional de la persona.
• Caso de uso: Una agencia abre el contacto de un invitado para continuar su seguimiento tras el evento.
• Se combina con: Contacts, Deals y Automatizaciones.

Donde esta

• Ruta: /[orgId]/events/guests
• Acceso en UI: Guests > menú de acciones > View contact
• Componente(s): EventGuestsTable.tsx

Como funciona

1. Se abre el menú de un registro vinculado.
2. Se elige View contact.

Reglas y validaciones

• Solo aparece cuando hay contacto vinculado.

Backend

• Servicios: event-registrations (find).

Relaciones

• Requiere: Contacts.

Notas

• Los registros públicos buscan o crean el contacto automáticamente.

id: guest-feedback modulo: guests app: events nombre: Consultar feedback de invitados tipo: vista

Consultar feedback de invitados

Reúne valoraciones que los asistentes envían después del evento.

Que se logra

• Resultado: Reúne valoraciones posteriores para evaluar la experiencia del asistente.
• Caso de uso: Una escuela consulta la opinión de quienes participaron en un taller.
• Se combina con: Insights y comunicaciones de feedback.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=insights
• Acceso en UI: Manage event > Insights > Feedback
• Componente(s): EventInsightsPanel

Como funciona

1. Se abre la analítica del evento.
2. Se revisan promedio, distribución y comentarios.

Backend

• Servicios: event-feedback, event-insights (find).

Relaciones

• Requiere: feedback público.

Notas

• El feedback se consulta desde Manage event > Insights > Feedback, no como columna directa del roster.

id: guest-roster modulo: guests app: events nombre: Consultar roster de invitados tipo: vista

Consultar roster de invitados

Muestra asistentes de todos los eventos o de un evento seleccionado.

Que se logra

• Resultado: Da visibilidad sobre las personas inscritas y su situación dentro de cada evento.
• Caso de uso: Un organizador revisa los asistentes aprobados antes de una conferencia.
• Se combina con: Check-in y contactos CRM.

Donde esta

• Ruta: /[orgId]/events/guests
• Acceso en UI: Events > Guests
• Componente(s): EventGuestsTable.tsx

Como funciona

1. Se busca por nombre, email u otro término.
2. Se selecciona un estado o Checked in.
3. Se cambia de página para ver más resultados.

Reglas y validaciones

• En la vista global se puede abrir el evento del registro.

Backend

• Servicios: event-registrations (find).

Relaciones

• Requiere: Gestión de eventos.

Notas

• La página de gestión limita el roster al evento actual.

id: guest-status modulo: guests app: events nombre: Cambiar estado de invitado tipo: accion

Cambiar estado de invitado

Permite aprobar, rechazar, esperar o cancelar registros.

Que se logra

• Resultado: Actualiza la decisión operativa de una inscripción y mantiene al asistente informado.
• Caso de uso: Una universidad aprueba solicitudes para una sesión con plazas limitadas.
• Se combina con: Notificaciones de invitados y Automatizaciones.

Donde esta

• Ruta: /[orgId]/events/guests
• Acceso en UI: Guests > menú de acciones
• Componente(s): EventGuestsTable.tsx

Como funciona

1. Se abre el menú del invitado.
2. Se selecciona Approve, Decline, Move to waitlist o Cancel.

Reglas y validaciones

• Las acciones disponibles dependen del estado actual.

Backend

• Servicios: event-registrations (patch).
• Efectos: recalcula los totales y puede enviar una notificación de estado.

Relaciones

• Afecta: Check-in e Insights.

Notas

• Cancel solicita confirmación.

id: invite-guests modulo: guests app: events nombre: Invitar asistentes tipo: accion

Invitar asistentes

Crea registros invitados y envía enlaces de registro prellenados.

Que se logra

• Resultado: Crea invitaciones y permite convocar personas a un evento concreto.
• Caso de uso: Un organizador invita clientes estratégicos a una sesión privada.
• Se combina con: Contacts y comunicaciones por email o WhatsApp.

Donde esta

• Ruta: /[orgId]/events/[eventId]?tab=guests
• Acceso en UI: Manage event > Guests > Invite guests
• Componente(s): EventInviteGuestsDialog.tsx

Como funciona

1. Se agregan destinatarios.
2. Se envía la invitación.

Backend

• Servicios: event-registrations (create).
• Efectos: envía email de invitación.

Relaciones

• Afecta: registro público.

Notas

• Los destinatarios se procesan individualmente a partir de la lista ingresada; no se muestra un límite de envío en la interfaz.

id: insights app: events nombre: Analítica de eventos estado: shipped permiso: can_access_events

Analítica de eventos

Resume la conversión, asistencia, ingresos y feedback de la organización o de un evento.

Para que sirve

• Un organizador de conferencias mide cuántas visitas terminan en registros y asistencia real.
• Un equipo de formación compara ingresos y desempeño de sus sesiones pagas.
• Una universidad identifica qué fuentes llevan más participantes a actividades institucionales.

Que lo hace diferente

• Une vistas de páginas, registros, pagos, asistencia y feedback del mismo flujo de eventos.
• Usa el check-in y los estados operativos de Apex para medir asistencia real.
• Las fuentes, tickets y valoraciones se analizan sin mover datos a otra herramienta.

Acceso

• Ruta principal: /[orgId]/events/insights
• Como se llega: Events > Insights o Manage event > Insights
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventsInsightsView.tsx y EventInsightsPanel.
• Backend: event-insights y event-page-views.

Funcionalidades internas

Relaciones

• Depende de: Eventos públicos, Guests, Check-in, Tickets y Feedback.
• Usado por: equipos de operación y marketing.

Limitaciones y notas

• Los periodos predefinidos disponibles son últimos 7, 30 y 90 días.

id: conversion-trends modulo: insights app: events nombre: Analizar embudo y tendencia tipo: vista

Analizar embudo y tendencia

Visualiza la conversión desde la visita hasta el check-in y su evolución diaria.

Que se logra

• Resultado: Explica cómo evolucionan las etapas desde una visita hasta la asistencia.
• Caso de uso: Una universidad detecta que aumentan las visitas pero bajan los registros de una jornada.
• Se combina con: Eventos públicos, Guests y Check-in.

Donde esta

• Ruta: /[orgId]/events/insights
• Acceso en UI: Events > Insights
• Componente(s): EventInsightsPanel

Como funciona

1. Se elige el periodo.
2. Se revisa el embudo vistas, registros, aprobados y check-ins.
3. Se compara la serie temporal de vistas, registros y asistencia.

Reglas y validaciones

• Las tasas solo aparecen si existe un denominador.

Backend

• Servicios: event-insights (find).

Relaciones

• Requiere: Eventos públicos y Check-in.

Notas

• El embudo general calcula también conversión de vistas a check-in.

id: event-kpis modulo: insights app: events nombre: Consultar métricas de eventos tipo: vista

Consultar métricas de eventos

Muestra indicadores de demanda, conversión, asistencia, ingresos y feedback.

Que se logra

• Resultado: Hace visible el rendimiento de registros, asistencia, ingresos y feedback.
• Caso de uso: Un organizador compara la respuesta de una conferencia antes y después de su campaña.
• Se combina con: Guests, Check-in y Eventos públicos.

Donde esta

• Ruta: /[orgId]/events/insights
• Acceso en UI: Events > Insights
• Componente(s): EventsInsightsView.tsx, EventInsightsPanel

Como funciona

1. Se selecciona un periodo de 7, 30 o 90 días.
2. Se consultan las tarjetas de métricas.

Reglas y validaciones

• Los ingresos pendientes se presentan separados de los cobrados.

Backend

• Servicios: event-insights (find).

Relaciones

• Requiere: vistas públicas, registros y check-in.

Notas

• La misma vista se puede limitar a un evento desde Manage event > Insights.

id: event-performance modulo: insights app: events nombre: Desglosar rendimiento de eventos tipo: vista

Desglosar rendimiento de eventos

Explica el rendimiento por evento, fuente, ticket y respuesta de satisfacción.

Que se logra

• Resultado: Compara qué eventos, fuentes, tickets y valoraciones están funcionando mejor.
• Caso de uso: Un equipo de formación identifica el canal que genera más inscripciones pagas.
• Se combina con: Eventos públicos, Tickets y Feedback.

Donde esta

• Ruta: /[orgId]/events/insights
• Acceso en UI: Events > Insights
• Componente(s): EventInsightsPanel

Como funciona

1. Se consulta la tabla de eventos destacados.
2. Se revisan fuentes de registros y tipos de ticket.
3. Se revisa promedio, distribución y comentarios de feedback.

Backend

• Servicios: event-insights (find).

Relaciones

• Requiere: Guests, Tickets y Feedback.

Notas

• Los eventos destacados enlazan a su página de gestión.

id: people app: events nombre: Personas estado: shipped permiso: can_access_events

Personas

Ofrece un directorio consolidado de asistentes entre eventos y su relación con el CRM.

Para que sirve

• Un organizador identifica asistentes recurrentes entre conferencias y los abre como contactos del CRM.
• Una universidad segmenta personas que han asistido a distintos eventos para seguimiento académico.
• Una comunidad profesional reconoce quién participa con mayor frecuencia en sus encuentros.

Que lo hace diferente

• Consolida la participación entre eventos sobre contactos CRM, no sobre listas independientes.
• Permite pasar de la actividad de eventos al perfil comercial o relacional de la persona.
• Conserva métricas de asistencia y gasto por persona dentro del contexto de la organización.

Acceso

• Ruta principal: /[orgId]/events/people
• Como se llega: Events > People
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventsPeopleView.tsx.
• Backend: event-people y events.
• Integraciones externas: Contacts del CRM.

Funcionalidades internas

Relaciones

• Depende de: Guests, Events y Contacts.
• Usado por: gestión comercial y seguimiento de asistentes.

Limitaciones y notas

• Los importes mostrados se agrupan por moneda disponible; no se convierten entre monedas.

id: filter-event-people modulo: people app: events nombre: Filtrar y ordenar asistentes tipo: vista

Filtrar y ordenar asistentes

Permite acotar el directorio para encontrar y priorizar personas.

Que se logra

• Resultado: Permite localizar perfiles de asistentes relevantes por evento o actividad.
• Caso de uso: Un organizador filtra personas de un congreso para preparar un seguimiento posterior.
• Se combina con: People y Contacts.

Donde esta

• Ruta: /[orgId]/events/people
• Acceso en UI: Events > People
• Componente(s): EventsPeopleView.tsx

Como funciona

1. Se busca por texto o se selecciona un evento.
2. Se ordena por último evento, eventos, asistencia, nombre o gasto.

Reglas y validaciones

• Al cambiar filtro u orden se reinicia la paginación.

Backend

• Servicios: event-people (find), events (find).

Relaciones

• Requiere: directorio de asistentes.

Notas

• La búsqueda se aplica con una breve espera.

id: open-crm-contact modulo: people app: events nombre: Abrir contacto CRM del asistente tipo: vista

Abrir contacto CRM del asistente

Navega desde una persona de Events al perfil CRM asociado.

Que se logra

• Resultado: Abre el registro CRM asociado para continuar la relación fuera del evento.
• Caso de uso: Una agencia consulta los datos de un asistente antes de proponerle una reunión.
• Se combina con: Contacts, Conversations y Deals.

Donde esta

• Ruta: /[orgId]/events/people
• Acceso en UI: Events > People > fila de persona
• Componente(s): EventsPeopleView.tsx

Como funciona

1. Se selecciona una fila que tiene contacto asociado.
2. Se abre el perfil en /[orgId]/contacts/[contactId].

Reglas y validaciones

• Solo es navegable cuando existe una vinculación de contacto.

Backend

• Servicios: event-people (find).

Relaciones

• Requiere: Contacts.

Notas

• El último evento también puede abrir su gestión.

id: people-directory modulo: people app: events nombre: Consultar directorio de asistentes tipo: vista

Consultar directorio de asistentes

Agrupa la actividad de asistentes a través de eventos.

Que se logra

• Resultado: Consolida la participación de una persona entre distintos eventos.
• Caso de uso: Una universidad identifica a un prospecto que ha asistido a varias actividades.
• Se combina con: Contacts y Guests.

Donde esta

• Ruta: /[orgId]/events/people
• Acceso en UI: Events > People
• Componente(s): EventsPeopleView.tsx

Como funciona

1. Se consultan personas consolidadas.
2. Se revisan eventos, asistencias, gasto y último evento.

Reglas y validaciones

• La consolidación usa contacto o email.

Backend

• Servicios: event-people (find).

Relaciones

• Requiere: Guests y Contacts.

Notas

• Muestra el total de personas y métricas de la página actual.