Mostrar eventos en tu propia web (feed de eventos)
Puedes habilitar eventos concretos en un feed JSON público y sin clave para alimentar con Univents el calendario de tu propia web, incluidos el precio desde y el aviso de agotado.
Si quieres mostrar tus eventos también en tu propia web —con tu propio diseño, no como una página de Univents incrustada—, puedes habilitar eventos concretos para ello. Univents los sirve entonces a través de un feed público de solo lectura que tu web (o la de tu agencia) puede consultar y mostrar a su manera.
Mostrar un evento en la web
La habilitación se hace directamente en el evento, no de forma centralizada en un único sitio:
- Abre el evento que quieras.
- Haz clic en el interruptor Mostrar en la web de la cabecera de la vista de detalle.
- Univents guarda el cambio al instante y lo confirma con un breve mensaje.
Con el interruptor activado, el evento aparece en el feed en pocos minutos. Si lo desactivas de nuevo o eliminas el evento, desaparece del feed igual de automáticamente. El interruptor afecta solo a ese evento: no existe una habilitación masiva para todos los eventos a la vez.
El asistente de IA también puede activar el interruptor por ti, por ejemplo con «Muestra la fiesta de verano en nuestra web». Antes te pregunta, porque después los datos se podrán consultar públicamente. También antes de cambiar el nombre, el texto corto o la descripción de un evento que aparece en tu web, el asistente te muestra una confirmación con el evento, la fecha y el nuevo texto. No se guarda nada hasta que confirmas.
Si un evento está habilitado pero todavía no tiene texto corto, junto al interruptor aparece el aviso Aún falta un texto breve para la vista de lista. El aviso no bloquea nada: el evento aparece igualmente en el feed.
Qué contiene el feed
El feed entrega exclusivamente datos pensados para mostrarse en un calendario público: título, descripción, texto corto para la vista de lista, hora de inicio y de fin, si la fecha ya es definitiva, lugar del evento, imagen de portada, etiquetas, un enlace a la venta de entradas (si el evento tiene una página de entradas publicada; en borrador no hay enlace de entradas ni precio), así como el precio de entrada más bajo que aún se puede comprar y un aviso de agotado. Los datos internos como el presupuesto interno, el número de invitados, las notas, los datos de contacto, el estado o los datos financieros nunca aparecen en el feed, independientemente de si el evento está publicado o no. Tampoco salen los cupos, los nombres de las categorías ni las cifras de venta: hacia el exterior solo van el precio y la información «agotado sí/no».
Precio desde y agotado
Si vendes entradas a través de Univents, el feed ofrece tres datos adicionales con los que tu web puede construir un «Desde 25 €» y un «Agotado»:
price_from: el precio de entrada más bajo que un visitante todavía puede comprar, como importe bruto (es decir, lo que figura en la categoría en la tienda de entradas). Si tu categoría más barata está agotada, pasa automáticamente a mostrarse la siguiente más cara. Así tu web nunca promete un precio que ya no existe en la tienda.price_from_currency: la moneda de tu workspace en forma de código, por ejemploEURoCHF.tickets_sold_out:trueen cuanto no queda ninguna categoría de entradas disponible para comprar. Mientras alguna categoría aún tenga entradas, el valor sigue siendofalse, aunque algunas categorías ya estén completas.
Si todo está agotado, price_from queda vacío (null): un precio «desde» junto a «Agotado» invitaría a una compra que no existe. Un evento sin venta de entradas devuelve price_from: null y tickets_sold_out: false: no vende nada, así que tampoco puede estar agotado.
Si anulas una entrada, la plaza vuelve a quedar libre al instante: la categoría vuelve a poder comprarse y reaparece en el precio «desde». Como el feed se guarda en caché durante un breve tiempo, un evento que acaba de agotarse puede seguir apareciendo como disponible en tu web durante unos minutos.
¿Texto corto o descripción?
Muchas webs muestran sus eventos dos veces: como una tarjeta breve en un listado y de forma detallada en una página de detalle propia. Para el listado, la descripción completa suele ser demasiado larga. Para eso existe el Texto breve para la web:
- Abre el evento y haz clic en Editar evento.
- Justo debajo de la Descripción encontrarás el campo Texto breve para la web.
- Escribe una o dos frases (máximo 280 caracteres, sin formato) y guarda.
El feed entrega el texto corto como un campo propio, short_description, tanto en el listado como en la vista individual. La descripción no cambia y se entrega completa en el campo description. Qué texto muestra tu web y dónde lo decide la propia web: normalmente, el texto corto en el listado y la descripción en la página de detalle.
Si no rellenas ningún texto corto, short_description queda vacío (null). Univents nunca acorta la descripción automáticamente ni la usa como sustituto: de lo contrario, una frase cortada aparecería en tu web sin que lo hubieras pedido. Para los eventos sin texto corto, por tanto, el feed no cambia en nada.
Al copiar un evento y al crear una serie de fechas, el texto corto se copia igual que la descripción. En la importación desde Excel, la columna se llama Texto corto.
Imagen y descripción: las del evento, no las de la página de entradas
Para el calendario de la web cuentan la imagen y la descripción del propio evento, es decir, lo que gestionas en el evento bajo Apariencia. La imagen y la descripción de una página de reservas o de entradas pertenecen a esa página y no pasan automáticamente al calendario de la web. Ambas cosas son intencionadas: muchos negocios muestran a propósito un motivo distinto en la tienda de entradas y en el calendario de su propia web.
Si quieres que ambos coincidan, tienes que indicarlo una vez:
- Abre la página de reservas o de entradas y, en ella, la sección Detalles.
- Debajo de la imagen y la descripción encontrarás el aviso con el botón Aplicar también al calendario del sitio web.
- Confirma la pregunta. La imagen y la descripción de la página se transfieren entonces al evento vinculado; los datos que había allí hasta ese momento se sobrescriben.
El botón solo aparece si la página está vinculada a un evento (en las páginas de entradas siempre lo está). Se aplica el último estado guardado de la página, y los campos que están vacíos en la página se mantienen sin cambios en el evento, de modo que una página vacía nunca te borra una imagen. Hasta que el cambio llegue al calendario de la web pueden pasar unos minutos, porque el feed se guarda en caché durante un breve tiempo.
El tamaño con el que se muestra la imagen lo decide vuestra web: Univents entrega la imagen en su tamaño original.
Consultar el feed
El feed es público y se puede consultar sin iniciar sesión ni clave de API: una web o una herramienta externa puede cargarlo directamente con fetch:
GET https://univents.app/api/public/dein-workspace/events
GET https://univents.app/api/public/dein-workspace/events/{eventId}
dein-workspace es el slug de tu workspace, que también puedes ver en la barra de direcciones de tu navegador, detrás de /home/. Con los parámetros from y to acotas el periodo, y con limit el número de resultados (por defecto 50, máximo 100). limit se ajusta a tres niveles —25, 50 o 100— para que la caché se las arregle con pocas respuestas: un valor solicitado se redondea siempre al nivel inmediatamente superior; por ejemplo, ?limit=10 devuelve 25 entradas igual que ?limit=25, y todo lo que supere 100 se limita a 100. Sin ningún parámetro, el feed devuelve todos los eventos habilitados a partir de hoy.
Una respuesta de ejemplo tiene este aspecto:
{
"workspace": "dein-workspace",
"count": 2,
"events": [
{
"id": "…",
"title": "Sommerkonzert",
"description": "…",
"short_description": "Open Air im Hof, Eintritt frei",
"start": "2026-08-20T18:00:00Z",
"end": "2026-08-20T23:00:00Z",
"date_is_confirmed": true,
"venue": "Großer Saal",
"image_url": "https://…",
"tags": ["Konzert"],
"ticket_url": "https://univents.app/book/dein-workspace/deine-seite",
"price_from": 25,
"price_from_currency": "EUR",
"tickets_sold_out": false,
"updated_at": "2026-08-05T09:00:00Z"
}
]
}
Para desarrolladores y agencias
El feed está pensado a propósito para integrarse directamente en una web existente, sin tener que gestionar credenciales:
- Sin autenticación ni clave de API: la ruta es de acceso público, pero devuelve exclusivamente los eventos de ese workspace que tienen el interruptor activado.
- CORS está abierto: una consulta con
fetchfunciona directamente desde el navegador en cualquier web. - Con caché: las respuestas se pueden almacenar en caché durante un breve tiempo (unos minutos) para que las consultas frecuentes sigan siendo rápidas. Por eso, un evento recién habilitado no aparece al instante, sino en pocos minutos.
- Con límite de frecuencia: si se realizan muchísimas consultas en poco tiempo desde el mismo origen, la ruta responde con un error en lugar de con datos vacíos; para un uso normal de una web, esto no es relevante.
- Un slug de workspace desconocido devuelve un error, no una lista vacía, así notas enseguida si el slug es incorrecto.
Preguntas frecuentes
¿Veo en el feed también espacios que solo están ocupados pero no publicados? No. El feed muestra exclusivamente los eventos en los que has activado el interruptor Mostrar en la web, nunca la ocupación general de tus espacios.
¿Incluye el feed precios? Sí, uno: el precio de entrada más bajo que aún se puede comprar (price_from, bruto) junto con la moneda. La lista de precios completa sigue estando solo en la página de reservas a la que apunta ticket_url.
¿Por qué mi web muestra un precio más alto que ayer? Porque la categoría más barata ya se ha agotado. El feed indica siempre el precio más bajo que todavía se puede comprar, no el más bajo que haya existido alguna vez.
¿Por qué mi evento sin entradas no figura como «agotado»? Porque no vende entradas. tickets_sold_out solo es true cuando hay venta de entradas y ya no queda nada disponible.
¿Tengo que rellenar un texto corto? No. El texto corto es opcional. Sin él, el feed devuelve short_description: null y tu web muestra lo mismo que mostraba hasta ahora.
¿Se muestra también el texto corto en la página de reservas o de entradas? No. El texto corto está pensado solo para el feed de la web. No aparece ni en el presupuesto, ni en el Function Sheet, ni en la página de reservas, ni en el portal de clientes.
¿Tengo que habilitar cada evento por separado? Sí, de momento no existe una habilitación masiva. El interruptor está a propósito en cada evento por separado, para que tengas el control total sobre lo que es visible públicamente.
¿La función está vinculada a un plan concreto? Sí, al área de Eventos: está disponible a partir de la tarifa Core, y con ella también el interruptor Mostrar en la web. No necesitas nada más. El feed muestra únicamente lo que tú habilitas.
¿Me cuesta algo consultar el feed? No, el feed es un simple acceso de lectura a datos que ya has habilitado; no se generan costes aparte.