klf
Retour à l'aide
Guide pro

Import automatique d'événements — RSS, iCal, API, CSV

Connectez votre agenda existant à klf pour synchroniser vos événements sans ressaisie. 4 méthodes selon votre outil.

Pourquoi connecter votre agenda ?

Si vous publiez déjà vos événements ailleurs (site web, Facebook, billetterie, Google Agenda…), la ressaisie est un gâchis : double travail, risque d'oubli, incohérences entre plateformes.

L'idéal : votre système reste la source de vérité. klf se synchronise automatiquement.

Les 4 méthodes d'import (par ordre de préférence)

1. Flux RSS / Atom 🟢 (recommandé)

Qui a ça nativement ? WordPress, la plupart des CMS, Webflow, Substack, de nombreux sites de billetterie. Si votre site publie des actus ou événements, il y a probablement un flux RSS.

Comment ça marche :

  1. Vous nous donnez l'URL de votre flux (ex : https://votre-site.re/events/feed.xml).
  2. klf interroge ce flux toutes les 6 heures.
  3. Chaque nouvel item est créé comme événement klf en statut « brouillon », que vous validez en 1 clic (ou auto-publié si vous activez la confiance).

Limites : RSS contient rarement toutes les infos structurées (date de début, prix, lieu). Le parseur klf tente d'extraire au mieux, vous corrigez ce qui manque.

2. Fichier iCal (.ics) 🟢 (le plus propre)

iCal est le format standard calendaire. Google Agenda, Apple Calendar, Outlook, Evenbrite, Weezevent, la plupart des billetteries exportent en iCal.

Comment ça marche :

  1. Vous exportez ou partagez l'URL iCal de votre agenda public (ex : webcal://calendar.google.com/.../public/basic.ics).
  2. klf parse les blocs VEVENT toutes les 6 heures.
  3. Tous les champs standard sont récupérés : titre (SUMMARY), début/fin (DTSTART/DTEND), lieu (LOCATION), description (DESCRIPTION), URL.

C'est le format le plus fiable parce qu'il est strictement typé (dates correctement parsées, timezone gérée).

3. API JSON / REST 🟡 (pour les pros techniques)

Si vous disposez d'une API sur votre système (WordPress WP-JSON, billetterie, ERP, etc.), vous pouvez fournir un endpoint JSON public retournant vos événements.

Format attendu (exemple) :

GET https://votre-site.re/api/events

[
  {
    "external_id": "evt-1234",
    "title": "Sakifo Festival — Jour 1",
    "start_at": "2026-06-07T19:30:00+04:00",
    "end_at": "2026-06-08T02:00:00+04:00",
    "venue_name": "Port de Saint-Pierre",
    "commune": "Saint-Pierre",
    "price_label": "35-55 €",
    "ticket_url": "https://billetterie.sakifo.com",
    "description": "...",
    "cover_url": "https://...jpg",
    "category": "culture"
  }
]

klf mappe category vers nos 7 catégories (culture, sport, loisirs, patrimoine, fêtes, nuit, compétitions). Les événements sont identifiés par external_id pour éviter les doublons.

4. Import CSV manuel 🟠 (pour les grosses bascules)

Si vous avez un tableur (Excel, Google Sheets) avec des dizaines d'événements à charger d'un coup, vous pouvez :

  1. Télécharger le modèle CSV depuis le dashboard (« Importer » → « Modèle CSV »).
  2. Remplir vos lignes en respectant les colonnes : title, start_at, end_at, venue, commune, price, ticket_url, description, category.
  3. Uploader le fichier. klf crée les événements en « brouillon » pour validation.

5. Webhook (push) 🟡 (temps réel)

Si vous voulez que vos événements apparaissent sur klf immédiatement après publication sur votre système, configurez un webhook qui envoie un POST à l'API klf à chaque création/mise à jour.

POST https://klf.re/api/me/ingest/webhook
Authorization: Bearer votre-token-klf

{
  "event_type": "event.created",
  "external_id": "evt-1234",
  "title": "...",
  "start_at": "...",
  ...
}

État d'avancement côté klf

✅ Disponible depuis le 3 mai 2026.
  • iCal ✅ self-service depuis votre dashboard pro
  • RSS / Atom ✅ self-service
  • API JSON ✅ self-service
  • Webhook (push) ✅ self-service (token unique généré automatiquement)
  • CSV import 🚧 prévu Q3 2026 — en attendant : convertissez votre CSV en iCal via Excel/Google Sheets ou contactez-nous

Allez dans votre Espace pro → Imports auto pour ajouter votre première source. Synchronisation automatique chaque jour à 8h heure Réunion (4h UTC).

Toutes les sources auto-publiées apparaissent directement dans l'agenda. En mode brouillon, vous validez chaque event en 1 clic.

Cas particuliers

  • Facebook Events : Meta ne propose plus d'API publique pour les événements depuis 2018. Impossible d'importer directement. Solution : utiliser Google Agenda comme pivot (Facebook → Google Agenda manuel ou via Zapier → klf via iCal).
  • Eventbrite : propose un export iCal par organisateur, utilisable directement.
  • Weezevent / Helloasso : contactez-nous, nous avons des intégrations spécifiques prévues.
Import automatiqueÉvénements