> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onstudio.mx/llms.txt
> Use this file to discover all available pages before exploring further.

# Crea y administra eventos especiales en OnStudio

> Configura, publica y revisa inscripciones de talleres, salidas y otras experiencias especiales desde Eventos en OnStudio.

# Eventos

Usa `Eventos` para organizar talleres, salidas, workshops y otras experiencias fuera de la programación regular de clases.

## Antes de empezar

* En el menú lateral, abre `Eventos`.
* Define la fecha, el horario, el cupo y si el evento será gratis o tendrá un precio en MXN.
* Confirma la zona horaria de la primera ubicación activa registrada: OnStudio la usa para determinar cuándo inicia el evento.
* Si usarás una sala, comprueba primero su capacidad. El cupo del evento no puede superar la capacidad de la sala.
* Para publicar un evento en las superficies para clientes, marca `Publicar evento` al crearlo o usa `Publicar` desde su detalle.

## Crear un evento

1. Presiona `Crear evento`.
2. En `Información pública`, completa `Nombre del evento` y, si aplica, agrega `Descripción`, `Imagen` y `Políticas e indicaciones`.
3. Activa `Destacar en inicio` si quieres que el evento se presente como destacado.
4. En `Coaches`, selecciona quién dirigirá el evento. Puedes dejar esta sección vacía.
5. En `Fecha y horario`, captura `Fecha`, `Hora` y `Duración`.
6. En `Ubicación`, elige `Sala del estudio`, `Ubicación del estudio` o `Lugar externo`. Para un lugar externo, busca la sede y selecciona una sugerencia de Google Maps. Después puedes personalizar `Nombre visible` y agregar `Indicaciones adicionales`; la dirección, las coordenadas y el identificador de Google permanecen ligados a la sugerencia elegida.
7. En `Cupo y precio`, define `Cupo`. Deja `Precio en MXN` vacío para un evento gratis.
8. En `Publicación`, marca `Publicar evento` si ya debe quedar visible para clientes.
9. Presiona `Guardar evento`.

## Administrar publicación e inscripciones

* La lista se organiza con `Próximos`, `Borradores`, `Pasados` y `Cancelados` y muestra fecha, ubicación, inscritos, precio y estado.
* Abre un evento para usar `Editar`, `Publicar` o `Despublicar`.
* Desde el detalle también puedes copiar el enlace público y revisar las inscripciones registradas.
* El detalle muestra la sede normalizada, un mapa cuando existen coordenadas y el botón `Cómo llegar`. También puedes presionar el mapa completo para abrir direcciones.
* Para cancelar, presiona `Cancelar`, agrega un `Motivo de cancelación (opcional)` si lo necesitas y confirma con `Sí, cancelar evento`. La confirmación indica cuántas inscripciones se cancelarán y el evento deja de aceptar clientes nuevos.

## Corregir ubicaciones incompletas o históricas

* Al editar un evento externo creado antes del selector de Google Maps, la sede anterior permanece visible como referencia. Para volver a guardar, busca la dirección y selecciona una sugerencia; no copies manualmente un enlace de mapa.
* Si una `Sala del estudio` o `Ubicación del estudio` no tiene dirección y coordenadas válidas, el evento no se puede guardar. Corrige primero la ubicación desde la configuración del estudio y vuelve al evento.
* Cuando una superficie no recibe coordenadas o no tiene una credencial de mapas disponible, muestra el nombre, la dirección, las indicaciones y `Cómo llegar` si existe una URL segura. No muestra una imagen ni un espacio de mapa de reemplazo.

## Qué cambia para el cliente

* Los eventos publicados aparecen en la Página Web y la app móvil del estudio.
* En la Página Web, el cliente abre `Eventos` y entra con `Ver evento`. El detalle muestra fecha, duración, ubicación, lugares disponibles y precio; cuando existen, también presenta `Descripción del evento:`, `Coaches:`, un mapa no interactivo, `Cómo llegar` y `Políticas e indicaciones:`. Presionar el mapa abre la misma ruta de direcciones.
* Desde el detalle, el cliente usa `Inscribirme`. Si no inició sesión, verá `Iniciar sesión para inscribirme`; al completar una inscripción gratuita, la página confirma `Tu lugar quedó confirmado.`.
* Los eventos gratis inscriben al cliente sin checkout. Los eventos con precio abren el checkout correspondiente.
* Al llegar la hora de inicio en la zona horaria del estudio, el evento deja de estar disponible para inscripciones nuevas y no permite iniciar o continuar su checkout.
* Cuando ya no hay lugares, la Página Web muestra `Agotado` y la app móvil muestra `Cupo lleno`.
* En la app móvil, el cliente puede revisar `Mis eventos` con las vistas `Próximos`, `Inscrito` e `Historial`. En el detalle, el mapa es nativo y `Cómo llegar` permite elegir Apple Maps, Google Maps o navegador según el dispositivo y las aplicaciones instaladas.

## Configuración de mapas

* Admin y Página Web usan `PUBLIC_GOOGLE_MAPS_API_KEY`. Debe ser una credencial web restringida por referrer y habilitada para las APIs de Google Maps que consume cada app, como Places y Maps Embed.
* Los builds nativos de Android usan `GOOGLE_MAPS_ANDROID_API_KEY`. Configúrala como variable o secreto de build y restríngela por package name y SHA-1.
* iOS usa Apple Maps para el preview nativo y no requiere una credencial de Google Maps en esta entrega.
* No reutilices la credencial Android en superficies web ni guardes valores reales en el repositorio.

## Qué revisar antes de contactar soporte

* Que el evento esté publicado y todavía no haya iniciado.
* Que la primera ubicación activa registrada tenga la zona horaria correcta si el evento cambia a pasado o deja de aceptar inscripciones antes o después de lo esperado.
* Que el cupo sea mayor a cero y no supere la capacidad de la sala seleccionada.
* Que un lugar externo provenga de una sugerencia de Google Maps y conserve dirección completa.
* Que el precio esté capturado en pesos; si está vacío, el evento se trata como gratis.
* Que el estudio tenga configurado su enlace público antes de intentar copiar el link del evento.

## Cuándo contactar soporte

* Si un evento publicado no aparece para clientes después de recargar.
* Si el contador de inscripciones o el cupo disponible no coincide con las inscripciones confirmadas.
* Si un evento con lugares disponibles no permite completar la inscripción.
* Si guardar, publicar, despublicar o cancelar devuelve un error repetido.
