Weesify
Guides

Recevoir les réponses de formulaires sur Next.js, Node.js ou Python

Lecture de 6 min

Équipe WeesifyBlog Weesify ·

Gardez une copie signée de chaque réponse de formulaire dans votre propre application. Des récepteurs prêts à l’emploi pour Next.js, Node.js, Python, Laravel et PHP, et les quatre règles si vous écrivez le vôtre.

Beaucoup d’équipes veulent les réponses de leurs formulaires à deux endroits : dans Weesify, où la personne devient un contact et où les automatisations démarrent, et dans leur propre application, à côté de leurs clients, commandes ou tickets. Jusqu’ici, Weesify fournissait des récepteurs pour WordPress, PHP simple et Laravel. Cette version ajoute Next.js, Node.js et Python, et Weesify reconnaît désormais ces sites quand vous les connectez.

Ce guide explique comment connecter un site, choisir le bon récepteur, ce que le récepteur doit vérifier, et comment passer du stockage d’exemple à votre propre base de données.

Dans ce guide

  • Comment fonctionnent les copies
  • Connecter votre site
  • Choisir votre récepteur
  • Les quatre règles que suit chaque récepteur
  • Des fichiers JSON à votre base de données
  • Tester et passer en production
  • D’autres façons de récupérer les réponses

Comment fonctionnent les copies

Weesify enregistre toujours chaque réponse en premier. Quand l’option Garder une copie sur ce site est activée sur un formulaire, Weesify envoie ensuite une copie à votre site sous forme de requête HTTPS signée. Votre récepteur vérifie la signature, enregistre la copie une seule fois et répond qu’elle est enregistrée. Ce n’est qu’alors que Weesify considère la copie comme livrée.

Si votre site est hors ligne ou répond par une erreur, Weesify réessaie pendant environ une journée, en espaçant de plus en plus les tentatives. L’écran Sites web montre pour chaque site les copies livrées, en attente, en cours de nouvel essai et en échec, pour que vous sachiez toujours où vous en êtes.

Formulaires › Sites web avec un site connecté, ses copies livrées, en attente et en cours de nouvel essai, les formulaires qui gardent une copie et les applications en dessous
Formulaires › Sites web avec un site connecté, ses copies livrées, en attente et en cours de nouvel essai, les formulaires qui gardent une copie et les applications en dessous

Connecter votre site

  1. Allez dans Formulaires › Sites web et cliquez sur Connecter un site.
  2. Saisissez l’adresse de votre site. Weesify examine sa page publique, reconnaît les sites WordPress, Laravel, Next.js, Node.js, Python et PHP simple, et propose la bonne adresse de réception, par exemple /api/weesify pour Next.js.
  3. Copiez le secret de signature. Il n’est affiché qu’une fois. Gardez-le sur votre serveur dans une variable d’environnement appelée WEESIFY_SECRET, jamais dans une page web ni dans votre dépôt de code.
  4. Téléchargez le récepteur de votre technologie depuis le même panneau.

Si Weesify ne peut pas déterminer comment votre site est construit, choisissez Mon propre serveur et saisissez l’adresse vous-même. Toute technologie capable de recevoir un POST HTTPS convient.

Choisir votre récepteur

Next.js (App Router). Enregistrez route.ts sous app/api/weesify/route.ts. Il tourne sur le runtime Node.js, lit le corps brut, vérifie la signature et répond en JSON. Un emplacement clairement indiqué attend votre appel à la base de données, avec Prisma, Drizzle, Supabase ou ce que vous utilisez déjà.

Node.js. weesify-receiver.mjs nécessite Node 18 ou plus récent et aucun paquet. Lancez-le seul derrière HTTPS, ou montez-le dans Express avec app.post('/weesify/receive', weesifyExpress()). Ne mettez pas de parseur de corps JSON sur cette route : la signature est vérifiée sur les octets exacts envoyés par Weesify.

Python. weesify_receiver.py n’utilise que la bibliothèque standard, Python 3.8 ou plus récent. Lancez-le seul, ou appelez sa fonction handle() depuis une route Flask ou une vue Django. Dans Django, marquez la vue @csrf_exempt : c’est la signature qui la protège.

Laravel. WeesifyFormCopyController.php va dans app/Http/Controllers, avec une route dans routes/api.php et une petite table pour les copies. Le fichier montre les deux.

PHP. weesify-receiver.php fonctionne sur n’importe quel hébergement PHP 7.4+, y compris mutualisé. Téléversez-le et définissez le secret.

Chaque fichier s’explique en en-tête, pour que vous puissiez lire exactement ce qu’il fait avant qu’il n’approche votre serveur.

Les quatre règles que suit chaque récepteur

Si vous préférez écrire le vôtre, voici les seules choses qu’il doit faire.

