Intégrer la recherche de tiers-lieu sur votre site

Permettez à un tiers-lieu de se retrouver depuis votre site, pour lui envoyer un lien par email ou simplement récupérer son identifiant national. Vous n'avez ni champ de recherche à coder, ni API à appeler : une balise <iframe> suffit. L'email part toujours vers l'adresse de contact enregistrée du lieu, jamais vers une adresse saisie sur votre site.

Essayer

Enquête existante

Enquêtes déclarées dans la table Enquetes de cet environnement. En choisir une remplit les deux champs ci-dessous.

Variante A — URL du formulaire

Variante B — nom du fournisseur

Doit correspondre exactement à la colonne origine de la table Enquetes du document national. C'est cette valeur qui sélectionne les enquêtes à mettre en avant : une valeur qui ne correspond à aucune ligne n'affichera aucun bandeau.

Les trois intégrations possibles

Variante A

Lien direct vers votre formulaire

Le lieu reçoit un email contenant le lien signé de ce formulaire précis. Un clic, et il répond. À privilégier 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 personnel, où vos enquêtes apparaissent dans un bandeau « À 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 ensuite dans votre application. S'il n'est pas encore référencé, il peut s'identifier sans quitter votre page.

Identifiant reçu : —

Code à copier

Documentation

Paramètres de l'iframe

Paramètre	Effet
`url`	Envoie le lien signé de ce formulaire. L'URL doit être de la forme `https://enquetes.tiers-lieux.fr/{instance}/{docId}/{form_id}`.
`enquete`	Même effet, mais 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`	Envoie le lien de l'espace du lieu, avec les enquêtes de ce fournisseur mises en avant. Valeur = colonne `origine`.
`picker=1`	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`	À utiliser si votre page a un fond sombre : le widget est transparent pour s'y fondre, mais il ne peut pas deviner votre couleur de fond depuis l'iframe.

Ce que votre page reçoit

Le widget informe la page hôte par postMessage. Aucun secret n'y transite : seul 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";
});

Si vous préférez votre propre interface

Les deux variantes sont aussi des appels HTTP, si vous voulez concevoir 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

Les liens pré-remplis de cette page dépendent de l'environnement. Ils sont chargés depuis la table Enquetes du serveur qui affiche cette page : les valeurs vues sur un environnement de test ne sont pas celles de la production. Reprenez toujours l'URL de votre formulaire.

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é deux fois de suite au même lieu (anti-spam). Deux producteurs différents peuvent en revanche solliciter le même lieu.
Si le lieu n'existe pas encore, le widget propose de l'identifier.

Événements reçus, en direct

en attente…