Afficher les événements sur votre propre site web (flux d’événements)

Vous pouvez activer des événements individuels pour un flux JSON public, sans clé, et alimenter ainsi le calendrier de votre propre site web depuis Univents, avec le prix « à partir de » et la mention Épuisé.

Vous souhaitez afficher vos événements en plus sur votre propre site web, dans votre propre design et non sous la forme d’une page Univents intégrée ? Dans ce cas, vous pouvez activer certains événements un par un. Univents les diffuse alors via un flux public en lecture seule, que votre site web (ou celui de votre agence) peut récupérer et afficher lui-même.

Afficher un événement sur le site web

L’activation se fait directement sur l’événement, et non à un endroit centralisé :

  1. Ouvrez l’événement souhaité.
  2. Dans l’en-tête de la vue détaillée, cliquez sur l’interrupteur Afficher sur le site web.
  3. Univents enregistre la modification immédiatement et la confirme par un bref message.

Lorsque l’interrupteur est activé, l’événement apparaît dans le flux en quelques minutes. Si vous le désactivez ou si vous supprimez l’événement, celui-ci disparaît tout aussi automatiquement du flux. L’interrupteur n’agit que sur cet événement : il n’existe pas d’activation groupée pour tous les événements à la fois.

L’assistant IA peut aussi activer l’interrupteur pour vous, par exemple avec « Affichez la fête d’été sur notre site web ». Il vous demande d’abord confirmation, car les informations deviennent ensuite accessibles publiquement. De même, avant de modifier le nom, le texte court ou la description d’un événement affiché sur votre site web, l’assistant vous montre une confirmation avec l’événement, sa date et le nouveau texte. Rien n’est enregistré avant votre confirmation.

Si un événement est activé mais n’a pas encore de texte court, la mention Il manque encore un texte court pour la vue liste s’affiche à côté de l’interrupteur. Cette mention ne bloque rien : l’événement apparaît quand même dans le flux.

Ce que contient le flux

Le flux ne fournit que des informations destinées à un affichage public dans un calendrier : titre, description, texte court pour la vue liste, heures de début et de fin, indication précisant si la date est déjà définitive, lieu, image de couverture, tags, lien vers la vente de billets (si l’événement dispose d’une page de billetterie mise en ligne ; en brouillon, le lien et le prix sont absents), ainsi que le prix de billet le plus bas encore disponible et une mention Épuisé. Les informations internes telles que le budget, le nombre d’invités, les notes, les coordonnées, le statut ou les données financières ne figurent jamais dans le flux, que l’événement soit public ou non. Les quotas, les noms de catégories et les chiffres de vente restent eux aussi en interne : seuls le prix et l’information « épuisé oui/non » sont transmis à l’extérieur.

Prix « à partir de » et Épuisé

Si vous vendez des billets via Univents, le flux fournit deux informations supplémentaires, à partir desquelles votre site web peut construire un « à partir de 25 € » et un « Épuisé » :

  • price_from : le prix de billet le plus bas qu’un visiteur peut encore acheter à l’instant T, en montant TTC (soit ce qui est indiqué dans la billetterie pour la catégorie). Si votre catégorie la moins chère est épuisée, la catégorie immédiatement plus chère prend automatiquement le relais. Ainsi, votre site web ne promet jamais un prix qui n’existe plus dans la boutique.
  • price_from_currency : la devise de votre Workspace sous forme de code, par exemple EUR ou CHF.
  • tickets_sold_out : true dès qu’aucune catégorie de billets n’est plus disponible à l’achat. Tant qu’une catégorie dispose encore de billets, la valeur reste false, même si certaines catégories sont déjà complètes.

Lorsque tout est épuisé, price_from est vide (null) : un prix « à partir de » à côté d’Épuisé inciterait à un achat impossible. Un événement sans vente de billets renvoie price_from: null et tickets_sold_out: false : il ne vend rien, il ne peut donc pas être épuisé.

Si vous annulez un billet, la place est immédiatement libérée : la catégorie redevient disponible à l’achat et réapparaît dans le prix « à partir de ». Comme le flux est brièvement mis en cache, un événement qui vient de passer à Épuisé peut encore apparaître comme disponible sur votre site web pendant quelques minutes.

Texte court ou description ?

De nombreux sites web affichent leurs événements deux fois : sous forme de courte carte dans une liste et de façon détaillée sur une page dédiée. Pour la liste, la description complète est souvent trop longue. C’est le rôle du Texte court pour votre site web :

  1. Ouvrez l’événement et cliquez sur Modifier l'événement.
  2. Juste sous la Description, vous trouverez le champ Texte court pour votre site web.
  3. Saisissez une ou deux phrases (280 caractères au maximum, sans mise en forme) et enregistrez.

Le flux fournit le texte court dans un champ distinct, short_description, aussi bien dans la liste que dans la vue individuelle. La description reste inchangée et figure intégralement dans le champ description. C’est à votre site web de décider quel texte afficher et où : en général, le texte court dans la liste et la description sur la page de détail.

Si vous ne renseignez pas de texte court, short_description est vide (null). Univents ne raccourcit jamais automatiquement la description et ne l’utilise pas non plus comme substitut : sinon, une phrase tronquée s’afficherait sur votre site web sans que vous l’ayez demandé. Pour les événements sans texte court, rien ne change donc dans le flux.

Lorsque vous copiez un événement ou créez une série de dates, le texte court est repris, tout comme la description. Dans l’import Excel, la colonne s’appelle Texte court.

Image et description : celles de l’événement, pas de la page de billetterie