1. Vérifier la signature. Chaque requête a deux en-têtes : X-Weesify-Timestamp (en secondes) et X-Weesify-Signature, qui vaut v1= suivi du HMAC-SHA256 en hexadécimal de timestamp.body calculé avec votre secret. Calculez la même valeur à partir du corps brut et comparez-la en temps constant.

2. Refuser les anciennes requêtes. Si l’horodatage s’écarte de plus de cinq minutes de l’horloge de votre serveur, répondez 401. Cela empêche de renvoyer plus tard une requête interceptée.

3. Répondre aux pings. Quand vous cliquez sur Tester dans Weesify, il envoie {"event": "ping"}. Répondez {"ok": true}.

4. Enregistrer chaque copie une seule fois. Une vraie copie contient "event": "submission.copy" et une idempotency_key. Enregistrez-la si vous n’avez jamais vu cette clé et répondez {"stored": true} ; sinon, répondez {"duplicate": true}. Les nouveaux essais réutilisent la même clé, donc une copie qui arrive deux fois n’est enregistrée qu’une fois.

Toute réponse autre qu’un 2xx avec stored ou duplicate est traitée comme « réessayer plus tard ». C’est voulu : si votre base de données est brièvement indisponible, répondre 500 signifie que Weesify garde la copie en attente au lieu de la perdre.

Nous testons ces règles sur nos propres récepteurs à chaque version : le signataire de Weesify produit une vraie requête, les fichiers Node.js et Python tournent comme ils le feraient sur votre serveur, et les vérifications ci-dessus doivent tenir, y compris le refus d’un horodatage périmé.

Des fichiers JSON à votre base de données

Les récepteurs PHP, Node.js et Python enregistrent chaque copie dans un fichier JSON d’un dossier privé, pour qu’ils fonctionnent dès leur téléversement. C’est suffisant pour un test ou un site à faible volume. Pour un usage réel, modifiez la fonction store() pour écrire une ligne dans votre base de données :

  • utilisez idempotency_key comme colonne unique, pour que la base refuse elle-même les doublons ;
  • conservez submission.id, la référence vers l’original dans Weesify ;
  • stockez answers en JSON, ou répartissez les questions qui vous intéressent dans leurs propres colonnes ;
  • files liste les fichiers envoyés avec leur nom et une adresse de téléchargement.

Le récepteur Next.js utilise un ensemble en mémoire plutôt que des fichiers, car la plupart des hébergeurs Next.js n’ont pas de disque permanent. Il est clairement indiqué comme non durable, avec un exemple commenté de l’appel à la base de données qui le remplace.

Tester et passer en production

  1. Déployez le récepteur avec WEESIFY_SECRET défini.
  2. Dans Formulaires › Sites web, cliquez sur Tester. Un « connecté » en vert signifie que la signature, l’horloge et le ping fonctionnent.
  3. Ouvrez un formulaire, allez dans Copies et activez Garder une copie sur ce site pour votre site.
  4. Envoyez le formulaire une fois vous-même et regardez la copie apparaître comme livrée.

Si le test échoue, le message explique pourquoi en termes simples : l’adresse était injoignable, la réponse n’était pas du JSON, ou la signature ne correspondait pas (le plus souvent un secret collé avec un espace en trop, ou un parseur de corps qui modifie les octets).

D’autres façons de récupérer les réponses

Les copies vers votre serveur sont une voie parmi d’autres, et vous pouvez en utiliser plusieurs à la fois :

  • Applications. Google Sheets, Airtable, Notion, HubSpot et Salesforce, chacune avec sa propre connexion, depuis le même écran Sites web.
  • Webhooks et API. Chaque réponse est un événement que vous pouvez envoyer n’importe où, et l’API lit les formulaires et les réponses. Notre article sur l’API et la CLI de Weesify présente les deux.
  • Assistants IA. Le serveur MCP de Weesify permet à un assistant que vous utilisez de lire vos formulaires et vos réponses et de préparer de nouveaux formulaires, avec un jeton que vous contrôlez.
Paramètres › Développeurs avec la carte Connecter un assistant IA : l’adresse MCP et trois étapes pour se connecter
Paramètres › Développeurs avec la carte Connecter un assistant IA : l’adresse MCP et trois étapes pour se connecter

Quelle que soit la voie choisie, Weesify garde l’original : vous pouvez désactiver une destination, la corriger et la réactiver sans perdre une seule réponse.

Recevez les nouveaux articles par e-mail

Les nouveaux articles de Blog Weesify, directement dans votre boîte de réception. Pas de spam, désabonnez-vous à tout moment.

En vous abonnant, vous acceptez de recevoir des e-mails de Blog Weesify. Désabonnez-vous à tout moment.

Commentaires

Aucun commentaire pour l’instant. Lancez la conversation.

Les commentaires apparaissent une fois approuvés par l’auteur.

Suivre

Les nouveaux articles arrivent dans votre lecteur de flux dès leur publication. Les changements de chaque version figurent dans le journal des modifications.