Mostrare gli eventi sul proprio sito web (feed eventi)

Puoi rendere disponibili singoli eventi in un feed JSON pubblico e senza chiave e alimentare così il calendario del tuo sito web direttamente da Univents, incluso il prezzo «da» e l’indicazione di esaurito.

Se vuoi mostrare i tuoi eventi anche sul tuo sito web, con il tuo design e non come pagina Univents incorporata, puoi abilitare singoli eventi a questo scopo. Univents li rende poi disponibili tramite un feed pubblico in 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 desiderato.
  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 entro pochi minuti. Se lo disattivi di nuovo o elimini l’evento, sparisce dal feed altrettanto automaticamente. L’interruttore agisce solo su quel singolo evento: non esiste un’abilitazione collettiva per tutti gli eventi in una volta sola.

L’interruttore può essere impostato per te anche dall’assistente IA, ad esempio con «Mostra la festa d’estate sul nostro sito web». Prima ti chiede conferma, perché da quel momento i dati sono consultabili pubblicamente. Anche prima di modificare il nome, il testo breve o la descrizione di un evento che compare sul tuo sito web, l’assistente ti mostra una conferma con l’evento, la data e il nuovo testo. Non viene salvato nulla finché non confermi.

Se un evento è abilitato ma non ha ancora un testo breve, accanto all’interruttore compare l’avviso Manca ancora un testo breve per la vista elenco. L’avviso non blocca nulla: l’evento compare comunque nel feed.

Cosa contiene il feed

Il feed fornisce esclusivamente dati pensati per la visualizzazione in un calendario pubblico: titolo, descrizione, testo breve per la vista elenco, orario di inizio e di fine, se la data è già definitiva, location, immagine di copertina, tag, un link alla vendita dei biglietti (se l’evento ha una pagina biglietti attiva: in bozza mancano link ai biglietti e prezzo), oltre al prezzo del biglietto più basso ancora disponibile e a 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 interni: 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 del biglietto più basso che un visitatore può ancora acquistare, come importo lordo (cioè quello indicato per la categoria nel negozio di biglietti). Se la tua categoria più economica è esaurita, subentra automaticamente quella immediatamente più cara. In questo modo 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 a un acquisto che non esiste. 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 storni un biglietto, il posto torna subito libero: la categoria è di nuovo acquistabile e ricompare nel prezzo «da». Poiché il feed viene memorizzato brevemente in cache, un evento appena esaurito può apparire ancora disponibile sul tuo sito web per qualche minuto.

Testo breve o descrizione?

Molti siti web mostrano i propri eventi due volte: come breve scheda in un elenco e in forma completa su una pagina di dettaglio dedicata. Per l’elenco la descrizione completa è spesso troppo lunga. Per questo esiste il Testo breve per il sito web:

  1. Apri l’evento e clicca su Modifica evento.
  2. Subito sotto la Descrizione trovi il campo Testo breve per il sito web.
  3. Inserisci una o due frasi (al massimo 280 caratteri, senza formattazione) e salva.

Il feed fornisce il testo breve come campo a sé, short_description, sia nell’elenco sia nella vista singola. La descrizione resta invariata e compare per intero nel campo description. Quale testo mostrare e dove lo decide il sito web: di solito il testo breve nell’elenco e la descrizione nella pagina di dettaglio.

Se non inserisci un testo breve, short_description è vuoto (null). Univents non accorcia mai automaticamente la descrizione e non la usa nemmeno come sostituto: altrimenti una frase troncata finirebbe sul tuo sito web senza che tu l’abbia chiesto. Per gli eventi senza testo breve, quindi, nel feed non cambia nulla.

Quando copi un evento e quando crei una serie di date, il testo breve viene copiato insieme al resto, esattamente come la descrizione. Nell’importazione Excel la colonna si chiama Testo breve.

Immagine e descrizione: dell’evento, non della 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 di una pagina biglietti appartengono a quella pagina e non passano automaticamente nel calendario del sito web. Entrambe le cose sono volute: molte attività mostrano di proposito nel negozio di biglietti un’immagine diversa da quella del calendario del proprio sito web.

Se vuoi che coincidano, devi dirlo una volta:

  1. Apri la pagina di prenotazione o la pagina 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 nell’evento collegato; i dati finora presenti lì vengono sovrascritti.

Il pulsante compare solo se la pagina è collegata a un evento (per le pagine biglietti è sempre così). Viene applicata l’ultima versione salvata della pagina, e i campi vuoti sulla 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 in cache.

Quanto appaia grande l’immagine lo decide il vostro 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 l’intervallo di tempo, con limit il numero di risultati (predefinito 50, massimo 100). limit è suddiviso in tre livelli — 25, 50 o 100 — in modo che la cache si accontenti di poche risposte: un valore richiesto viene sempre arrotondato al livello superiore, ad es. ?limit=10 restituisce 25 voci proprio 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": "…",
      "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"
    }
  ]
}

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 fornisce esclusivamente gli eventi del rispettivo workspace per cui l’interruttore è attivo.
  • CORS è aperto: una chiamata con fetch funziona direttamente dal browser di qualsiasi sito web.
  • In cache — le risposte possono essere memorizzate in cache per poco tempo (pochi minuti), così le chiamate frequenti restano veloci. Un evento appena abilitato quindi non compare subito, ma entro pochi minuti.
  • Con limite di frequenza — se la stessa fonte effettua moltissime chiamate in poco tempo, 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ì ti accorgi subito se lo slug è sbagliato.

Domande frequenti

Nel feed vedo anche le 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 del biglietto più basso ancora disponibile (price_from, lordo) con la relativa valuta. Il listino completo resta visibile solo sulla pagina di prenotazione a cui punta ticket_url.

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

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

Devo inserire un testo breve? No. Il testo breve è facoltativo. Senza di esso il feed restituisce short_description: null e il tuo sito web mostra ciò che mostrava finora.

Il testo breve viene mostrato anche sulla pagina di prenotazione o sulla pagina biglietti? No. Il testo breve è pensato solo per il feed del sito web. Non compare né nel preventivo né nel Function Sheet, né sulla pagina di prenotazione o nel portale clienti.

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

La funzione è legata a un piano specifico? Sì, all’area Eventi: è disponibile dal piano Core, e con essa anche l’interruttore Mostra sul sito web. Oltre a questo non ti serve nient’altro. Il feed mostra esclusivamente ciò che abiliti tu.

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

Newsletter di Univents

Novità di prodotto e consigli pratici per attività di eventi e catering. Circa una volta al mese, non di più.

La newsletter viene inviata in inglese.

Temi