Comment envoyer des réponses de formulaire avec l'API?
Copiez l'identifiant du formulaire dans son bloc API, créez une clé Importation, puis envoyez les réponses par POST à /v1/forms/{id}/submissions. Chacune arrive comme une réponse du site Web.
Votre propre logiciel (le serveur de votre site Web, une application, un script) peut envoyer des réponses à l'un de vos formulaires et les relire. Copiez l'identifiant du formulaire dans son bloc API, créez une clé API, puis envoyez les réponses. Chacune arrive exactement comme si quelqu'un remplissait le formulaire sur votre site Web.
Aussi appelé : form API, submit form, form submissions, webhook, developer, REST API, API des formulaires, envoyer un formulaire, réponses du formulaire
Étape 1 : Copier l'identifiant du formulaire
Ouvrez Marketing › Formulaires et cliquez sur votre formulaire. Faites défiler jusqu'à API et cliquez sur le bouton de copie à côté de Identifiant du formulaire.
Cliquez : Formulaires › votre formulaire › API › Identifiant du formulaire

Étape 2 : Obtenir une clé API
Dans le même bloc, cliquez sur Obtenir une clé API. Sur la page API de données, cliquez sur Nouvelle clé, entrez un Nom de clé, choisissez Importation et cliquez sur Créer une clé. Cliquez sur Copier. Vous pourrez l'afficher à nouveau plus tard à partir de votre liste de clés. Pour pouvoir aussi lire les réponses, choisissez plutôt Accès complet.
Cliquez : Obtenir une clé API › Nouvelle clé › Importation › Créer une clé › Copier

Étape 3 : Envoyer les réponses
Donnez la clé et l'identifiant du formulaire à votre développeur. Il envoie chaque réponse comme ceci (utilisez votre URL de base de la page API de données) :
curl -X POST https://api.alori.dev/v1/forms/FORM_ID/submissions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: a-unique-id-per-answer" \
-d '{"answers": {"Name": "Maya Chen", "Email": "maya@brightloop.com", "Message": "We want a demo."}}'Nommez chaque question par son libellé (Email) ou sa clé (email). Une case à cocher prend la valeur true. La réponse apparaît immédiatement sous Réponses sur le formulaire, avec une opportunité pour la personne. L'en-tête Idempotency-Key sécurise les réessais : la même réponse envoyée deux fois ne compte qu'une seule fois.

Bon à savoir
La personne est retrouvée par courriel ou par téléphone, de sorte que la même personne deux fois ne crée jamais de doublon. Une nouvelle personne obtient une nouvelle opportunité; quelqu'un qui a déjà une opportunité ouverte reçoit une note dessus.
Votre équipe est avisée comme pour n'importe quelle réponse. Envoyez
"notify": falsepour éviter la notification.Ajoutez
"pageUrl"pour indiquer de quelle page elle provient. Cela remplit les questions masquées qui lisent l'adresse, commeutm_source.Pour lire les réponses :
GET /v1/formsliste vos formulaires et leurs questions, etGET /v1/forms/FORM_ID/submissionsliste les réponses, de la plus récente à la plus ancienne, une page à la fois : renvoyeznextCursoren tant quecursorpour la page suivante. Celles-ci nécessitent une clé Rapports ou Accès complet.Chaque clé peut effectuer 1 000 requêtes par minute.
Si ça ne fonctionne pas
required: une question obligatoire n'a pas de réponse.error.detailsla nomme dansfield.unknownQuestion: un nom de question ne figure pas sur ce formulaire.error.detailsliste les questions du formulaire.contactRequired: envoyez un courriel ou un numéro de téléphone.formNotFound: vérifiez l'identifiant du formulaire.« Cette clé ne peut pas faire cela » : une clé Rapports ne fait que lire. Créez une clé Importation ou Accès complet pour envoyer des réponses.
Articles connexes
Cet article a-t-il répondu à votre question?