Les données des tiers-lieux Comment ça marche pour les lieux ?

Réseaux, partenaires, diffuseurs d'enquêtes

Intégrer la recherche à votre site

Un tiers-lieu se retrouve depuis votre page : vous lui envoyez un lien par email, ou vous récupérez simplement son identifiant national.

  • Une balise <iframe> suffit : ni champ de recherche à coder, ni API à appeler.
  • L'email part toujours à l'adresse de contact enregistrée du lieu, jamais à une adresse saisie sur votre site.
  • Le champ se fond dans votre page : fond transparent, police du système, et votre couleur.
Votre site [Titre de votre page]
Le champ intégré, avec la couleur du site (paramètre accent).

Les trois intégrations possibles

Enquêtes déclarées dans la table Enquetes de cet environnement : en choisir une remplit les deux champs. Le nom du fournisseur doit correspondre exactement à la colonne origine : une valeur qui ne correspond à aucune ligne n'affiche aucune enquête à la une.

Variante A

Lien direct vers votre formulaire

Le lieu reçoit un email avec le lien signé de ce formulaire précis. Un clic, et il répond. Pour un appel à l'action « répondez à notre enquête ».

Code à copier

        
Variante B

Espace du lieu, vos enquêtes en avant

Le lieu reçoit le lien de son espace, où vos enquêtes sont à la une. Un clic de plus, mais il découvre aussi vos autres formulaires.

Code à copier

        
Variante C

Récupérer l'identifiant national

Aucun email : le lieu se retrouve, et votre page reçoit son identifiant national par postMessage, à utiliser dans votre application. S'il n'est pas encore référencé, il s'identifie sans quitter votre page.

Identifiant reçu : aucun pour l'instant

Code à copier

        

Paramètres de l'iframe

ParamètreEffet
url Variante A : envoie le lien signé de ce formulaire, de la forme https://enquetes.tiers-lieux.fr/{instance}/{docId}/{form_id}.
enquete Même effet, en désignant une enquête déclarée dans la table Enquetes, par son identifiant ou son slug. Le formulaire suit alors la fiche de l'enquête.
en_avant Variante B : envoie le lien de l'espace du lieu, avec les enquêtes de ce fournisseur à la une. Valeur : la colonne origine.
picker=1 Variante C : sélecteur seul, sans bouton d'envoi. Votre page récupère l'identifiant national du lieu et fait ce qu'elle veut ensuite.
theme=dark Si votre page a un fond sombre : le champ est transparent pour s'y fondre, mais il ne peut pas deviner votre couleur de fond depuis l'iframe.
accent=2f5d50 La couleur de votre site, en hexadécimal et sans # : contour du champ actif, bouton d'envoi et entrée « Identifier un nouveau lieu ». C'est la seule couleur du champ ; sans ce paramètre, il prend un bleu neutre.

Ce que votre page reçoit

Le champ informe votre page par postMessage. Aucun secret n'y transite : seulement l'identifiant national, qui est public.

window.addEventListener("message", (e) => {
  if (e.origin !== "") return;      // valider l'origine
  const m = e.data;
  if (!m || m.source !== "tiers-lieux-embed") return;

  if (m.type === "tl:select")     console.log(m.payload.identifiant_national, m.payload.nom);
  if (m.type === "tl:email-sent") console.log(m.payload.success, m.payload.message);
  if (m.type === "tl:resize")     iframe.style.height = m.height + "px";
});

Votre propre interface

Les envois sont aussi de simples appels HTTP, si vous concevez votre propre parcours.

POST /send-enquete-link
{"identifiant_national": "…", "url": "https://enquetes.tiers-lieux.fr/…"}

POST /send-edit-link
{"identifiant_national": "…", "en_avant": "RFTL"}

Désignez le lieu par son identifiant_national : il est public et stable. (record_id est accepté, mais c'est un numéro de ligne interne, susceptible de différer d'un environnement à l'autre.)

Bon à savoir

  • L'email part vers l'adresse de contact enregistrée du lieu. Votre site ne la voit jamais et ne peut pas la choisir.
  • Un même lien n'est pas renvoyé au même lieu dans l'heure, et un lieu ne reçoit pas plus de cinq emails par heure (anti-spam). Deux diffuseurs différents peuvent en revanche solliciter le même lieu.
  • Si le lieu n'existe pas encore, le champ propose de l'identifier.

Les exemples de cette page dépendent du serveur qui l'affiche. Ils sont chargés depuis la table Enquetes de cet environnement : sur un environnement de test, ce ne sont pas ceux de la production. Reprenez toujours l'adresse de votre formulaire.

Événements reçus, en direct

en attente…