Pour le calendrier du site web, ce sont l’image et la description de l’événement lui-même qui comptent, c’est-à-dire ce que vous renseignez dans l’événement sous Présentation. L’image et la description d’une page de réservation ou de billetterie appartiennent à cette page et ne sont pas reprises automatiquement dans le calendrier du site web. Les deux sont voulus : de nombreux établissements affichent volontairement dans la billetterie un visuel différent de celui du calendrier de leur propre site web.

Si vous souhaitez que les deux soient identiques, il suffit de le demander une fois :

  1. Ouvrez la page de réservation ou de billetterie, puis la section Détails.
  2. Sous l’image et la description, vous trouverez la mention ainsi que le bouton Appliquer aussi au calendrier du site web.
  3. Confirmez la demande de validation. L’image et la description de la page sont alors transférées vers l’événement lié ; les informations qui y étaient enregistrées jusqu’ici sont écrasées.

Le bouton n’apparaît que si la page est liée à un événement (c’est toujours le cas pour les pages de billetterie). C’est le dernier état enregistré de la page qui est repris, et les champs laissés vides sur la page restent inchangés sur l’événement : une page vide ne supprime donc jamais une image. Il peut s’écouler quelques minutes avant que la modification n’arrive dans le calendrier du site web, car le flux est brièvement mis en cache.

La taille d’affichage de l’image est déterminée par votre site web : Univents fournit l’image dans sa taille d’origine.

Récupérer le flux

Le flux est public et accessible sans connexion ni clé API : un site web ou un outil externe peut le charger directement via fetch :

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

dein-workspace est le slug de votre Workspace, que vous retrouvez aussi dans la barre d’adresse de votre navigateur, après /home/. Les paramètres from et to permettent de restreindre la période, et limit le nombre de résultats (50 par défaut, 100 au maximum). limit est réparti en trois paliers (25, 50 ou 100) afin que le cache se contente de peu de réponses : une valeur demandée est toujours arrondie au palier supérieur, par exemple ?limit=10 renvoie 25 entrées, tout comme ?limit=25, et toute valeur supérieure à 100 est plafonnée à 100. Sans indication, le flux renvoie tous les événements activés à partir d’aujourd’hui.

Voici un exemple de réponse :

{
  "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"
    }
  ]
}

Pour les développeurs et les agences

Le flux est volontairement conçu pour s’intégrer directement dans un site web existant, sans avoir à gérer d’identifiants :

  • Pas d’authentification, pas de clé API : la route est accessible publiquement, mais ne renvoie que les événements du Workspace concerné dont l’interrupteur est activé.
  • CORS est ouvert : un appel via fetch fonctionne directement depuis le navigateur de n’importe quel site web.
  • Mis en cache : les réponses peuvent être mises en cache brièvement (quelques minutes) afin que les appels fréquents restent rapides. Un événement tout juste activé n’apparaît donc pas immédiatement, mais en quelques minutes.
  • Limitation de débit : en cas d’appels très nombreux en peu de temps depuis la même source, la route répond par une erreur plutôt que par des données vides ; ce n’est pas pertinent pour une utilisation normale d’un site web.
  • Un slug de Workspace inconnu renvoie une erreur, et non une liste vide : vous voyez ainsi immédiatement si le slug est incorrect.

Questions fréquentes

Vois-je aussi dans le flux les lieux qui sont simplement occupés, mais non activés publiquement ? Non. Le flux n’affiche que les événements pour lesquels vous avez activé l’interrupteur Afficher sur le site web, et jamais le taux d’occupation général de vos lieux.

Le flux contient-il des prix ? Oui, un seul : le prix de billet le plus bas encore disponible (price_from, TTC) avec sa devise. La liste complète des prix figure toujours uniquement sur la page de réservation vers laquelle pointe ticket_url.

Pourquoi mon site web affiche-t-il un prix plus élevé qu’hier ? Parce que la catégorie la moins chère est entre-temps épuisée. Le flux indique toujours le prix le plus bas que l’on peut encore acheter, et non le plus bas qui ait jamais existé.

Pourquoi mon événement sans billets n’affiche-t-il pas « Épuisé » ? Parce qu’il ne vend pas de billets. tickets_sold_out ne vaut true que s’il existe une vente de billets et qu’il n’y reste plus rien à acheter.

Dois-je obligatoirement renseigner un texte court ? Non. Le texte court est facultatif. Sans lui, le flux renvoie short_description: null, et votre site web continue d’afficher ce qu’il affichait jusqu’ici.

Le texte court est-il aussi affiché sur la page de réservation ou de billetterie ? Non. Le texte court est uniquement destiné au flux du site web. Il n’apparaît ni dans le devis, ni dans le Function Sheet, ni sur la page de réservation, ni dans le portail client.

Dois-je activer chaque événement individuellement ? Oui, il n’existe actuellement pas d’activation groupée. L’interrupteur se trouve volontairement sur chaque événement, afin que vous gardiez un contrôle total sur ce qui est visible publiquement.

La fonction est-elle liée à une formule précise ? Oui, au domaine Événements : il est disponible à partir de la formule Core, et donc aussi l’interrupteur Afficher sur le site web. Vous n’avez besoin de rien d’autre. Le flux n’affiche que ce que vous activez vous-même.

L’appel du flux me coûte-t-il quelque chose ? Non, le flux est un simple accès en lecture à des données que vous avez déjà activées ; aucun coût distinct n’est facturé.

Newsletter Univents

Actualités produit et conseils pratiques pour les professionnels de l'événementiel et de la restauration. Environ une fois par mois, pas plus.

La newsletter est envoyée en anglais.

Thèmes