Mostrare gli eventi sul tuo sito web (feed eventi)

Vuoi mostrare i tuoi eventi anche sul tuo sito web, con il tuo design e non come pagina Univents incorporata? Allora puoi abilitare i singoli eventi. Univents li rende disponibili tramite un feed pubblico di sola lettura, che il tuo sito web (o quello della tua agenzia) può richiamare e visualizzare in autonomia.

Mostrare un evento sul sito web

L’abilitazione avviene direttamente sull’evento, non in un unico punto centrale:

1. Apri l’evento che ti interessa.
2. Nell’intestazione della vista di dettaglio, clicca sull’interruttore Mostra sul sito web.
3. Univents salva subito la modifica e conferma con un breve messaggio.

Quando l’interruttore è attivo, l’evento compare nel feed nel giro di pochi minuti. Se lo disattivi di nuovo o elimini l’evento, scompare dal feed altrettanto in automatico. L’interruttore agisce solo su quel singolo evento: non esiste un’abilitazione collettiva per tutti gli eventi in una volta.

Cosa c’è nel feed

Il feed fornisce esclusivamente dati pensati per la visualizzazione in un calendario pubblico: titolo, descrizione, orario di inizio e di fine, se la data è già definitiva, luogo dell’evento, immagine di copertina, tag, un link alla vendita dei biglietti (se l’evento ha una pagina biglietti attiva: in bozza mancano link e prezzo), nonché il prezzo più basso ancora disponibile e un’indicazione di Esaurito. Dati interni come budget, numero di ospiti, note, dati di contatto, stato o dati finanziari non compaiono mai nel feed, indipendentemente dal fatto che l’evento sia pubblico. Anche contingenti, nomi delle categorie e numeri di vendita restano all’interno: all’esterno vanno solo il prezzo e l’informazione «Esaurito sì/no».

Prezzo «da» ed Esaurito

Se vendi biglietti tramite Univents, il feed fornisce due dati aggiuntivi, con cui il tuo sito web può costruire un «da 25 €» e un «Esaurito»:

• price_from: il prezzo più basso di biglietto che un visitatore può ancora acquistare in questo momento, come importo lordo (cioè quello indicato sulla categoria nel negozio di biglietti). Se la categoria più economica è esaurita, subentra automaticamente quella immediatamente più cara. Così il sito web non promette mai un prezzo che nel negozio non esiste più.
• price_from_currency: la valuta del tuo workspace come codice, ad es. EUR o CHF.
• tickets_sold_out: true non appena nessuna categoria di biglietti è più acquistabile. Finché una qualsiasi categoria ha ancora biglietti, il valore resta false, anche se singole categorie sono già al completo.

Se tutto è esaurito, price_from è vuoto (null): un prezzo «da» accanto a «Esaurito» inviterebbe ad acquistare qualcosa che non c’è. Un evento senza vendita di biglietti restituisce price_from: null e tickets_sold_out: false: non vende nulla, quindi non può nemmeno essere esaurito.

Se annulli un biglietto, il posto torna subito libero: la categoria è di nuovo acquistabile e ricompare nel prezzo «da». Poiché il feed viene memorizzato brevemente nella cache, un evento appena esaurito può comparire ancora come disponibile sul tuo sito web per qualche minuto.

Immagine e descrizione: evento, non pagina biglietti

Per il calendario del sito web contano immagine e descrizione dell’evento stesso, cioè ciò che gestisci nell’evento sotto Aspetto. Immagine e descrizione di una pagina di prenotazione o dei biglietti appartengono a quella pagina e non passano automaticamente al calendario del sito web. È voluto: molte attività mostrano di proposito nel negozio di biglietti un’immagine diversa da quella del calendario del proprio sito web.

Se vuoi che siano uguali, devi dirlo una volta:

1. Apri la pagina di prenotazione o dei biglietti e lì la sezione Dettagli.
2. Sotto immagine e descrizione trovi l’avviso con il pulsante Applica anche al calendario del sito web.
3. Conferma la richiesta. Immagine e descrizione della pagina vengono allora trasferite all’evento collegato; i dati finora presenti nell’evento vengono sovrascritti.

