Manual de uso

Todo lo que necesitas saber para vender tu primer evento en menos de 15 minutos.

1. Primeros pasos

  1. 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.
  2. Verifica que tu dominio esté apuntando al deploy. En Vercel, ve a Settings → Domains → Add y agrega conexiones.cloud.
  3. En Resend (correos), asegúrate que el dominio esté Verified. Hasta que lo esté, los emails salen desde onboarding@resend.dev y solo llegan a la casilla del titular de la cuenta Resend.
  4. 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 /eventos y 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

Valor ticket$20.000
Cargo (6%, tope $5.000)+$1.200
Cliente paga$21.200
Productor recibe$20.000 (menos comisión MP)

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:

  1. Ingresa el email y nombre del invitado.
  2. Elige la tanda (la app muestra solo las que tienen stock).
  3. Cantidad (1 a 50 por emisión).
  4. 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).

FeatureSelf-serveProductor ProEnterprise
Costo mensualGratis$29.990 CLPA medida
Días de prueba1430
Cargo al comprador6% piso $300 techo $5.0004% piso $200 techo $4.0003% negociable
Eventos activos550Sin límite
Tickets / mes2.00020.000Sin 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.