Formulaires
Les formulaires d'inscription, les personnes qui les remplissent et leurs chiffres.
Outils Formulaires
| Outil | Ce qu'il fait |
|---|---|
| listForms | Les formulaires d'inscription de l'espace de travail, les plus récemment modifiés en premier, avec leur statut, leurs inscriptions et leurs vues. |
| getForm | Un formulaire en détail : ses champs, ses textes, ses audiences, le double opt-in et les notifications. Un formulaire publié ajoute son lien, son code d'intégration et l'adresse vers laquelle un simple formulaire HTML envoie ses réponses, et includeDesign renvoie le brouillon en JSON. |
| listFormStarters | Les points de départ à partir desquels un nouveau formulaire peut commencer, avec les champs que chacun demande. |
| createForm | Créer un formulaire à partir d'un point de départ, d'un design écrit sous forme de document, ou d'un point de départ avec des modifications par-dessus, avec les paramètres de votre choix. Il reste un brouillon sauf si publish vaut true. |
| updateForm | Modifier le nom et les paramètres d'un formulaire, qui s'appliquent immédiatement, ou le design de son brouillon via document. Les textes et le style sont fusionnés clé par clé, et fields remplace toute la liste. |
| publishForm | Faire du brouillon actuel ce que voient les visiteurs, pour que le formulaire accepte les inscriptions. |
| setFormStatus | Mettre en pause un formulaire publié, ou le rouvrir. |
| duplicateForm | Copier un formulaire dans un nouveau brouillon, sans ses inscriptions. |
| deleteForm | Supprimer définitivement un formulaire et ses inscriptions. Son lien et ses intégrations cessent de fonctionner, et les personnes qu'il a ajoutées restent dans vos contacts. |
| getFormAnalytics | Les vues, les inscriptions, les personnes ajoutées et celles encore en attente, et le taux de conversion sur une période, au total et par minute, heure ou jour. Les vues sont conservées par heure. |
| listFormSubmissions | Les personnes qui ont rempli un formulaire, de la plus récente à la plus ancienne, avec leurs réponses et leur statut, une page à la fois. Avec recherche par adresse e-mail et filtre par statut. |
| getFormSubmission | Une inscription en détail : chaque réponse, son statut, quand elle est arrivée et quand la personne a été ajoutée, la page d'où elle vient et ses audiences. |
| approveFormSubmission | Ajouter une inscription qui attend sa confirmation, sans l'e-mail. Nécessite aussi contacts:write. |
| resendFormConfirmation | Envoyer par e-mail un nouveau lien de confirmation à une inscription encore en attente. Rien n'est envoyé si ce formulaire a écrit à cette adresse dans les dix dernières minutes, ou si l'adresse a déjà reçu cinq e-mails de cet espace de travail au cours de la dernière journée. Nécessite aussi emails:send. |
| removeFormSubmissions | Supprimer jusqu'à 200 inscriptions d'un formulaire par id. Les contacts et les audiences restent tels quels. |
La lecture nécessite forms:read et chaque modification forms:write. Tout ce qui amène un formulaire à envoyer des e-mails nécessite aussi emails:send : activer le double opt-in, définir l'expéditeur ou l'e-mail de confirmation, publier ou rouvrir un formulaire en double opt-in, et renvoyer une confirmation. Un client qui agit pour un membre ne voit que les formulaires que ce membre a créés, et un client limité à certaines adresses ne peut envoyer de confirmations que depuis des adresses qu'il peut atteindre, et ne peut prévenir que ces adresses-là.
Concevoir un formulaire à partir d'un brief écrit se fait dans le chat de l'application. Via MCP, c'est le client qui conçoit : passez les champs, les textes et le style sous forme de document à createForm ou updateForm, et les outils mettent le design au propre et indiquent ce qu'ils ont modifié.
Sept outils de ce serveur font un changement que l'API REST protège par un code de vérification, et demandent le même code : createRule, setRuleEnabled, removeDomain, removeDomainAddress, removeAppHost, deleteForm et deleteAudience sur une audience que vous avez créée. Tant que le client n'a pas vérifié de code dans les 60 dernières minutes, et que la personne n'a pas choisi Autoriser les modifications pendant 60 minutes pour lui dans Compte → Applications connectées, un tel outil répond par un résultat qui commence par Refused (step_up_required): et ne change rien. emptyAudience ne demande jamais de code. La page Authentification de l'API montre comment demander un code et le vérifier.
Les outils appliquent les mêmes règles et les mêmes refus que l'API REST, et les pages /forms de la référence de l'API décrivent chaque champ. listForms trie par dernière modification, et createForm et updateForm mettent au propre un document partiel, là où l'API le prend en entier.
