El registro de eventos headless consiste en que las pantallas de reserva viven en una app propia de la marca, mientras una plataforma de eventos gestiona por detrás el registro, los cupos y el check-in mediante una API y webhooks. El invitado nunca sale de la app de la marca.

En Japón, esa app suele ser una LINE MINI App. Una marca quiere que sus invitados reserven un horario sin salir de LINE, con las pantallas y el idioma de la marca. Aun así, alguien tiene que guardar los cupos, registrar a los invitados y hacerles check-in en la puerta, y esa es la parte que hace Eventtia.

Cartier gestiona sus reservas de eventos en Japón con una LINE MINI App que funciona sobre Eventtia. Este artículo describe la arquitectura que hay detrás de ese tipo de integración, para los equipos que quieren llevar la reserva de eventos a una app propia, sea LINE o cualquier otra. Para la vista de proyecto (quién construye qué, pasos y preguntas frecuentes), consulta nuestra guía de integración con LINE.

La arquitectura de un vistazo

Pieza Responsable Qué hace
LINE MINI App La marca o su agencia Páginas del evento, horarios, formularios de reserva y de acompañantes, confirmación y código QR
Backend operado por la marca La marca o su agencia Verifica al usuario de LINE, lo vincula con sus reservas, llama a la API de Eventtia, guarda datos en caché para mostrarlos y recibe los webhooks
Eventtia Eventtia, configurado por el equipo de eventos de la marca Eventos, sesiones, cupos, registros, acompañantes y check-in

Tres reglas sostienen casi todo el diseño:

  • El backend guarda en caché para mostrar, y es Eventtia quien decide el cupo.
  • Un lugar solo se confirma cuando Eventtia acepta la reserva de la sesión.
  • Los webhooks reducen las consultas, pero el backend sigue conciliando su copia.

¿Quién construye qué en una integración con LINE MINI App?

La LINE MINI App es la experiencia del invitado: páginas del evento, horarios, formularios de reserva y de acompañantes, confirmación y código QR. La diseña y la construye la marca o su agencia.

El backend que opera la marca se sitúa entre la MINI App y Eventtia. Verifica al usuario de LINE, lo vincula con sus reservas, llama a la API de Eventtia, guarda en caché lo que necesitan las pantallas y recibe nuestros webhooks. El token de Eventtia vive ahí, nunca en la MINI App. No es un simple intermediario: es donde ocurre la mayor parte del trabajo de integración.

Eventtia guarda el estado que no puede fallar: eventos, sesiones, cupos, registros y check-in. El equipo de eventos de la marca configura los eventos, las sesiones y los cupos en el back office de Eventtia, como para cualquier otro evento por horarios.

¿Cómo protege los cupos la API de reservas?

Un lanzamiento es, sobre todo, lectura. Muchos invitados abren la página del evento en los mismos pocos minutos, miran los horarios, dudan y vuelven. Si cada vista de pantalla se convierte en una llamada a la API, el backend llega rápido al límite.

Nuestro límite estándar es de 100 llamadas a la API por minuto. En proyectos enterprise podemos ampliarlo para las direcciones de los servidores del integrador, y en los picos Eventtia pone las solicitudes en cola y las procesa progresivamente.

Por eso el backend guarda una copia de los eventos y de la disponibilidad de las sesiones, y sirve las pantallas desde ahí. Qué tan fresca debe ser esa copia depende del proyecto y del lanzamiento, y el equipo define su política de actualización. Sea cual sea, la disponibilidad que se muestra en pantalla es provisional.

La reserva es una escritura, y va del backend a Eventtia. Crear al participante y reservar la sesión son dos operaciones separadas en la API de Eventtia. Eventtia valida el cupo cuando procesa la reserva de la sesión, y la app confirma el lugar solo cuando esa reserva se completa. Si la sesión está llena, la app tiene que mostrar esa respuesta con claridad.

Consultas periódicas o webhooks: ¿cómo se mantiene al día el backend?

La forma más sencilla de mantener al día la copia del backend es consultar los datos de las sesiones de forma periódica. Funciona y es fácil de depurar, pero gasta llamadas a la API y la copia siempre va un poco atrasada.

Los webhooks reducen ese trabajo. Eventtia avisa al backend cuando se actualiza un evento, cuando se crea, actualiza o elimina una sesión de actividad, y cuando se crea o actualiza un participante, incluido su estado de check-in. Los webhooks se configuran por evento en el back office, o una sola vez para toda la cuenta mediante la API (referencia de webhooks de cuenta).

Los webhooks son notificaciones y no reemplazan todas las lecturas: el backend sigue necesitando una forma de conciliar su copia con Eventtia, por ejemplo después de una caída.

¿Los acompañantes ocupan cupo?

Sí. Los invitados suelen venir con alguien. En Eventtia, cada acompañante es un participante vinculado y ocupa un cupo en la sesión, con la misma regla que cualquier registro. La app puede pedir más adelante los datos del acompañante, por ejemplo con un enlace que comparte el invitado principal, y enviarlos con los endpoints de actualización.

