L’inscription aux événements en headless, c’est quand les écrans de réservation vivent dans une app qui appartient à la marque, pendant qu’une plateforme événementielle gère en coulisses l’inscription, les jauges et le check-in via une API et des webhooks. L’invité ne quitte jamais l’app de la marque.

Au Japon, cette app est souvent une LINE MINI App. Une marque veut que ses invités réservent un créneau sans quitter LINE, avec les écrans et la langue de la marque. Il faut pourtant que quelqu’un tienne les places, inscrive les invités et gère leur check-in à l’entrée, et c’est cette partie que prend en charge Eventtia.

Cartier gère ses réservations d’événements au Japon avec une LINE MINI App qui s’appuie sur Eventtia. Cet article décrit l’architecture qui se cache derrière ce type d’intégration, pour les équipes qui veulent intégrer la réservation d’événements dans une app qui leur appartient, LINE ou une autre. Pour la vue projet (qui construit quoi, étapes et FAQ), consulte notre guide d’intégration LINE.

L’architecture en un coup d’œil

Brique Responsable Ce qu’elle fait
LINE MINI App La marque ou son agence Pages d’événement, créneaux, formulaires de réservation et d’accompagnants, confirmation et QR code
Backend opéré par la marque La marque ou son agence Vérifie l’utilisateur LINE, le relie à ses réservations, appelle l’API Eventtia, met des données en cache pour l’affichage et reçoit les webhooks
Eventtia Eventtia, configuré par l’équipe événementielle de la marque Événements, sessions, jauges, inscriptions, accompagnants et check-in

Trois règles portent l’essentiel de la conception :

  • Le backend met en cache pour afficher, et c’est Eventtia qui décide de la jauge.
  • Une place n’est confirmée que lorsqu’Eventtia accepte la réservation de la session.
  • Les webhooks réduisent les interrogations, mais le backend réconcilie toujours sa copie.

Qui construit quoi dans une intégration LINE MINI App ?

La LINE MINI App, c’est l’expérience de l’invité : pages d’événement, créneaux, formulaires de réservation et d’accompagnants, confirmation et QR code. La marque ou son agence la conçoit et la construit.

Le backend opéré par la marque se place entre la MINI App et Eventtia. Il vérifie l’utilisateur LINE, le relie à ses réservations, appelle l’API Eventtia, met en cache ce dont les écrans ont besoin et reçoit nos webhooks. Le jeton Eventtia reste là, jamais dans la MINI App. Ce n’est pas un simple relais : c’est là que se fait l’essentiel du travail d’intégration.

Eventtia garde l’état qui ne doit pas se tromper : événements, sessions, jauges, inscriptions et check-in. L’équipe événementielle de la marque configure les événements, les sessions et les jauges dans le back-office Eventtia, comme pour n’importe quel autre événement par créneaux.

Comment l’API de réservation protège-t-elle les jauges ?

Un lancement, c’est surtout de la lecture. Beaucoup d’invités ouvrent la page de l’événement dans les mêmes quelques minutes, regardent les créneaux, hésitent et reviennent. Si chaque affichage d’écran devient un appel à l’API, le backend atteint vite la limite.

Notre limite standard est de 100 appels à l’API par minute. Pour les projets enterprise, nous pouvons la relever pour les adresses des serveurs de l’intégrateur, et pendant les pics Eventtia met les requêtes en file d’attente puis les traite progressivement.

Le backend garde donc une copie des événements et des disponibilités des sessions, et sert les écrans à partir de cette copie. Le niveau de fraîcheur nécessaire dépend du projet et du lancement, et c’est l’équipe qui choisit sa politique de rafraîchissement. Quelle qu’elle soit, la disponibilité affichée à l’écran reste provisoire.

La réservation est une écriture, et elle part du backend vers Eventtia. Créer le participant et réserver la session sont deux opérations distinctes dans l’API Eventtia. Eventtia valide la jauge au moment où il traite la réservation de la session, et l’app ne confirme la place que lorsque cette réservation aboutit. Quand une session est complète, l’app doit l’afficher clairement.

Interrogation périodique ou webhooks : comment le backend reste-t-il à jour ?

Le moyen le plus simple de tenir à jour la copie du backend, c’est d’interroger périodiquement les données des sessions. Ça marche et c’est facile à déboguer, mais ça consomme des appels à l’API et la copie a toujours un léger retard.

Les webhooks réduisent ce travail. Eventtia prévient le backend quand un événement est mis à jour, quand une session d’activité est créée, mise à jour ou supprimée, et quand un participant est créé ou mis à jour, y compris son statut de check-in. Les webhooks se configurent par événement dans le back-office, ou une seule fois pour tout le compte via l’API (référence des webhooks de compte).

Les webhooks sont des notifications et ne remplacent pas toutes les lectures : le backend a toujours besoin d’un moyen de réconcilier sa copie avec Eventtia, par exemple après une panne.

Les accompagnants occupent-ils une place ?

