Données d’événements avec Eventfrog : intégration, import et connexions API

Que vous souhaitiez afficher un calendrier d’événements sur votre propre site web importer des données dans un système existant ou créer des événements directement via une interface Eventfrog propose plusieurs façons d’utiliser les données d’événements. Le choix dépend de votre objectif, de votre environnement technique et du niveau d’automatisation souhaité.

Aperçu :

Quelle solution vous convient ?

  • Afficher des événements sur votre site web sans programmer : iFrame
  • Reprendre des événements publics d’Eventfrog dans votre site web, votre application ou votre plateforme d’événements, y compris ceux d’autres organisateurs : Public API
  • Transférer les ventes de billets, les check-in et les versements de vos événements vers un CRM, un outil BI ou un logiciel comptable : Organizer API avec droit de lecture
  • Saisir des événements dans votre propre système et les créer automatiquement sur Eventfrog : Organizer API avec droits de lecture et d’écriture

Vous pouvez combiner les solutions, par exemple créer des événements via l’Organizer API et les afficher sur votre site web avec l’iFrame. Vous configurez l’iFrame vous-même dans le cockpit. Pour les deux API, il vous faut des connaissances en programmation ou une personne qui réalise l’intégration pour vous.

iFrame : un calendrier d’événements sur votre site web

Dans le cockpit, vous trouvez Propre calendrier dans la navigation principale. Vous y créez un code que vous insérez dans le code HTML de votre site web. Un calendrier d’événements apparaît ensuite sur votre site web.

  • Par défaut, le calendrier affiche vos événements publiés. Vous pouvez en ajouter d’autres, par exemple des événements d’autres organisateurs, de certaines catégories ou de certains lieux, et définir une période.
  • Vous adaptez la couleur d’accent à votre site web.
  • Si vous le souhaitez, vous intégrez aussi un formulaire qui permet aux visiteurs de votre site web de saisir leurs propres événements. Il leur faut pour cela un compte Eventfrog.

Indiquez l’adresse de votre site web sous Votre domaine, sinon l’intégration ne fonctionne pas. Vous n’avez pas besoin de clé API.

Comment intégrer le calendrier d’événements

Public API : récupérer des données d’événements publiques

La Public API fournit tous les événements publics sur Eventfrog, ainsi que les groupes d’événements, les catégories et les lieux. Vous pouvez filtrer par exemple par organisateur, lieu, catégorie, pays, rayon ou période. Elle ne permet pas de créer ni de modifier des événements.

Utilisations typiques :

  • vos propres listes d’événements avec votre propre mise en page et vos propres filtres
  • applications, écrans ou newsletters avec des événements à jour
  • plateformes d’événements régionales ou thématiques

Il vous faut une clé API du type Public API: Read. Tous les détails figurent dans la spécification de la Public API.

Organizer API : lire les données de vos événements et créer des événements

L’Organizer API couvre les événements que vous avez créés, dans le cockpit ou via une clé API de votre compte. Selon la clé API, vous pouvez seulement lire ou aussi écrire.

Lecture seule

Avec une clé API du type Organizer API: Read, vous lisez les données de vos événements :

  • événements, groupes d’événements et catégories de billets
  • ventes de billets avec les coordonnées des acheteurs de billets et leurs réponses aux champs de personnalisation
  • check-in, places assises et entrées
  • versements

Vous pouvez ainsi transférer par exemple des données clients vers un CRM, des chiffres de ventes et de check-in vers un outil BI, des versements vers votre comptabilité ou des commandes de repas issues de champs de personnalisation vers un système de restauration.

Lecture et écriture

Avec une clé API du type Organizer API: Read/Write/Delete, vous pouvez en plus créer, modifier, copier et supprimer des événements et des groupes d’événements. Vous saisissez ainsi vos événements une seule fois dans votre propre système, par exemple dans le CMS de votre salle ou dans votre planification de tournée. Si des dates changent, la modification est transmise automatiquement.

Comment un événement passe de votre système à Eventfrog :

  1. Votre système crée l’événement via l’API. Il s’agit d’un Brouillon, pas encore visible publiquement.
  2. Si vous vendez des billets, configurez les catégories de billets et la vente de billets dans le cockpit. Ce n’est pas possible via l’API.
  3. Publiez l’événement dans le cockpit avec Publier.

Tous les détails figurent dans la spécification de l’Organizer API.

Comment obtenir une clé API

Vous gérez vos clés API sous Réglages › Clés API. Cliquez sur Créer une clé API et choisissez le type dont votre solution a besoin. Pour les clés Organizer, vous confirmez la création par une étape supplémentaire.

Ne transmettez une clé API qu’aux personnes qui réalisent votre intégration. Une clé du type Organizer API: Read/Write/Delete permet de modifier et de supprimer vos événements. Si vous n’avez plus besoin d’une clé, par exemple après un changement d’agence, désactivez-la dans la liste avec Désactiver la clé API. C’est irréversible.

Comment créer et gérer des clés API

Questions fréquentes

Puis-je publier des événements via l’Organizer API ?

Non. Avec le droit d’écriture, vous pouvez créer et modifier des événements, mais pas les publier via l’API. Les événements nouvellement créés sont toujours un Brouillon et ne sont donc pas encore visibles publiquement. Publiez-les ensuite dans le cockpit, dans l’événement concerné, avec Publier.

Est-ce que je vois aussi les événements d’autres organisateurs avec l’Organizer API ?

Non. L’Organizer API n’affiche que les événements que vous avez créés. Vous récupérez les événements publics d’autres organisateurs avec la Public API.