Ce que vous allez mettre en place
À la fin de ce guide, votre formulaire disposera de sa propre URL de webhook. Tout outil capable d’envoyer un webhook (un CRM, une application de paiement, Zapier, Make…) pourra y envoyer des données. Formaloo transforme chaque requête en nouvelle soumission de formulaire, ou met à jour la soumission existante correspondante. La logique de votre formulaire, les e-mails, la synchronisation Google Sheets et les webhooks sortants s’exécutent ensuite normalement.
Quand l’utiliser
Votre CRM met à jour un contact, et la soumission de cette même personne dans Formaloo doit aussi être modifiée
Un outil de paiement, de réservation ou de tickets déclenche un événement, et vous voulez qu’il soit enregistré automatiquement dans un formulaire
L’outil que vous utilisez n’a pas d’intégration Formaloo prête à l’emploi, mais il peut envoyer un webhook
Étape par étape
1. Ouvrez Incoming webhooks
Dans la barre latérale gauche, cliquez sur Integrations. Recherchez incoming et cliquez sur la carte Incoming webhooks.
ℹ️ Elle est différente de la carte Webhook. Webhook envoie des données depuis Formaloo. Incoming webhooks reçoit des données dans Formaloo.
ℹ️ Seuls les administrateurs et propriétaires de l’espace de travail peuvent ajouter des webhooks entrants.
2. Ajoutez un nouveau webhook
Cliquez sur + Add new webhook. Donnez-lui un Title (titre) que votre équipe reconnaîtra, par exemple « Contacts HubSpot ». Choisissez ensuite le formulaire sous Select a form.
💡 Cliquez sur le nom du formulaire dans la liste. Il ne suffit pas de le saisir pour le sélectionner.
⚠️ Vous ne pourrez pas déplacer un webhook vers un autre formulaire par la suite. Pour utiliser un autre formulaire, créez un nouveau webhook.
3. Choisissez ce qui se passe à la réception d’une requête
Sous When a request arrives, choisissez une option. Sur cet écran, un « record » (enregistrement) correspond à une soumission de formulaire.
Create a record : chaque requête ajoute une nouvelle soumission. Idéal pour les journaux d’événements, les commandes et les tickets.
Update a record : la requête modifie une soumission existante. Elle n’en crée jamais.
Update or create : met à jour la soumission correspondante, ou en crée une si aucune ne correspond. Idéal pour garder vos contacts synchronisés.
Pour Update a record et Update or create, choisissez un Identifier field (champ identifiant). C’est ainsi que Formaloo retrouve la bonne soumission, par exemple via l’adresse e-mail.
⚠️ Seuls les champs marqués Unique apparaissent dans cette liste. Si le vôtre n’y figure pas, ouvrez l’éditeur de formulaire, cliquez sur le champ, activez Unique et enregistrez.
💡 Vous avez déjà l’ID Formaloo de la soumission ? Envoyez-le dans une clé row_slug de premier niveau pour mettre à jour exactement cette soumission. Vous trouverez cet ID dans la réponse du webhook lorsqu’il crée une soumission, dans la colonne Record de l’onglet Events, ou sous la forme slug dans les webhooks sortants de Formaloo. La plupart des outils ne disposent pas de cet ID, et ce n’est pas un problème : le champ identifiant (par exemple Email) retrouve la bonne soumission pour vous.
4. Choisissez comment votre outil prouve qu’il est autorisé
Sous Authentication, choisissez une option :
Bearer token : l’option par défaut, prise en charge par la plupart des outils. Votre outil envoie
Authorization: Bearer <your token>.API key header : pour les outils qui envoient une clé dans leur propre en-tête. Conservez
X-Api-Keyou saisissez un autre nom d’en-tête. Formaloo génère la clé pour vous. Les en-têtes standard commeAuthorizationouHostne peuvent pas être utilisés.None : toute personne disposant de l’URL peut envoyer des données. Formaloo vous demande de confirmer avec I understand the risk. Utilisez cette option uniquement pour des tests, ou pour des outils qui ne peuvent pas envoyer de clé.
Cliquez sur Save and continue. Une fenêtre Copy your Bearer token s’ouvre. Cliquez sur Copy, conservez le jeton en lieu sûr, cochez I copied it, puis cliquez sur Done.
⚠️ Ce jeton ne s’affiche qu’une seule fois. Formaloo ne peut plus l’afficher ensuite, même aux administrateurs. N’actualisez pas la page avant de l’avoir copié.
6. Envoyez un exemple réel depuis votre outil
Formaloo affiche alors Listening for a sample request, avec un minuteur de 15 minutes et votre Endpoint URL. Collez l’URL dans votre outil et faites-lui envoyer une vraie requête.
ℹ️ Un exemple ne crée ni ne modifie jamais de soumission. Il ne déclenche pas non plus la logique, les e-mails ou les autres webhooks.
Dès que la requête arrive, la page passe automatiquement à l’étape Map fields.
Si le minuteur expire, vous verrez Timed out. Cliquez sur Listen again et renvoyez la requête.
7. Associez l’exemple aux champs de votre formulaire
Sous Captured sample, cliquez sur une valeur pour l’associer au prochain champ disponible. Chaque clic ajoute une ligne sous Map to form fields. Vérifiez la colonne Form field et modifiez-la si la valeur a été associée au mauvais champ.
⚠️ Chaque clé associée doit figurer dans toutes les requêtes envoyées par votre outil. Si une clé associée est absente, Formaloo rejette la requête. N’associez que les clés que votre outil envoie systématiquement.
8. Enregistrez l’association
Cliquez sur Save mapping. Formaloo vérifie l’association à partir de votre exemple, puis active le webhook. Le message « Mapping saved. Your webhook is active and ready to receive requests. » s’affiche.
9. Testez avec une requête réelle
Renvoyez la même requête depuis votre outil. Vérifiez ensuite deux endroits :
Les Responses du formulaire : une soumission nouvelle ou mise à jour apparaît.
L’onglet Events du webhook : chaque requête affiche son heure, son résultat et son code de statut.
Code de statut | Signification |
201 | Une soumission de formulaire a été créée |
200 | Une soumission existante a été mise à jour |
404 | Update a record n’a trouvé aucune correspondance, rien n’a donc été modifié |
409 | Le webhook est désactivé, ou plusieurs soumissions correspondent à l’identifiant |
10. Modifiez ou désactivez le webhook plus tard
Ouvrez Integrations → Incoming webhooks, puis cliquez sur ⋮ à côté de votre webhook :
Edit : un webhook actif est d’abord en lecture seule. Cliquez sur Pause and edit pour le modifier. Laissez Turn it back on after saving coché pour qu’il redémarre à l’enregistrement. Pendant la pause, les requêtes sont refusées.
Si la structure des données de votre outil a changé, allez dans Capture a sample → Capture a new sample et refaites l’association.
Event logs : consultez toutes les requêtes. Le contenu des requêtes est supprimé après environ 30 jours.
Deactivate : arrête le webhook sans le supprimer.
Delete : supprime le webhook. Les requêtes envoyées par votre outil vers son URL échoueront.
Résultat final
Votre formulaire reçoit désormais des données de tout outil capable d’envoyer un webhook. Chaque requête crée ou met à jour la bonne soumission, sans copier-coller ni middleware. Votre logique, vos e-mails, la synchronisation Sheets et vos webhooks sortants s’exécutent automatiquement sur ces données. L’onglet Events indique précisément ce qui est arrivé et ce qui s’est passé, pour que vous puissiez vous fier à la synchronisation.