Envoyer les réponses vers d'autres outils

Une connexion (on dit aussi un webhook) envoie chaque nouvelle réponse d'un formulaire vers un autre outil : Zapier, Make, une feuille Google Sheets, ou toute adresse qui commence par https://. Les connexions feront partie de la formule Pro ; pendant l'accès anticipé, elles sont ouvertes à tous les comptes (voir Formules et crédits).

Avant de commencer

• La validation en deux étapes est obligatoire pour ajouter, modifier ou activer une connexion, car les réponses sortent de Fillfold. Voir Créer son compte et activer la validation en deux étapes.
• Un formulaire peut avoir au plus 2 connexions. Une nouvelle connexion est désactivée au départ.
• Nous vous envoyons un e-mail chaque fois qu'une connexion est ajoutée, modifiée, activée ou reçoit un nouveau secret.

Ajouter une connexion

1. Ouvrez le formulaire et choisissez Connexions.
2. Collez l'adresse donnée par votre outil dans Adresse (URL).
3. Cochez Je comprends où vont les réponses, puis choisissez Ajouter la connexion.
4. Copiez le secret affiché sous Secret de signature, affiché une seule fois et gardez-le dans votre outil.
5. Choisissez Envoyer un test : des réponses d'exemple inventées sont envoyées, jamais une vraie réponse.
6. Choisissez Activer.

La liste Envois récents montre les 50 derniers envois, gardés 30 jours, avec Réessayer maintenant pour un envoi en échec.

Zapier et Make

• Zapier : créez un Zap avec le déclencheur Webhooks by Zapier, événement Catch Hook, et collez son URL dans Fillfold. Vérifiez que votre formule Zapier comprend Webhooks by Zapier.
• Make : ajoutez le module Webhooks, puis Custom webhook, et collez son adresse.

Chaque requête contient le formulaire, la date de la réponse, les questions (fields) et les réponses (answers). Les nombres arrivent comme des nombres, les tableaux comme des lignes, les fichiers par leur nom seulement.

Quand un client accepte un devis que vous avez préparé, vos connexions reçoivent aussi l'événement quote.accepted, avec le PDF signé derrière document.url si vous incluez les liens vers les PDF (voir Envoyer un devis à accepter).

Google Sheets

1. Dans votre feuille, ouvrez Extensions, puis Apps Script.
2. Dans Fillfold, choisissez Copier le script Google Sheets et collez-le.
3. Mettez votre secret de signature dans la ligne const SECRET.
4. Choisissez Déployer, Nouveau déploiement, type Application Web, exécutée en votre nom, accessible à tous. Copiez l'URL de l'application Web.
5. Ajoutez-la comme connexion et cochez Mettre la signature dans le corps (pour Google Apps Script).

Le script vérifie la signature, ignore une réponse qu'il a déjà, et ajoute une apostrophe devant tout texte qui commence par =, +, - ou @ : une réponse ne peut donc jamais s'exécuter comme une formule dans votre feuille.

Enregistrer le PDF dans Google Drive ou Dropbox

Cochez Inclure un lien vers le PDF. Chaque réponse arrive alors avec document.url, un lien privé valable 24 heures et 5 téléchargements. Dans Zapier, ajoutez une étape Google Drive ou Dropbox Upload File et donnez-lui ce lien comme fichier. Dans Make, ajoutez HTTP, Get a file, puis le module d'envoi. Les copies enregistrées là-bas échappent aux réglages de suppression de Fillfold (voir la confidentialité et les conditions).

Vérifier la signature

Chaque requête porte un en-tête Fillfold-Signature: t=1761400000,v1=.... Calculez un HMAC-SHA256 de t, d'un point et du corps brut, avec votre secret de signature comme clé, et comparez-le à v1. Refusez les requêtes de plus de 5 minutes. Une réponse envoyée deux fois garde le même id.

Si les envois échouent

Un envoi en échec est retenté pendant environ 2 jours. Après 3 envois abandonnés d'affilée, la connexion est désactivée et vous recevez un e-mail. Corrigez l'adresse, envoyez un test, puis réactivez-la.