Formulaires d'inscription
Chaque commande pour les formulaires d'inscription et les personnes qui les remplissent, avec des exemples détaillés.
Comment tout s'articule
Un formulaire d'inscription ajoute à vos audiences les personnes qui le remplissent. Il conserve un brouillon et une copie en ligne : update modifie le brouillon et les paramètres, et publish met le brouillon en ligne. La lecture nécessite forms:read et la modification forms:write. resend-confirmation, ainsi que toute modification qui amène le formulaire à envoyer des e-mails, nécessite aussi emails:send.
openemail forms create --name "Newsletter sign-up" --starter newsletter --publishopenemail forms list-submissions frm_3b9d2e7a1c4f80d56e2a9b14 --status pendingopenemail forms analytics frm_3b9d2e7a1c4f80d56e2a9b14 --days 30Formulaires
| Commande | Ce qu'il fait |
|---|---|
| openemail forms list | Une page des formulaires, du plus récent au plus ancien, avec leur statut et leurs chiffres |
| openemail forms create --name <value> | Créer un brouillon à partir de --starter, d'un fichier --document ou d'un seul champ e-mail. --publish le met en ligne tout de suite |
| openemail forms get <id> | Un formulaire avec son brouillon, sa copie en ligne et ses paramètres |
| openemail forms update <id> | Modifier le nom, le brouillon --document ou les paramètres de votre choix, comme --settings-double-opt-in, en un seul appel |
| openemail forms publish <id> | Mettre le brouillon en ligne |
| openemail forms pause <id> | Empêcher un formulaire publié d'accepter des inscriptions |
| openemail forms resume <id> | Rouvrir un formulaire en pause |
| openemail forms duplicate <id> | Copier un formulaire dans un nouveau brouillon, sans ses inscriptions |
| openemail forms delete <id> | Supprimer un formulaire et ses inscriptions après votre confirmation. Une connexion par navigateur demande aussi un code de vérification |
| openemail forms list-starters | Les points de départ à partir desquels un nouveau formulaire peut commencer |
| openemail forms get-starter <slug> | Un point de départ avec son document |
| openemail forms analytics <id> | Les vues, les inscriptions et les personnes ajoutées sur une période, 30 jours sauf si --days ou --minutes indique autre chose |
Soumissions
| Commande | Ce qu'il fait |
|---|---|
| openemail forms list-submissions <id> | Une page d'inscriptions, de la plus récente à la plus ancienne. --q cherche dans les adresses e-mail, et --status choisit pending ou added |
| openemail forms get-submission <id> <submission-id> | Une inscription avec toutes ses réponses |
| openemail forms delete-submission <id> <submission-id> | Supprimer une inscription après votre confirmation. La personne reste dans vos contacts |
| openemail forms delete-submissions <id> <submission-ids...> | Supprimer jusqu'à 200 inscriptions après votre confirmation |
| openemail forms approve-submission <id> <submission-id> | Ajouter une inscription en attente sans sa confirmation. Nécessite aussi contacts:write |
| openemail forms resend-confirmation <id> <submission-id> | Envoyer par e-mail un nouveau lien de confirmation à une inscription en attente, sauf si un lien est parti dans les dix dernières minutes. Nécessite aussi emails:send |
Inscrire quelqu'un
subscribe envoie un POST à un formulaire publié, comme le fait sa page. Il n'a besoin ni de clé ni de connexion, il fonctionne donc sans être connecté. Passez les autres réponses en JSON avec --data, et la page où se trouvait le formulaire avec --oe-source.
openemail forms subscribe frm_3b9d2e7a1c4f80d56e2a9b14 --email [email protected] --data '{"first_name":"Ann","consent":true}'Une réponse manquante ou erronée sort avec le code 7 et liste chaque champ avec sa raison. Un formulaire en pause sort avec 6, et trop d'inscriptions depuis un même réseau avec 8.
