Webhooks

Dès 2027, Recevez les données en temps réel sur votre serveur via des webhooks.

Qu'est-ce qu'un webhook ?

Un webhook est une URL que FlayData Analytics appelle automatiquement à chaque événement (nouvelle soumission, modification, etc.).

Configurer un webhook

  1. Allez dans Workspace > Intégrations
  2. Ajoutez une intégration de type "Webhook"
  3. Entrez l'URL de votre serveur
  4. Optionnel : ajoutez une clé secrète pour signer les requêtes
  5. Activez le webhook

Événements disponibles

ÉvénementDéclencheur
submission.createdNouvelle soumission
submission.updatedSoumission modifiée
submission.reviewedSoumission validée/rejetée
project.publishedProjet publié
project.unpublishedProjet dépublié
analysis.completedAnalyse terminée

Format du payload

{
    "event": "submission.created",
    "submission": {
        "id": "uuid-xxxx",
        "data": [...],
        "submitted_at": "2026-06-25T12:00:00Z"
    },
    "project": {
        "id": 1,
        "name": "Enquête satisfaction"
    },
    "timestamp": "2026-06-25T12:00:01Z"
}

Vérification de la signature

Si vous avez configuré une clé secrète, chaque requête inclut un en-tête X-Signature :

X-Signature: sha256=abcd1234...

Vérifiez la signature côté serveur :

$payload = file_get_contents('php://input');
$signature = hash_hmac('sha256', $payload, 'votre-clé-secrète');
if (hash_equals($signature, $_SERVER['HTTP_X_SIGNATURE'])) {
    // Requête valide
}

Tester un webhook

Utilisez un service comme webhook.site pour tester vos webhooks avant de les mettre en production.

Cas d'usage : Envoyez chaque nouvelle soumission vers votre CRM, déclenchez un email automatique, ou mettez à jour un tableau de bord en temps réel.