Il pulsante compare solo se la pagina è collegata a un evento (per le pagine dei biglietti è sempre così). Viene applicata l’ultima versione salvata della pagina, e i campi vuoti nella pagina restano invariati nell’evento: una pagina vuota non ti cancella quindi mai un’immagine. Prima che la modifica arrivi nel calendario del sito web possono passare alcuni minuti, perché il feed viene memorizzato brevemente nella cache.

La dimensione con cui appare l’immagine la decide il tuo sito web: Univents fornisce l’immagine nelle dimensioni originali.

Richiamare il feed

Il feed è pubblico e richiamabile senza login né chiave API: un sito web o uno strumento esterno può caricarlo direttamente con fetch:

GET https://univents.app/api/public/dein-workspace/events
GET https://univents.app/api/public/dein-workspace/events/{eventId}

dein-workspace è lo slug del tuo workspace, che trovi anche nella barra degli indirizzi del browser dopo /home/. Con i parametri from e to restringi il periodo, con limit il numero di risultati (predefinito 50, massimo 100). limit è suddiviso in tre livelli (25, 50 o 100) in modo che la cache gestisca poche risposte: un valore richiesto viene sempre arrotondato per eccesso al livello successivo, ad es. ?limit=10 restituisce 25 voci esattamente come ?limit=25, e tutto ciò che supera 100 viene limitato a 100. Senza indicazioni, il feed restituisce tutti gli eventi abilitati da oggi in poi.

Un esempio di risposta è questo:

{
  "workspace": "dein-workspace",
  "count": 2,
  "events": [
    {
      "id": "…",
      "title": "Sommerkonzert",
      "description": "…",
      "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"
    }
  ]
}

Per sviluppatori e agenzie

Il feed è costruito apposta per integrarsi direttamente in un sito web esistente, senza dover gestire credenziali:

• Nessuna autenticazione, nessuna chiave API: la route è raggiungibile pubblicamente, ma restituisce esclusivamente gli eventi del rispettivo workspace con l’interruttore attivato.
• CORS è aperto: una chiamata con fetch funziona direttamente dal browser di qualsiasi sito web.
• Memorizzato in cache: le risposte possono essere messe in cache per poco tempo (pochi minuti) per mantenere veloci i richiami frequenti. Un evento appena abilitato quindi non compare subito, ma entro pochi minuti.
• Con limite di richieste: in caso di moltissimi richiami in poco tempo dalla stessa fonte, la route risponde con un errore invece che con dati vuoti; per il normale utilizzo di un sito web non è rilevante.
• Uno slug di workspace sconosciuto restituisce un errore, non un elenco vuoto: così capisci subito se lo slug è sbagliato.

Domande frequenti

Nel feed vedo anche location che sono solo occupate ma non rese pubbliche? No. Il feed mostra esclusivamente gli eventi per i quali hai attivato l’interruttore Mostra sul sito web, mai l’occupazione generale delle tue location.

Il feed contiene prezzi? Sì, uno: il prezzo più basso di biglietto ancora disponibile (price_from, lordo) insieme alla valuta. L’elenco prezzi completo si trova ancora solo sulla pagina di prenotazione a cui punta ticket_url.

Perché il mio sito web mostra un prezzo più alto di ieri? Perché la categoria più economica nel frattempo è esaurita. Il feed indica sempre il prezzo più basso che si può ancora acquistare, non il più basso che sia mai esistito.

Perché per il mio evento senza biglietti non compare «Esaurito»? Perché non vende biglietti. tickets_sold_out è true solo se esiste una vendita di biglietti e lì non c’è più nulla di disponibile.

Devo abilitare ogni evento singolarmente? Sì, al momento non esiste un’abilitazione collettiva. L’interruttore si trova di proposito su ogni singolo evento, così hai il pieno controllo su ciò che è visibile pubblicamente.

La funzione è legata a un piano specifico? Il feed mostra esclusivamente ciò che abiliti tu: non ci sono requisiti aggiuntivi oltre alla normale autorizzazione sugli eventi.

Richiamare il feed mi costa qualcosa? No, il feed è un semplice accesso in sola lettura a dati che hai già abilitato: non ci sono costi separati.