Aller au contenu
Aide

Toutes les pages de l’aide

Webhooks

Envoyer chaque réponse à votre CRM, à Zapier, à Make ou à votre serveur.

À partir de l'offre Starter, un webhook envoie chaque nouvelle réponse en temps réel à l'adresse de votre choix : un CRM, un outil d'automatisation (Zapier, Make, n8n) ou votre propre application.

Ajouter un webhook

  1. Dans l'éditeur, ouvrez l'onglet Intégrations, carte Webhooks.
  2. Collez l'adresse (en https://) fournie par votre outil.
  3. Conservez la Clé de signature affichée. Elle permet de vérifier que les envois proviennent bien de Canard Form.

Le journal de chaque webhook affiche les dernières livraisons, leur résultat et le code de réponse de votre outil.

Un formulaire peut avoir 1 webhook avec l'offre Starter et jusqu'à 3 avec l'offre Pro. Si vous passez à une offre qui en accepte moins, rien n'est supprimé : seuls les plus anciens, dans la limite de l'offre, continuent de recevoir les réponses.

Contenu envoyé

Chaque réponse est envoyée dans une requête POST au format JSON. Elle contient l'identifiant de l'événement, son type (submission.created), le formulaire, la version et les réponses. Les fichiers sont fournis sous forme de lien de téléchargement temporaire.

POST /votre-adresse HTTP/1.1
Content-Type: application/json
User-Agent: CanardForm-Webhook/1.0
Canard-Event: submission.created
Canard-Delivery: 01a1c9f2-7b3e-7d10-9a4c-5e2f8b6d1c03
Canard-Signature: t=1795003512,v1=5f1c0e9a…
{
    "id": "01a1c9f2-6e8a-7f42-b1d5-0c3a9e7f2b18",
    "type": "submission.created",
    "created_at": "2026-11-18T09:25:12+00:00",
    "data": {
        "submission": {
            "id": "01a1c9f2-6d31-7c55-8e0b-4f9a2d6c3e71",
            "form_id": "01a1c446-57f6-70ea-9d46-09d5096e3fc9",
            "form_version": 3,
            "created_at": "2026-11-18T09:25:11+00:00",
            "locale": "fr",
            "answers": {
                "nom": "Camille Martin",
                "email": "camille@exemple.fr",
                "sujet": "devis",
                "options": ["livraison", "montage"],
                "budget": 1500,
                "accord": true,
                "source": "newsletter"
            },
            "files": [
                {
                    "field": "plan",
                    "name": "plan-cuisine.pdf",
                    "size": 482113,
                    "mime": "application/pdf",
                    "sha256": "9f2b5c…",
                    "status": "clean",
                    "url": "https://canardform.app/v1/attachments/01a1c9f2-…?expires=1795004412&signature=…"
                }
            ]
        }
    }
}
  • id identifie l'événement : il reste le même si l'envoi est retenté. Gardez-le pour ne pas traiter deux fois la même réponse.
  • answers utilise les clés des champs (visibles dans les Réglages avancés de l'éditeur). Un champ laissé vide n'y figure pas. Une liste ou un choix unique donne la valeur de l'option, un choix multiple une liste de valeurs, un nombre un nombre, une case à cocher true ou false.
  • files décrit les fichiers envoyés. Le lien url est valable 15 minutes : téléchargez le fichier dès la réception. Il vaut null tant que le fichier n'est pas sain (status : infected ou scan_failed). Quand l'antivirus est actif, l'envoi attend la fin de l'analyse, 15 minutes au plus.

Vérifier la signature

Chaque envoi contient un en-tête Canard-Signature: t=<horodatage>,v1=<signature>. La signature est un HMAC-SHA256 de <horodatage>.<corps de la requête>, calculé avec votre clé de signature.

  1. Recalculez la signature et comparez-la à celle de l'en-tête.
  2. Refusez la requête si l'horodatage est trop ancien (plus de 5 minutes, par exemple).

Exemple en Node.js :

import crypto from 'node:crypto';

function verify(rawBody, header, secret) {
    const { t, v1 } = Object.fromEntries(
        header.split(',').map((part) => part.split('=')),
    );
    const expected = crypto
        .createHmac('sha256', secret)
        .update(`${t}.${rawBody}`)
        .digest('hex');
    const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;

    return (
        fresh &&
        v1.length === expected.length &&
        crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected))
    );
}

Calculez la signature sur le corps brut de la requête, avant tout décodage du JSON.

Échecs et nouvelles tentatives

Si votre outil ne répond pas ou renvoie une erreur, Canard Form renvoie la requête plusieurs fois, à intervalles de plus en plus longs. Après 48 heures d'échecs consécutifs, le webhook est désactivé. Une fois votre outil réparé, vous pouvez le réactiver en un clic. L'historique des livraisons est conservé 30 jours.

Pour des raisons de sécurité, seules les adresses publiques en HTTPS sont acceptées.