---
title: "Connecteur Venio — Import des événements"
module: store
type: functional
status: active
updated: 2026-07-31
---

# Connecteur Venio — Import des événements

**Catégorie Store :** Widgets / Contenu · **Sens :** entrant (Venio → Isi-APP) · **Coût :** gratuit

---

## À quoi ça sert

**Venio** est une plateforme française de billetterie et de gestion d'événements, utilisée
notamment par des diocèses pour leurs pèlerinages et rassemblements. Pour éviter de ressaisir
ces événements dans Isi-APP, le connecteur Venio **récupère automatiquement les événements
publics d'un organisateur Venio** et les crée comme **actualités de type Article** dans le
portail Isi-APP, avec un lien vers la page d'inscription.

Chaque actualité importée est marquée d'une **source d'entrée** (`Venio`), ce qui permet de la
distinguer des actualités créées manuellement dans Isi-APP (`Isi-APP`) et de filtrer par
provenance.

## Mise en place

1. **Store → Catalogue** : ouvrir la fiche du connecteur **Venio** et l'installer (gratuit,
   installation en un clic). Une instance est créée dans **Mes connecteurs**.
2. **Configurer l'instance** :
   - **Identifiant de l'organisateur (`vendor_slug`)** : le slug de l'organisateur côté Venio,
     visible dans l'URL de sa page publique (obligatoire).
   - **Entité de rattachement (`idc`)** : l'entité Isi-APP à laquelle attacher les actualités
     importées (par défaut, l'entité courante).
   - **Synchronisation** : déclencheur manuel ou planifié + fréquence.
3. **Synchroniser** : manuellement (bouton) ou automatiquement selon la fréquence choisie.

## Ce qui est importé

Seuls les événements en visibilité **Publique** de l'organisateur sont exposés par Venio et
donc importés (les événements privés/brouillons ne sont jamais récupérés).

| Côté Venio | Devient dans Isi-APP |
|------------|----------------------|
| Nom de l'événement | Titre de l'actualité |
| Description longue | Chapô + première partie du corps |
| Informations pratiques | Section « Informations pratiques » du corps |
| Programme | Section « Programme » du corps |
| Dates de début / fin | Date de l'actualité + date de fin |
| Première image | Image de l'actualité |
| Identifiant (`subdomain`) | Lien d'inscription public en pied de l'actualité (`https://{subdomain}.venio.fr/fr`) |

L'actualité créée est toujours de type **Article**.

## Comportement de la synchronisation

- **Sans doublon** : un événement déjà importé est mis à jour, pas recréé (correspondance par
  identifiant Venio, le `subdomain`).
- **Date de publication = date de la synchronisation** (et non la date de l'événement) :
  l'actualité est donc publiée immédiatement, même pour un événement qui se déroulera dans
  plusieurs mois. La date de l'événement reste affichée comme **date de l'actualité**.
- **Visible sur la page d'accueil par défaut** : les actualités importées arrivent avec
  « Afficher sur la page d'accueil » activé.
- **Vos réglages sont respectés** : si vous retirez une actualité importée de la page d'accueil,
  changez sa date de publication ou activez son partage, une synchronisation ultérieure **ne
  rétablit pas** les valeurs d'origine (même si le contenu de l'événement a changé entre-temps).
- **Mises à jour** : si le contenu d'un événement change côté Venio, l'actualité liée est mise
  à jour.
- **Pas d'archivage automatique** : contrairement au connecteur OClocher, la disparition d'un
  événement de la liste Venio (terminé, dépublié…) **ne déclenche aucune action** — Venio
  n'expose pas d'indicateur de désactivation. L'actualité reste en l'état ; son archivage, le
  cas échéant, doit être fait manuellement.
- **Une actualité archivée manuellement n'est jamais ressuscitée** par la synchronisation.
- Chaque synchronisation est tracée (succès / erreurs, compteurs) dans les **logs de
  l'instance**.

## Filtrer les actualités par source

Dans le module **Actualités**, un filtre **Source** permet d'afficher uniquement les
actualités d'une provenance donnée (Isi-APP, OClocher, Venio…). Une colonne **Source** est
également disponible à l'affichage et à l'export.

Les actualités qui proviennent d'un connecteur portent en plus une **pastille de provenance**
(« Venio », « OClocher ») visible dans la liste des actualités, sur la fiche de l'actualité et
dans les widgets du portail. Les actualités créées directement dans Isi-APP n'en portent pas.

### Widgets « Actualités » du portail

Les widgets d'actualités (« Portail - Actualités » et « Vignettes X4 ») offrent un champ
**Sources des actualités** dans leur configuration (admin widgets) : on coche une **ou plusieurs**
provenances parmi **Isi-APP**, **OClocher** et **Venio** — un même widget peut donc mélanger les
flux, la pastille permettant de distinguer l'origine de chaque actualité. Au moins une source doit
être cochée. Les widgets existants conservent la source qui était sélectionnée.

## Limites connues (V1)

- L'API Venio ne fournit ni pagination ni filtre par date : tous les événements publics de
  l'organisateur sont parcourus à chaque synchronisation.
- Aucun horodatage de mise à jour n'est exposé côté Venio : la détection des changements se fait
  par comparaison de contenu, pas par date.
- Aucun indicateur de désactivation : un événement qui disparaît de la liste Venio n'est jamais
  archivé automatiquement côté Isi-APP.
- Le `vendor_slug` se saisit manuellement (pas de recherche d'organisateur exposée par l'API).

## Voir aussi

- Documentation technique : `.claude/technical-docs/store/venio.md`
- Connecteur miroir (comportement d'archivage différent) : `docs/store/oclocher.md`
- Cahier des charges Store : `docs/store/store-connectors-spec.md`