Guide d'intégration

Module « disponibilités en temps réel » — à destination de votre équipe technique. Temps d'intégration estimé : une demi-journée pour l'ensemble d'un site.

1L'établissement reçoit son accès

Vous nous transmettez la liste de vos établissements partenaires au format CSV : nom, email, FINESS, et si possible adresse, ville, code postal, téléphone.

Nous importons. Chaque établissement reçoit alors un email contenant un lien d'accès personnel : aucun compte à créer, aucun mot de passe à retenir. Il déclare ses places, ses tarifs et les aides acceptées en une trentaine de secondes, depuis son téléphone si besoin.

Il est ensuite relancé automatiquement chaque semaine par email, avec un bouton « Oui, rien n'a changé » qui suffit à confirmer. Une donnée non confirmée depuis 30 jours cesse d'être affichée : le module ne peut donc jamais montrer une information périmée sans le dire.

2La balise à poser sur chaque fiche

Une seule ligne, à insérer à l'endroit de la fiche où vous souhaitez voir apparaître les disponibilités — typiquement au niveau du bloc « Capacité » — ou juste avant </body> si vous préférez un rendu en bas de page.

<script src="https://ehpad-dispo.fr/js/widget.js"
        data-ehpad-id="11111111-1111-1111-1111-111111111111"></script>

Rapprochement de vos fiches avec nos identifiants

Le numéro FINESS est la clé commune. Pour obtenir l'identifiant correspondant à une fiche :

GET https://ehpad-dispo.fr/api/dispo/by-finess/130000001

200 → {"id":"11111111-1111-1111-1111-111111111111"}
404 → établissement non référencé : n'affichez pas de balise

Cet appel est public et sans authentification. En pratique, vous l'exécutez une fois lors de l'import pour stocker l'identifiant en base à côté de chaque fiche, plutôt qu'à chaque affichage.

Si un établissement n'est pas référencé chez nous, le module ne s'affiche pas et n'écrit rien dans la console : votre fiche reste strictement inchangée.

3Attributs optionnels

Attribut	Défaut	Effet
`data-ehpad-id`	—	Obligatoire. Identifiant de l'établissement.
`data-primary-color`	`#2ecc71`	Couleur des boutons, pastilles d'aides et liens. Indiquez la couleur de votre charte.
`data-show-alert`	`true`	`false` masque le formulaire « Être alerté ». Les disponibilités restent affichées.

<script src="https://ehpad-dispo.fr/js/widget.js"
        data-ehpad-id="11111111-1111-1111-1111-111111111111"
        data-primary-color="#23CB7F"
        data-show-alert="true"></script>

4WordPress

Par le thème : insérez la balise dans le gabarit de la fiche établissement (single-etablissement.php ou équivalent), en injectant l'identifiant depuis le champ personnalisé qui stocke le FINESS.
Sans toucher au thème : une extension du type « Insert Headers and Footers » convient, à condition qu'elle permette une valeur d'attribut différente par fiche.
Le module se dessine dans un Shadow DOM : votre CSS ne l'atteint pas, et son CSS ne touche pas votre page. Aucun conflit de thème n'est possible.
Aucune dépendance : ni jQuery, ni bibliothèque externe, ni police distante. Un seul fichier, mis en cache 5 minutes.
Plusieurs modules peuvent coexister sur une même page, par exemple sur une page de résultats.

5Ce qui est mesuré

Trois événements sont enregistrés par établissement, sans cookie et sans identifiant de visiteur : affichage du module, inscription à une alerte, clic sur « contacter ». Ils alimentent le rapport mensuel qui vous est envoyé le 1er de chaque mois.

6Données personnelles

Hébergement en Union européenne (base de données à Francfort, envoi d'emails en Irlande).
Les seules données personnelles traitées sont les coordonnées des personnes inscrites aux alertes (nom, email, qualité) et celles des gestionnaires d'établissement.
Vous êtes responsable de traitement, nous sommes sous-traitant au sens de l'article 28 du RGPD. Un accord de sous-traitance (DPA) d'une page accompagne le contrat.
Chaque email d'alerte comporte un lien de désinscription en un clic, sans confirmation ni compte.
Aucun cookie n'est déposé par le module sur vos pages.

7Support

Marc-Antoine Novelli — marcantoinenovelli1902@gmail.com — 06 61 09 12 72. Maintenance et hébergement inclus dans la licence annuelle.