Aller au contenu
Docs

Guide pratique

Installer les formulaires sur votre site

Ajoutez une fois le script Emailit à votre site, placez les formulaires intégrés, ouvrez des formulaires depuis votre propre code, et gérez les jetons, la publication et les réponses des formulaires.

Mis à jour le 26 oct. 2026

Une seule balise script affiche tous les formulaires en ligne de votre espace de travail sur votre site. Cette page explique où la placer, comment positionner les formulaires intégrés, comment ouvrir un formulaire depuis votre propre code, comment partager un formulaire sur une page hébergée et comment vérifier que les réponses arrivent.

Avant de commencer

  • Concevez et publiez au moins un formulaire. Seuls les formulaires en ligne apparaissent sur votre site. Consultez Concevoir un formulaire.
  • Vous devez pouvoir modifier le HTML de votre site, ou ajouter une balise HTML personnalisée dans votre gestionnaire de balises.

Ajouter le script

  1. Copiez l’extrait de code. Sur Email MarketingForms, sélectionnez Install. L’extrait figure aussi sur la page de chaque formulaire, dans la carte Installation & sharing. Il se présente ainsi, avec la clé publique de votre espace de travail dans le chemin :

    HTML
    <script async src="https://js.emailit.com/js/<WORKSPACE_PUBLIC_KEY>/emailit.js"></script>
  2. Ajoutez-le à chaque page. Collez-le une fois dans la mise en page ou le gabarit commun de votre site, idéalement juste avant la balise fermante </body>. C’est le même extrait pour tous les formulaires de l’espace de travail : vous ne l’installez qu’une fois.

  3. Publiez vos formulaires. Les pop-ups, panneaux coulissants, formulaires pleine page et bannières en ligne apparaissent désormais sur votre site sans code supplémentaire.

Le script se charge de manière asynchrone et ne bloque pas votre page. En cas de problème, comme une erreur réseau, il reste silencieux et votre page continue de fonctionner. Il fonctionne aussi lorsqu’il est ajouté via un gestionnaire de balises.

Si votre site utilise une Content Security Policy, autorisez https://js.emailit.com dans script-src et https://api.emailit.com dans connect-src.

Affichage des formulaires superposés

Type Moment de l’affichage
Banner Dès le chargement de la page. Toutes les bannières en ligne sont affichées.
Popup, Flyout, Full page 2,5 secondes après le chargement de la page. Un seul de ces formulaires s’affiche par chargement de page.

Pour modifier ce délai, définissez display_delay_seconds dans les settings du formulaire avec Mettre à jour un formulaire.

Quand un visiteur ferme un formulaire, celui-ci reste masqué dans ce navigateur pendant 7 jours. Après un envoi, il reste masqué pendant un an. Emailit le mémorise dans le stockage local du navigateur, sous la clé emailit_forms_v1, et ne dépose aucun cookie. Si le stockage local n’est pas disponible, les formulaires s’affichent à chaque chargement de page.

Intégrer un formulaire dans votre page

Les formulaires intégrés s’affichent dans votre contenu, par exemple dans un pied de page ou la barre latérale d’un blog. En plus du script, ils ont besoin d’un élément conteneur :

  1. Copiez le conteneur. Ouvrez la page du formulaire intégré. La carte Installation & sharing affiche le conteneur avec le jeton public du formulaire :

    HTML
    <div data-emailit-form="FORM_TOKEN"></div>
  2. Placez-le. Collez le conteneur là où le formulaire doit apparaître. Vous pouvez utiliser le même formulaire à plusieurs endroits.

  3. Vérifiez le script. Assurez-vous que le script est aussi présent sur la page.

Le script remplit chaque conteneur data-emailit-form dont le jeton correspond à un formulaire intégré en ligne. Il surveille aussi la page : les conteneurs ajoutés plus tard, par exemple par une application monopage, sont remplis dès leur apparition. Les formulaires intégrés s’affichent à chaque fois, que le visiteur les ait déjà envoyés ou non.

Ouvrir un formulaire depuis votre code

Ajoutez à n’importe quel bouton ou lien l’attribut data-emailit-open avec le jeton public du formulaire. Un clic ouvre le formulaire :

HTML
<button type="button" data-emailit-open="FORM_TOKEN">
  Join the newsletter
</button>

Depuis votre propre JavaScript, appelez emailit("show", token) pour ouvrir un formulaire et emailit("close", token) pour le fermer. Gardez la première ligne. Le script se charge de manière asynchrone, et cette ligne met vos appels en file d’attente jusqu’à ce qu’il soit prêt. Sans elle, un appel exécuté avant le chargement du script échoue avec emailit is not defined.

JavaScript
window.emailit=window.emailit||function(){(window._emailitq=window._emailitq||[]).push(arguments)};