Tratar a los acompañantes como participantes reales mantiene los cupos honestos, y además permite hacer el check-in persona por persona.

¿Cómo llega el check-in al backend de la marca?

En la puerta, el equipo escanea el código QR del invitado con la app de check-in de Eventtia. El escaneo actualiza al participante, y Eventtia reporta el nuevo estado de check-in con el webhook de participante actualizado. Así el backend de la marca sabe quién vino.

Lo que pasa después lo decide la marca: un mensaje de agradecimiento en LINE, una nota en el CRM o nada.

Datos de registro en Japón

Parte del trabajo práctico de una integración en Japón tiene que ver con pequeñas reglas de datos. Los correos de operadores móviles, como docomo.ne.jp, ezweb.ne.jp e i.softbank.jp, pasan la validación. La API devuelve el formato de fecha configurado en cada evento, para que la MINI App muestre las fechas igual, y los teléfonos se validan por país con libphonenumber, la librería de Google.

¿Qué versiones de la API se pueden usar?

Las versiones 3 y 4 de la API están disponibles a la vez. Las anteriores siguen activas, cada nueva versión suma capacidades y una integración puede usar cualquiera de las dos.

Qué acordar antes de producción

Hay algunas decisiones que conviene acordar con nosotros antes del primer lanzamiento, porque es ahí donde un flujo de reservas falla cuando hay carga:

  • Resultado de la reserva. Qué muestra la app mientras la reserva está en curso, después de un timeout y cuando el resultado es incierto.
  • Envíos repetidos. Cómo maneja el backend a un invitado que toca dos veces, o que reintenta después de un timeout, sin crear una segunda reserva.
  • Manejo de webhooks. Cómo verifica el backend los webhooks que recibe, cómo maneja reintentos y duplicados, y qué hace con las notificaciones que llegan en desorden.
  • Conciliación. Cómo y cuándo compara el backend su copia con Eventtia, para que una notificación perdida no deje un conteo equivocado en pantalla.

El detalle de los endpoints está en la referencia de la API de Eventtia.

¿Los asistentes de IA pueden usar las mismas piezas?

Sí. Cuando el registro es un conjunto de piezas detrás de una API, la interfaz de encima puede cambiar. Una LINE MINI App es una. La app propia de una marca es otra. Un asistente de IA es una tercera.

El servidor MCP de Eventtia (Model Context Protocol) le permite a un asistente consultar eventos, consultar la disponibilidad de las sesiones, registrar a un invitado y consultar los check-ins. Su acceso sigue los permisos del usuario conectado en Eventtia, que es un esquema distinto del token máquina a máquina que usa un backend.

Preguntas frecuentes

¿Qué es el registro de eventos headless?

El registro de eventos headless consiste en que las pantallas de reserva que ve el invitado viven en una app propia de la marca, como una LINE MINI App, mientras una plataforma de eventos gestiona por detrás el registro, los cupos y el check-in mediante una API y webhooks. El invitado nunca sale de la app de la marca.

¿Una LINE MINI App puede usar Eventtia para el registro de eventos?

Sí. La marca o su agencia construye la LINE MINI App y un backend que llama a la API REST de Eventtia y recibe sus webhooks, mientras Eventtia guarda los eventos, las sesiones, los cupos, los registros y el check-in. Cartier gestiona sus reservas de eventos en Japón con una LINE MINI App que funciona sobre Eventtia.

¿Quién decide el cupo en un flujo de reservas headless?

Eventtia. El backend de la marca puede guardar en caché los datos de eventos y sesiones para mostrarlos, pero Eventtia valida el cupo cuando procesa la reserva de la sesión, y la app confirma el lugar solo cuando esa reserva se completa.

¿Cuáles son los límites de la API de Eventtia para un lanzamiento?

El límite estándar es de 100 llamadas a la API por minuto. En proyectos enterprise, Eventtia puede ampliarlo para las direcciones de los servidores del integrador, y en los picos pone las solicitudes en cola y las procesa progresivamente.

¿Los acompañantes cuentan para el cupo de la sesión?

Sí. En Eventtia, cada acompañante es un participante vinculado y ocupa un cupo en la sesión, con la misma regla que cualquier registro, y la app puede pedir sus datos más adelante.

¿El backend debe consultar Eventtia o usar webhooks?

Las dos cosas tienen su lugar. Los webhooks avisan al backend cuando cambian los eventos, las sesiones y los participantes, incluido el estado de check-in, y así reducen las consultas; aun así, el backend necesita una forma periódica de conciliar su copia con Eventtia, por ejemplo después de una caída.

Si estás planeando llevar la reserva de eventos a LINE o a tu propia app, nuestra guía de integración con LINE explica quién construye qué, las piezas de la API y los pasos de implementación.