1. Primeros pasos
- Ingresa al Panel admin con tu email y contraseña. Si todavía no la tienes, ejecuta
pnpm admin:setup tu@email.cl 'TuPassword'en tu terminal: genera el hash bcrypt y lo sube a Vercel. - Verifica que tu dominio esté apuntando al deploy. En Vercel, ve a Settings → Domains → Add y agrega
conexiones.cloud. - En Resend (correos), asegúrate que el dominio esté Verified. Hasta que lo esté, los emails salen desde
onboarding@resend.devy solo llegan a la casilla del titular de la cuenta Resend. - En Mercado Pago, configura el webhook hacia
/api/payments/webhook/mercado-pago, evento payment, y copia el Webhook Secret a las env vars (MP_WEBHOOK_SECRET).
2. Crear y publicar un evento
Desde Panel → Eventos, haz clic en Nuevo evento. El formulario tiene tres bloques:
Información básica
- Nombre del evento (público, lo que ve el comprador).
- Slug: el segmento de URL pública (
/eventos/tu-slug). Se autocompleta a partir del nombre; puedes editarlo. - Descripción, fecha, hora.
- Imagen de portada (URL). Recomendado 1920×1080 o 16:9. Si lo dejas vacío usamos un placeholder con la marca Conexiones.
- Venue, dirección, ciudad.
- Nombre del productor (aparece en la página pública y en el resumen del email).
Tipos de entrada y tandas
Un tipo de entrada es un producto comercial (General, VIP, Estudiante). Dentro de cada tipo defines una o más tandas: cada tanda tiene su propio precio, cupo y ventana de venta.
Ejemplo: tipo "General" con dos tandas: Early bird $5.000 / 100 cupos / hasta el 1 de febrero, y General $8.000 / 400 cupos / hasta el día del evento.
Guardar como borrador o publicar
Al crear, el evento queda en estado borrador. No aparece en el catálogo público hasta que lo publicas desde la página de detalle del evento, sección Acciones.
Estados disponibles
- Borrador: sólo tú lo ves desde el admin.
- Publicado: aparece en
/eventosy acepta compras. - Pausado: sigue visible pero no acepta nuevas compras.
- Finalizado: el evento ya ocurrió; sigue en historial pero no se vende.
- Cancelado: dispara reembolso automático del 100% a todos los compradores.
3. Mensajes personalizados
Cada evento puede tener un asunto de email y un mensaje extra que se muestra en el correo de confirmación y en la página de confirmación post-pago.
Edita un evento desde Panel → Eventos → (evento) → Editar, sección Mensajes personalizados.
En el asunto puedes usar dos placeholders:
{event}→ nombre del evento.{qty}→ cantidad de entradas en la orden.
Ejemplo de asunto: "{qty} entradas listas para {event} 🎫". Ejemplo de mensaje extra: "Trae documento de identidad. Acceso desde las 19:00. El evento es bajo techo, llueva o no."
4. Pagos y cargo por servicio
Procesamos los pagos vía Mercado Pago Chile (Checkout Pro). El comprador puede pagar con tarjeta de crédito o débito, transferencia, saldo MP y cuotas. El cobro es directo desde el redirect seguro de MP; no almacenamos datos de tarjeta.
Cargo por servicio
Como productor pagas 0%. Al comprador se le agrega un cargo del 6% del subtotal, con piso de $300 CLP y techo de $5.000 CLP por orden. Se informa de manera destacada en el checkout antes de confirmar el pago.
Ejemplo · 1 ticket de $20.000
Liquidación
Mercado Pago liquida directamente al productor según los plazos de su contrato con MP (típico 24-72h hábiles, configurable en el panel de MP). Conexiones no intermedia los fondos.
Cuotas
Las cuotas están habilitadas. El webhook de MP avisa cuando el pago pasa de in_process a approved: hasta entonces la orden queda en pending y los tickets aún no se emiten.
5. Eventos gratuitos
Si todas las tandas de tu evento tienen precio $0, Conexiones omite el paso de Mercado Pago y emite los tickets directamente. El comprador completa el formulario, hace clic en Reservar entrada gratis y recibe su QR por email al instante.
Tampoco se aplica el cargo por servicio (no hay piso de $300) ni se cobra al productor.
Tip:Si quieres un mix de gratis + pagado en el mismo evento, define dos tipos de entrada (ej. "General gratis" con tandas de $0 y "Apoyo" con tandas pagadas). El comprador elige; si solo selecciona gratis, pasa por el flujo simplificado.
6. Códigos de descuento
Crea códigos promocionales para campañas, sponsors, prensa o equipo. Ve a Panel → Eventos → entra al evento → Descuentos.
Cómo funcionan
- Dos tipos: Porcentaje (1-100%) o Monto fijo (en CLP).
- Opcionalmente puedes limitar usos máximos y fijar una fecha de expiración.
- El comprador lo ingresa en el resumen del checkout. La app valida y muestra el descuento aplicado.
- El cargo por servicio se recalcula sobre el subtotal con el descuento ya aplicado.
- El consumo del código es atómico: si se agota mientras alguien está completando la compra, el siguiente recibe error claro.
Disponibilidad por plan: los códigos de descuento están en Productor Pro y Enterprise. En Self-serve esta función está visible pero gateada.
7. Cortesías (tickets gratis emitidos por admin)
Para invitados, prensa, sponsors o equipo, emite tickets directamente sin pasar por checkout. Desde el evento → Cortesías:
- Ingresa el email y nombre del invitado.
- Elige la tanda (la app muestra solo las que tienen stock).
- Cantidad (1 a 50 por emisión).
- Nota opcional (ej. "Acceso prensa, área backstage") que se incluye destacada en el email.
Se descuenta del cupo real de la tanda y se le envía al invitado un correo con su QR válido. Queda registrado en la orden con método complimentary y tú quedas marcado como emisor.
8. Compartir y página pública del organizador
Botones de compartir
Cada página de evento tiene botones nativos para compartir por WhatsApp, X, Facebook, copiar enlace y el menú nativo del sistema (navigator.share) en móviles.
Open Graph automático
Cuando alguien pega el link en WhatsApp, Instagram, Facebook o Slack, se muestra la imagen del evento, su nombre y descripción. La meta tag se genera en server side y respeta tu imagen personalizada.
Página pública del productor
Tu productora tiene una página propia en /p/<slug-productor> que lista todos tus eventos publicados. Útil para enlazar desde tu Instagram, tarjeta de presentación o newsletter. Con plan Pro o Enterprise puedes personalizar logo y color de marca.
9. Recordatorios automáticos
24 horas antes del evento Conexiones envía automáticamente un email a cada comprador con tickets válidos. El correo incluye:
- Fecha, hora, venue y dirección del evento.
- Tu mensaje personalizado del evento, si lo tienes configurado.
- Botón de acceso directo a sus tickets (vía magic link sin necesidad de re-ingresar email).
El cron corre todos los días a las 08:00 hora Chile. No tienes que configurar nada: si publicas un evento para mañana o pasado mañana, los recordatorios se mandan solos.
10. Validar tickets en puerta
En el día del evento abre Panel → Validar entradas desde el móvil o el laptop del responsable de puerta. Selecciona el evento que vas a validar y la pantalla queda lista para escanear o ingresar códigos manualmente.
Cada ticket válido se marca como usado al primer escaneo. Si alguien intenta entrar con un ticket ya usado, la pantalla lo muestra en amarillo con la fecha y hora del check-in anterior.
Importante: hoy la validación usa código manual o un escáner externo que tipea el QR como texto. El escáner con cámara directa está planificado para Fase 2.
QR firmado, no clonable
Cada ticket lleva un JWT firmado con tu TICKET_SECRET del servidor. La validación verifica la firma antes de marcar el ticket como usado: capturas de pantalla y QRs falsos no funcionan.
11. Reembolsos y cancelaciones
Reembolso individual: desde Panel → Órdenes, filtra por estado paid y haz clic en Reembolsar. Se llama a la API de Mercado Pago, se marcan los tickets como cancelados, se libera el cupo y se envía email al cliente.
Cancelar evento completo: desde el detalle del evento, Acciones → Cancelar evento. Esto cambia el estado a cancelado, dispara reembolso 100% de todas las órdenes pagadas y notifica a cada cliente. El cargo por servicio también se reembolsa (cumple SERNAC).
Importante legal: no hay derecho a retracto en espectáculos públicos (Ley 19.496 art. 3 bis) siempre que se haya informado en el checkout. Conexiones lo informa automáticamente en el checkbox de aceptación.
12. Planes y suscripción
Hay tres planes. Self-serve es gratis (pagas $0 al mes, el cargo lo asume el comprador). Productor Pro cuesta $29.990 CLP/mes con 14 días gratis de prueba y baja el cargo al comprador del 6% al 4%. Enterprise es a medida (cargo negociado + multi-admin + SLA + 30 días de prueba).
| Feature | Self-serve | Productor Pro | Enterprise |
|---|---|---|---|
| Costo mensual | Gratis | $29.990 CLP | A medida |
| Días de prueba | — | 14 | 30 |
| Cargo al comprador | 6% piso $300 techo $5.000 | 4% piso $200 techo $4.000 | 3% negociable |
| Eventos activos | 5 | 50 | Sin límite |
| Tickets / mes | 2.000 | 20.000 | Sin límite |
| Mensajes personalizados | ✓ | ✓ | ✓ |
| Cortesías | ✓ | ✓ | ✓ |
| Export CSV asistentes | ✓ | ✓ | ✓ |
| Eventos gratuitos | ✓ | ✓ | ✓ |
| Recordatorios automáticos | ✓ | ✓ | ✓ |
| Códigos de descuento | — | ✓ | ✓ |
| Branding personalizado | — | ✓ | ✓ |
| Email marketing a asistentes | — | ✓ | ✓ |
| Múltiples admins / roles | — | ✓ | ✓ |
| Soporte prioritario | — | ✓ | ✓ + SLA |
Cambia de plan desde Panel → Plan. El cobro recurrente con Mercado Pago Subscriptions se activa pronto; por ahora los upgrades a Pro/Enterprise se gestionan escribiendo a contacto@conexiones.cloud.