Formulaires web

Le module Formulaires web

L'écran Formulaires web de la Configuration liste vos formulaires : leur nom, l'espace, l'objet créé, le nombre de champs, et un statut « Actif » ou « Révoqué ». Le consulter demande la permission « Consulter la configuration de l'organisation » ; créer, modifier ou révoquer un formulaire, « Modifier la configuration de l'organisation (accorde aussi sa consultation) ».

« Nouveau formulaire » (ou « Créer un formulaire » quand la liste est vide) ouvre la fenêtre « Nouveau formulaire web » ; cliquer sur un formulaire l'ouvre en modification. La fenêtre se lit en deux colonnes : à gauche l'objet, les paramètres et la notification, à droite les champs et l'intégration. « Enregistrer » valide l'ensemble.

Une soumission est acceptée si elle vient d'un domaine autorisé, passe la protection contre les robots, remplit les champs « Requis » et respecte les valeurs permises. Miel crée alors la fiche par le même chemin qu'une saisie dans l'application : vosautomatisations d'objet« À la création » s'exécutent, et la fiche apparaît aussitôt dans les listes.

Objet et nom

• « Objet créé à la soumission » (obligatoire) : le type d'objet de la fiche créée, un prospect ou une demande de contact par exemple. Il doit appartenir à un espace ; les champs et les valeurs se règlent ensuite sur ses propriétés ;
• « Nom du formulaire » : le nom affiché dans la liste et dans le titre des notifications (« Nouvelle soumission : … »).

Paramètres

Le bloc « Paramètres » réunit trois réglages :

• « Destinataire(s) » : les personnes ou groupes à qui chaque fiche créée est assignée ;
• « Domaines autorisés à embarquer le formulaire » : les sites où le formulaire est publié, par exemple https://www.exemple.com (« + Ajouter un domaine »). Indiquez-en au moins un, et listez chaque adresse exacte du site : https://exemple.comet https://www.exemple.com sont deux adresses. Une adresse locale, une adresse IP ou un nom de domaine incomplet est refusé ; une soumission envoyée depuis une adresse absente de la liste l'est aussi ;
• « Valeurs appliquées automatiquement » : des valeurs posées sur chaque fiche créée, sans être demandées au visiteur, qui ne peut ni les voir ni les modifier. Par exemple une « Source » à « Web » pour tracer l'origine. « + Ajouter une propriété », puis la valeur imposée ; elle l'emporte sur une valeur saisie dans le formulaire pour la même propriété.

Notification à la soumission

Le bloc « Notification à la soumission » dit qui prévenir quand une fiche est créée. Laissé vide, il ne prévient personne.

• « Personnes et groupes notifiés (socle, à chaque soumission) » : prévenus à chaque soumission, quoi qu'elle contienne ;
• « Règles de routage conditionnel » (« Configurer ») : des personnes prévenues en plus selon une réponse. Une règle se lit « Si le champ » … « vaut l'une de ces valeurs » … « alors notifier en plus » … ; « + Ajouter une règle » en ajoute une ;
• « Canaux » : « Notification interne » (le centre de notifications de Miel) et « E-mail ». Il en faut au moins un pour enregistrer une notification.

Seul un champ de type « Liste déroulante » peut porter une règle : ajoutez-en un au formulaire d'abord. Les règles s'additionnent au socle sans jamais le retirer : à chaque fiche créée, le socle est prévenu, plus les destinataires de chaque règle dont une valeur correspond à la valeur enregistrée sur la fiche (une valeur appliquée automatiquement à la même propriété compte donc). Une soumission refusée ne crée rien et ne prévient personne. La notification ne bloque jamais la création de la fiche : si son envoi échoue, la fiche est créée quand même.

Champs du formulaire

Une fois l'objet choisi, le bloc « Champs du formulaire » propose des raccourcis qui ajoutent un champ déjà réglé et proposent la propriété correspondante de votre objet : « E-mail », « Prénom », « Nom », « Téléphone », « Société », « Fonction », « Site web », « Message », « Adresse », « Code postal », « Ville », « Pays ». « Champ libre » ajoute un champ vide.

Chaque champ se règle sur une ligne :

• « Libellé » : la question affichée au visiteur ;
• « Identifiant » : le nom technique du champ, repris par le mode développeur ;
• « Type » : la saisie proposée au visiteur (tableau ci-dessous) ;
• « Propriété » : la propriété de l'objet qui reçoit la réponse, parmi celles que l'écran propose pour ce type ;
• « Requis » : la réponse est obligatoire. Miel refuse à la réception une soumission où ce champ est absent, vide ou fait d'espaces, quelle que soit l'intégration ; le formulaire hébergé par Miel le signale avant l'envoi en nommant les champs à remplir. Une case à cocher n'est jamais vide : cochée ou non, elle est une réponse. L'écran ne propose donc pas « Requis » pour une case à cocher, et le formulaire hébergé ne lui met pas d'astérisque.

Les flèches changent l'ordre des champs, « Retirer » en supprime un. La réponse vide d'un champ non requis est ignorée, comme toute donnée envoyée pour un champ que le formulaire ne déclare pas.

Pour une « Liste déroulante » reliée à une propriété « Liste déroulante » de l'objet, cochez les valeurs proposées au visiteur : seules celles-là sont acceptées. L'écran avertit quand une valeur cochée porte des métadonnées internes (scoring, routage) : vérifiez qu'elles peuvent être exposées. Reliée à une autre propriété, la liste reçoit ses options une à une (« + Ajouter une option »).

Révoquer un formulaire

« Révoquer », en bas de la fenêtre d'un formulaire actif, ferme le formulaire : les soumissions sont refusées aussitôt, sur tous les sites, et la liste le montre « Révoqué ». Les fiches déjà créées restent.

Intégration sur votre site

Le bloc « Intégration sur votre site » apparaît après le premier enregistrement du formulaire. Il propose deux modes :

• « Sans code » : deux lignes à coller dans une page de votre site (« Copier le snippet ») ; Miel affiche le formulaire et le reçoit ;
• « Mode développeur » : votre site garde sa propre interface et envoie les réponses avec le kit JavaScript de Miel. L'écran fournit un exemple complet, construit sur vos champs (« Copier l'exemple »), et l'adresse qui décrit les champs du formulaire (« Découvrir les champs (optionnel) »).

À titre d'illustration, les deux lignes du mode « Sans code » ont cette forme ; copiez toujours celles de l'écran, qui portent l'identifiant de votre formulaire et l'adresse de votre Miel :

<div data-miel-form="IDENTIFIANT-DU-FORMULAIRE"></div>
<script src="https://ADRESSE-DE-VOTRE-MIEL/public-form/embed.js" async></script>

Les soumissions sont protégées automatiquement contre les robots : il n'y a rien à régler, et l'exemple du mode développeur inclut déjà cette protection.

Sous les deux modes :

• « Votre site a une politique de sécurité du contenu (CSP) stricte ? » : les directives à ajouter à celle de votre site (« Copier les directives ») ; sans CSP stricte, rien à faire ;
• « Mention à reprendre dans votre politique de confidentialité » : un paragraphe qui décrit la protection contre les robots (« Copier la mention »). Faites-le relire par la personne qui tient votre politique de confidentialité avant de le publier.

Prochaine étape

Vos formulaires alimentent vos objets. Connectez maintenant le logiciel de votre expert-comptable.