emailit("show", "FORM_TOKEN");  // open the form
emailit("close", "FORM_TOKEN"); // close it
  • Le formulaire s’ouvre immédiatement, même si le visiteur l’a déjà fermé ou envoyé. Le ciblage et les limites de fréquence ne s’appliquent pas.
  • Le formulaire doit être en ligne, et le script doit être présent sur la page.
  • Un formulaire intégré s’ouvre en pop-up. Si la page contient son conteneur, la page défile plutôt jusqu’à lui.
  • emailit("close") sans jeton ferme tous les pop-ups, panneaux coulissants, formulaires pleine page et bannières ouverts.
  • Un lien vers une page de votre site qui se termine par #emailit-FORM_TOKEN ouvre aussi le formulaire.

openForm fonctionne comme alias de show.

Partager une page hébergée

Une page hébergée affiche un seul formulaire, sur sa propre page, à l’adresse https://forms.emailit.com/<public token> : chacun peut ainsi s’inscrire sans passer par votre site web, depuis une bio sur les réseaux sociaux, un e-mail, une publicité ou un code QR imprimé. Les pages hébergées sont incluses dans les forfaits Pay as you goProBusinessCustom.

  1. Publiez le formulaire. La page hébergée affiche la version en ligne du formulaire, comme votre site.

  2. Récupérez le lien. Sur la page du formulaire, ouvrez l’onglet Link & QR code de la carte Installation & sharing. Copiez le lien, sélectionnez Open hosted page pour l’essayer, ou sélectionnez Download QR pour obtenir le code QR au format SVG. Le menu Actions du formulaire propose aussi Open hosted page.

La page affiche le formulaire seul, centré, sans bouton de fermeture ni règles d’affichage : le ciblage, les déclencheurs et les limites de fréquence ne s’appliquent que sur votre site. Les réponses sont traitées de la même façon que sur votre site. Dans l’éditeur, le même lien se trouve sous Share & preview, dans l’onglet Settings.

Le lien utilise le jeton public du formulaire : réinitialiser le jeton donne donc une nouvelle adresse à la page, et l’ancien lien cesse de fonctionner. Quand le formulaire est dépublié, ou que l’espace de travail passe sur Pay as you go, la page affiche « Ce formulaire n’est pas disponible pour le moment. » dans la langue du visiteur, à la place du formulaire.

Gérer un formulaire en ligne

Mettre à jour ou dépublier

Les modifications enregistrées sur un formulaire en ligne, ou sa dépublication, sont répercutées sur votre site en une minute environ. Pour retirer un formulaire de votre site, ouvrez sa page et sélectionnez Unpublish. Il repasse à l’état de brouillon et vous pourrez le republier plus tard.

Réinitialiser le jeton public

Chaque formulaire a un jeton public, affiché sous Public token sur sa page. Les conteneurs d’intégration, les appels emailit("show", ...) et le lien de la page hébergée l’utilisent. Pour en émettre un nouveau, appelez Réinitialiser le jeton public :

Terminal
curl https://api.emailit.com/v2/forms/frm_8Lq2Wx5nVb3Tk/reset-token \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

L’ancien jeton cesse immédiatement de fonctionner : mettez à jour vos conteneurs, votre code et les liens partagés avec le nouveau token de la réponse. Les formulaires superposés qui s’affichent automatiquement ne sont pas concernés.

Vérifier les réponses

Envoyez le formulaire sur votre site avec vos propres informations, puis ouvrez la page du formulaire dans le tableau de bord. Recent submissions liste chaque réponse avec son heure Created et son Payload : les valeurs envoyées, indexées par le nom de propriété de chaque champ. Filtrez la liste par date de création.

En plus des valeurs, Emailit enregistre avec chaque réponse l’URL de la page, le référent, l’adresse IP du visiteur et le user agent de son navigateur. Mentionnez-le dans votre politique de confidentialité.

Une réponse qui contient une adresse e-mail crée aussi le contact ou le met à jour, et l’ajoute aux listes du formulaire. Consultez Réponses.

Dépannage

Le formulaire n’apparaît pas

Vérifiez que le formulaire est Live et que le script est présent sur la page, avec la clé de votre espace de travail dans son URL. Si vous avez déjà fermé ou envoyé le formulaire, il reste masqué dans votre navigateur : ouvrez la page dans une fenêtre de navigation privée, ou supprimez l’entrée emailit_forms_v1 du stockage local. N’oubliez pas qu’un seul pop-up, panneau coulissant ou formulaire pleine page s’affiche par chargement de page.

Un formulaire intégré ne s’affiche pas

Vérifiez que le type du formulaire est Embed, qu’il est en ligne et que la valeur data-emailit-form du conteneur correspond au jeton public actuel du formulaire. Si vous avez réinitialisé le jeton, mettez à jour le conteneur.

Concevez les étapes, les champs et les styles.
Créez, publiez et gérez des formulaires depuis votre code.

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.