Qu'est-ce qu'un webhook et pourquoi l'utiliser ?

Un webhook est une notification HTTP envoyée automatiquement par Metrikia quand un événement se produit. Au lieu de vérifier régulièrement vos données (polling), vous recevez l'information en temps réel, dès qu'un lead est créé, un deal est gagné, ou une synchronisation se termine.

Cas d'usage typiques :

Recevoir une notification Slack quand un deal est gagné
Créer automatiquement un événement dans votre calendrier quand un lead est qualifié
Synchroniser les leads Metrikia avec un CRM non supporté nativement
Déclencher un email de bienvenue quand un nouveau lead arrive
Alimenter votre BI en temps réel

Événements disponibles

Événement	Déclencheur	Utilisation typique
lead.created	Un nouveau lead est créé dans le CRM	Notification équipe, sync CRM externe
lead.status_changed	Le statut d'un lead change	Workflow automation, alertes qualifié
deal.created	Un nouveau deal est créé	Mise à jour pipeline, alerte manager
deal.won	Un deal est marqué comme gagné	Notification célébration, facturation
deal.lost	Un deal est marqué comme perdu	Analyse des pertes, suivi relance
sync.completed	Une synchronisation ADS se termine	Refresh BI, vérification données
sync.failed	Une synchronisation ADS échoue	Alerte ops, diagnostic

Configuration pas à pas

1. Créer un endpoint de réception

Votre serveur (ou un service tiers comme Zapier, Make, n8n) doit exposer un endpoint HTTP(S) qui accepte les requêtes POST.

Exemple d'URL :

POST https://votre-serveur.com/webhooks/metrikia

L'endpoint doit :

Accepter le Content-Type: application/json
Retourner un code 200 dans les 10 secondes
Valider la signature HMAC (fortement recommandé pour la sécurité)

2. Enregistrer le webhook dans Metrikia

Allez dans Paramètres > Intégrations > Webhooks
Cliquez sur + Nouveau webhook
URL : l'adresse de votre endpoint
Événements : cochez les événements qui vous intéressent
Secret : entrez un secret pour la validation HMAC (32 caractères minimum recommandé)
Cliquez sur Sauvegarder

3. Tester votre webhook

Cliquez sur le bouton Tester à côté de votre webhook. Metrikia envoie un événement de test à votre endpoint. Vérifiez dans vos logs que vous recevez bien les données.

> Astuce pro : Utilisez un service comme webhook.site ou RequestBin pour tester votre webhook avant de le configurer sur votre serveur de production.

Structure du payload

Chaque webhook envoie un JSON avec la structure suivante :

event : type d'événement (ex: "lead.created")
timestamp : date/heure ISO 8601 (ex: "2026-03-12T14:30:00Z")
data : données de l'événement (variable selon le type)

Payload lead.created

L'objet data contient : id, firstName, lastName, email, phone, status, source, createdAt, assignedTo.

Payload deal.won

L'objet data contient : id, title, amount, currency, leadId, leadName, source, closedAt, dealLines.

Sécurité : validation HMAC

Chaque requête inclut un header X-Webhook-Signature contenant la signature HMAC-SHA256 du body avec votre secret.

Pour valider côté serveur :

Récupérez le body brut (pas parsé) de la requête
Calculez le HMAC-SHA256 avec votre secret
Comparez le résultat avec le header X-Webhook-Signature
Rejetez la requête si la signature ne correspond pas

Bonnes pratiques de sécurité :

Toujours utiliser HTTPS : ne configurez jamais un webhook en HTTP non chiffré
Toujours valider le HMAC : un webhook sans validation peut recevoir des requêtes frauduleuses
Répondez rapidement : retournez 200 en moins de 10 secondes, traitez le contenu en asynchrone
Gérez les doublons : un même événement peut être envoyé plusieurs fois en cas de timeout, implémentez l'idempotence
Loguez tout : gardez une trace des webhooks reçus pour faciliter le debug

Intégrations sans code

Zapier

Créez un nouveau Zap avec le trigger "Webhooks by Zapier" > "Catch Hook"
Copiez l'URL du webhook Zapier
Configurez cette URL dans Metrikia (Paramètres > Webhooks)
Testez l'envoi depuis Metrikia
Ajoutez les actions souhaitées dans Zapier (Slack, Email, Google Sheets, etc.)

Make (ex-Integromat)

Créez un nouveau scénario avec le module "Webhooks" > "Custom webhook"
Copiez l'URL fournie par Make
Configurez cette URL dans Metrikia
Make détectera automatiquement la structure des données au premier envoi
Ajoutez les modules d'action (CRM, Slack, Email, etc.)

n8n

Créez un nouveau workflow avec le node "Webhook"
Configurez le chemin et la méthode POST
Copiez l'URL complète du webhook n8n
Configurez cette URL dans Metrikia
Ajoutez les nodes de traitement et d'action

Dépannage

Je ne reçois pas les webhooks :

Vérifiez que votre endpoint est accessible publiquement (pas derrière un VPN ou firewall)
Testez l'URL avec un outil comme curl depuis l'extérieur
Consultez les logs d'envoi dans Paramètres > Webhooks > Historique

Les webhooks arrivent en retard :

En cas de charge, un délai de quelques secondes est normal
Si le retard dépasse 1 minute, consultez la page Statut Metrikia
Vérifiez que votre endpoint répond en moins de 10 secondes

Erreurs 401/403 :

Votre endpoint nécessite peut-être une authentification HTTP
Metrikia n'envoie pas de credentials d'authentification, utilisez le HMAC à la place
Vérifiez les règles de votre WAF ou firewall

Webhook désactivé automatiquement :

Après 10 échecs consécutifs, Metrikia désactive automatiquement le webhook
Corrigez le problème côté serveur et réactivez le webhook dans les Paramètres

Configurer les webhooks