Oui. Les invités viennent souvent avec quelqu’un. Dans Eventtia, chaque accompagnant est un participant lié et occupe une place dans la session, selon la même règle que toute inscription. L’app peut recueillir plus tard les informations de l’accompagnant, par exemple grâce à un lien que partage l’invité principal, et les envoyer avec les endpoints de mise à jour.

Traiter les accompagnants comme de vrais participants garde des jauges justes, et permet en plus un check-in personne par personne.

Comment le check-in remonte-t-il au backend de la marque ?

À l’entrée, l’équipe scanne le QR code de l’invité avec l’app de check-in Eventtia. Le scan met à jour le participant, et Eventtia remonte le nouveau statut de check-in via le webhook de participant mis à jour. Le backend de la marque sait alors qui est venu.

La suite, c’est la marque qui la décide : un message de remerciement sur LINE, une note dans le CRM, ou rien.

Données d’inscription au Japon

Une partie du travail concret d’une intégration au Japon tient à de petites règles de données. Les adresses des opérateurs mobiles, comme docomo.ne.jp, ezweb.ne.jp et i.softbank.jp, passent la validation. L’API renvoie le format de date configuré pour chaque événement, pour que la MINI App affiche les dates de la même façon, et les numéros de téléphone sont validés par pays avec libphonenumber, la bibliothèque de Google.

Quelles versions de l’API utiliser ?

Les versions 3 et 4 de l’API sont disponibles en parallèle. Les anciennes versions restent actives, chaque nouvelle version ajoute des capacités, et une intégration peut utiliser l’une ou l’autre.

Ce qu’il faut régler avant la mise en production

Quelques décisions méritent d’être prises avec nous avant le premier lancement, parce que c’est là qu’un parcours de réservation casse sous la charge :

  • Issue de la réservation. Ce que l’app affiche pendant la réservation, après un timeout, et quand le résultat est inconnu.
  • Envois répétés. Comment le backend gère un invité qui appuie deux fois, ou qui réessaie après un timeout, sans créer une deuxième réservation.
  • Traitement des webhooks. Comment le backend vérifie les webhooks reçus, gère les nouvelles tentatives et les doublons, et traite les notifications qui arrivent dans le désordre.
  • Réconciliation. Comment et quand le backend compare sa copie avec Eventtia, pour qu’une notification manquée ne laisse pas un mauvais compteur à l’écran.

Le détail des endpoints se trouve dans la référence de l’API Eventtia.

Les assistants IA peuvent-ils utiliser les mêmes briques ?

Oui. Quand l’inscription est un ensemble de briques derrière une API, l’interface au-dessus peut changer. Une LINE MINI App en est une. L’app propre d’une marque en est une autre. Un assistant IA en est une troisième.

Le serveur MCP d’Eventtia (Model Context Protocol) permet à un assistant de consulter les événements, de consulter la disponibilité des sessions, d’inscrire un invité et de consulter les check-ins. Son accès suit les permissions de l’utilisateur connecté dans Eventtia, ce qui est un schéma différent du jeton machine à machine qu’utilise un backend.

FAQ

Qu’est-ce que l’inscription aux événements en headless ?

L’inscription en headless, c’est quand les écrans de réservation que voit l’invité vivent dans une app qui appartient à la marque, comme une LINE MINI App, pendant qu’une plateforme événementielle gère en coulisses l’inscription, les jauges et le check-in via une API et des webhooks. L’invité ne quitte jamais l’app de la marque.

Une LINE MINI App peut-elle utiliser Eventtia pour les inscriptions ?

Oui. La marque ou son agence construit la LINE MINI App et un backend qui appelle l’API REST Eventtia et reçoit ses webhooks, et Eventtia garde les événements, les sessions, les jauges, les inscriptions et le check-in. Cartier gère ses réservations d’événements au Japon avec une LINE MINI App qui s’appuie sur Eventtia.

Qui décide de la jauge dans un parcours de réservation headless ?

Eventtia. Le backend de la marque peut mettre en cache les données d’événements et de sessions pour l’affichage, mais Eventtia valide la jauge au moment où il traite la réservation de la session, et l’app ne confirme la place que lorsque cette réservation aboutit.

Quelles sont les limites de l’API Eventtia pour un lancement ?

La limite standard est de 100 appels à l’API par minute. Pour les projets enterprise, Eventtia peut la relever pour les adresses des serveurs de l’intégrateur, et pendant les pics il met les requêtes en file d’attente puis les traite progressivement.

Les accompagnants comptent-ils dans la jauge de la session ?

Oui. Dans Eventtia, chaque accompagnant est un participant lié et occupe une place dans la session, selon la même règle que toute inscription, et l’app peut recueillir ses informations plus tard.

Le backend doit-il interroger Eventtia ou utiliser les webhooks ?

Les deux ont leur place. Les webhooks préviennent le backend quand les événements, les sessions et les participants changent, y compris le statut de check-in, ce qui réduit les interrogations ; le backend a quand même besoin d’un moyen périodique de réconcilier sa copie avec Eventtia, par exemple après une panne.

Si tu prépares la réservation d’événements dans LINE ou dans ta propre app, notre guide d’intégration LINE explique qui construit quoi, les briques de l’API et les étapes d’implémentation.