Cet article explique comment envoyer chaque demande d’un formulaire à une adresse web, par exemple celle d’un scénario Make ou d’un Zap. Vous saurez brancher cette adresse, l’essayer sur le Staging, lire le contenu d’un envoi et suivre le journal des envois.
Avant de commencer
- Chaque formulaire peut envoyer ses demandes à une adresse web que vous donnez (un webhook). Votre site envoie chaque demande à cette adresse au format JSON dans les minutes qui suivent sa réception.
- Lovely Render ne propose pas de connecteur prêt à l’emploi pour un logiciel de gestion de clients. Pour y faire entrer vos demandes, passez par Make, par Zapier ou par l’adresse web que votre outil fournit.
- Les adresses se règlent dans le menu Formulaires, réservé aux administrateurs du site.
Comprendre les deux adresses d’envoi
Chaque formulaire a deux adresses d’envoi, une par environnement. Vous essayez ainsi votre branchement sur le Staging sans écrire dans votre outil réel.
| Adresse | Reçoit |
|---|---|
| Adresse de production | Les demandes de vos visiteurs, reçues sur votre site en ligne. |
| Adresse de staging | Les soumissions faites sur votre Staging, vos essais. |
Une adresse vide n’envoie rien. Une Adresse de production vide ne se rabat jamais sur l’adresse de staging.
Les adresses se règlent sur le Staging et partent en ligne avec la publication du site. Une Adresse de staging sert dès que vous l’enregistrez. Une Adresse de production saisie ou corrigée ne sert à votre site en ligne qu’après votre prochaine publication. L’écran le rappelle sous le champ : La Production s’en sert dès la prochaine publication du site.
Le lien Publier maintenant suit cette phrase. Il ouvre l’écran de publication du site, d’où vous lancez la publication. Le lien ne publie rien lui-même.
Brancher une adresse
- Dans votre outil, créez le point d’arrivée. Dans Make, c’est un webhook personnalisé au début d’un scénario. Dans Zapier, c’est le déclencheur Catch Hook de Webhooks by Zapier.
- Copiez l’adresse du point d’arrivée.
- Dans le menu de l’administration, ouvrez Formulaires, puis cliquez sur le nom du formulaire.
- Cliquez sur l’onglet Intégrations. La carte Envoi des demandes s’affiche.
- Collez l’adresse dans Adresse de staging.
- Cliquez sur Enregistrer les adresses. Le message Adresses enregistrées. s’affiche.
- À côté de l’adresse, cliquez sur Tester. Un exemple part vers votre outil et le message donne sa réponse, par exemple Le test de l’adresse de Staging est réussi (réponse 200).
- Envoyez une vraie soumission depuis votre Staging et vérifiez qu’elle arrive dans votre outil.
- Saisissez l’adresse de votre outil réel dans Adresse de production.
- Cliquez sur Enregistrer les adresses.
- Sous Adresse de production, cliquez sur Publier maintenant. L’écran de publication du site s’ouvre.
- Publiez votre site.
Une adresse doit commencer par https:// ou http://. Une autre valeur est enregistrée vide. Le bouton Tester essaie l’adresse enregistrée. Enregistrez une adresse corrigée avant de la tester.
Chaque changement d’adresse est noté dans l’historique du site avec le nom de son domaine.
Lire le contenu d’un envoi
Chaque demande part au format JSON dès qu’elle compte comme une demande reçue : à l’envoi du formulaire ou, sur un formulaire en plusieurs étapes, à son étape de conversion.
L’envoi contient les réponses du visiteur, le nom du formulaire, la provenance de la demande (source, support et campagne) et la mention d’information que le visiteur avait sous les yeux, avec les usages qu’il a acceptés.
Chaque champ y figure sous son identifiant, qui ne change pas quand vous renommez son libellé ou le formulaire. Dans Make ou Zapier, associez vos colonnes aux identifiants des champs.
Suivre les envois
Sous les adresses, le Journal des envois liste les cinquante derniers envois de l’environnement affiché. Le plus récent est en haut. Chaque ligne donne la Date, l’Environnement, le Statut, les Tentatives, le Code HTTP, la Durée et l’Erreur.
| Statut | Signification |
|---|---|
| Livré | Votre outil a accepté l’envoi, avec une réponse de la famille 200. |
| Nouvel essai prévu | L’envoi a échoué. Il repart plusieurs fois au cours des heures qui suivent. |
| Échoué | Tous les essais ont échoué. L’envoi ne repartira plus. |
| Refusé par le destinataire | Votre outil a répondu une erreur de la famille 400, autre que 408 et 429. L’envoi n’est pas retenté. |
Sans envoi, le journal affiche Aucun envoi pour l’instant.
Corriger un envoi refusé
- Dans le Journal des envois, relevez le Code HTTP et l’Erreur de la ligne.
- Avec un code de la famille 400, vérifiez dans votre outil que l’adresse existe toujours et accepte les envois.
- Corrigez l’adresse si besoin.
- Cliquez sur Enregistrer les adresses.
- Cliquez sur Tester.
- Si l’adresse corrigée est celle de production, publiez votre site.