Intégration des infos de billetteries

Un ajout de champs est en cours de déploiement sur le modèle d'événements d'OpenAgenda : les offres. Les informations de billetterie, jusqu'ici réservées à l'API, sont désormais visibles sur les pages agendas de la plateforme.

Passer d'une information textuelle à des données de billetterie

Jusqu'ici, les tarifs et conditions d'un événement sont saisis en toutes lettres dans le formulaire événement, un champ « Outils d'inscription » venant compléter l'information pour permettre à un visiteur d'arriver au terme de son parcours.

Cette donnée est lisible par un humain, mais les sites et applications qui republient les événements ne savent pas l'exploiter. Par exemple, il leur est impossible :

• d'afficher automatiquement « à partir de 18 € » sur une fiche,
• de filtrer les événements encore réservables,
• d'indiquer la prochaine date disponible.

De nouveaux champs dédiés aux offres réservables permettent de structurer ces informations (prix, monnaie, billetterie, période de vente, disponibilité par séance) pour qu'elles soient enfin réutilisables partout, sans ressaisie. Et lorsqu'un agenda est relié à un logiciel de billetterie (Billetweb, Mapado, Eventbrite…), ces données se remplissent automatiquement : l'organisateur n'a rien à refaire, et le public dispose d'une information fiable et à jour.

Ce que voit le public sur openagenda.com

Jusqu'ici, les tarifs et les disponibilités n'existaient que dans l'API : un visiteur ne pouvait pas savoir si une date était encore réservable, ni ce qu'elle coûtait. C'est désormais visible directement sur le site.

Sur la page événement

• Dans le tableau des dates, regroupées par mois, chaque date affiche son statut en texte coloré, suivi d'un chevron (par exemple « Complet › »). Il s'affiche sur la ligne d'horaire existante : il n'y a pas de seconde liste de dates.
• Sous le statut, en gris, apparaît la limite de la fenêtre de vente lorsqu'elle existe (par exemple « dès le 20 oct. » ou « jusqu'au 8 nov. »).

• Toute la ligne est cliquable : elle ouvre une fenêtre qui détaille chaque billetterie, son statut, sa fenêtre de vente complète et l'ancienneté de la dernière lecture des informations.

Sur les vignettes d'événements d'un agenda

Une troisième ligne d'informations s'ajoute sous la date et le lieu, pour répondre aux questions : quand, où, combien.

• « Gratuit »,
• « à partir de 18 € » lorsqu'il existe plusieurs tarifs,
• « 25 € » lorsqu'il n'y a qu'un seul tarif,
• accompagné d'une pastille indiquant la disponibilité de l'événement.

Et si l'événement n'a pas de billetterie ?

Rien ne change : aucune information de billetterie ni de tarif n'est affichée, et la page de l'événement comme sa carte restent identiques.

Une info de meilleure qualité indiquée par les organisateurs pour les relais d'information

En premier lieu, les organisateurs qui gèrent des outils de billetterie. Puis les diffuseurs qui en relaient les programmations. La mise en place est progressive et sera configurable agenda par agenda : beaucoup d'événements ne demandent pas d'inscription, d'autres se satisfont d'un courriel ou d'un échange téléphonique.

Mise en place progressive

Ce changement ne remplace pas les champs « Outils d'inscription » et « Conditions », qui restent suffisants dans beaucoup de cas et sont largement utilisés sur les sites relayant des événements de programmations gérées sur OpenAgenda. Une saisie plus détaillée des champs décrivant l'offre pourra par contre proposer une complétion automatique de ces champs, qui resteront ré-éditables à part entière.

Ces données de billetterie suivent la norme Schema.org et lèvent un obstacle à l'interopérabilité des données entre les logiciels métier.

Pour l'instant, ces champs ne sont pas visibles dans les formulaires OpenAgenda : ils servent à relayer les informations en provenance d'outils de billetterie connectés à des OpenAgenda.

Une période d'expérimentation permettra au modèle retenu de se stabiliser au fil des nouvelles connexions et des retours des utilisateurs. Nous finirons par ajouter des configurations qui permettront à chaque agenda d'ajuster le formulaire au fonctionnement le plus adapté.

Où en est-on ?

Les premières connexions entre quelques billetteries et OpenAgenda sont en place. Les événements synchronisés affichent :

• un nouveau champ « offers » dans l'API,
• les informations de billetterie sur les pages événement et les cartes d'événements d'openagenda.com, comme décrit plus haut.

Le détail de la structure des nouveaux champs est indiqué dans notre documentation dédiée à l'API.

En parallèle, nous souhaitons avoir de premiers retours sur le format de donnée proposé pour ce champ, ainsi que vos questions ou remarques, qui nous aideront à en ajuster le format et à compléter une FAQ en dernière section de cet article.

Pour toute question, c'est par ici !

Mis à jour le : 26/10/2026