---
title: "Envoyer des données vers vos systèmes avec les webhooks"
description: "Recevez une requête sur votre propre URL quand quelqu’un s’inscrit ou gagne, avec un payload signé et un journal de chaque livraison."
url: https://scratcher.io/fr/help/developers/webhooks
language: fr
---

1. [Centre d’aide](https://scratcher.io/fr/help)
2. [API, webhooks et MCP](https://scratcher.io/fr/help/developers)
3. Envoyer des données vers vos systèmes avec les webhooks

# Envoyer des données vers vos systèmes avec les webhooks

Recevez une requête sur votre propre URL quand quelqu’un s’inscrit ou gagne, avec un payload signé et un journal de chaque livraison.

Un webhook envoie des données vers une URL de votre choix dès qu’un événement se produit, par exemple quand quelqu’un s’inscrit ou gagne un lot. Votre développeur met en place le système qui les reçoit. Les webhooks sont inclus à partir du forfait Basic.

## Ajouter un webhook

Vous pouvez ajouter des webhooks à une campagne, dans l’éditeur sous **Connecter** > **Webhooks**, ou pour tout votre compte sous **Paramètres** > **Webhooks**.

1. Cliquez sur **Ajouter un webhook**.
2. Saisissez l’**URL du payload**. Elle doit utiliser HTTPS.
3. Choisissez le **Type de contenu** : application/json ou application/x-www-form-urlencoded.
4. Choisissez la **Méthode** : **POST** ou **GET**. Utilisez POST, sauf si votre système exige GET, qui envoie les données dans l’URL.
5. Saisissez un **Secret** pour signer les requêtes (recommandé).
6. Choisissez les événements sous **Quels événements doivent déclencher le webhook ?** :
    - « Lorsqu’un nouveau lead est créé » (au niveau du compte)
    - « Chaque fois qu’un lead participe à une campagne »
    - « Lorsqu’un lead gagne un lot »
7. Vérifiez que **Active** est activé et enregistrez.

Dans l’éditeur de campagne, vous pouvez aussi choisir **Basic Auth** sous **Authentification**, et utiliser **Payload personnalisé** pour définir vous-même les noms des champs.

## Ce qui est envoyé

Le corps contient un `event` et un objet `data` avec la campagne (id et nom), les champs du lead, le canal, les consentements avec le texte, l’heure et l’adresse IP, les réponses au quiz et, pour les gagnants, le lot avec son code. Les valeurs vides sont omises.

## Vérifier la signature

Si vous avez défini un secret, chaque requête comporte un en-tête `X-Hub-Signature` : `sha1=` suivi d’un HMAC-SHA1 des données encodées en JSON, avec votre secret comme clé. Calculez la même valeur de votre côté et comparez, pour être sûr que la requête vient bien de Scratcher.

## Livraisons et nouvelles tentatives

Si votre URL ne répond pas ou renvoie une erreur, Scratcher réessaie deux fois : après 5 secondes, puis après une minute. Cliquez sur **Afficher les livraisons** (ou **Voir les livraisons**) pour voir chaque requête et sa réponse, n’afficher que les échecs et **Réessayer** une livraison. Les livraisons sont conservées 60 jours.

Activez **Journaliser le corps de la réponse** pour enregistrer aussi la réponse de votre système, ce qui aide au débogage.

API, webhooks et MCP

- [Bien démarrer avec l’API REST](https://scratcher.io/fr/help/developers/rest-api)
- [Envoyer des données vers vos systèmes avec les webhooks](https://scratcher.io/fr/help/developers/webhooks)
- [Le MCP Scratcher pour vos propres outils IA](https://scratcher.io/fr/help/developers/mcp)

## Articles associés

- [Bien démarrer avec l’API REST](https://scratcher.io/fr/help/developers/rest-api): Créez un jeton d’accès, choisissez les portées et lisez les campagnes, les leads et les listes depuis vos propres systèmes.
- [Vérifier le statut de livraison et renvoyer des leads](https://scratcher.io/fr/help/integrations/delivery-status): Voyez quels leads ont été envoyés vers vos outils, découvrez pourquoi une livraison a échoué et renvoyez-la.
- [Connecter plus de 8 000 applications avec Zapier](https://scratcher.io/fr/help/integrations/zapier): Envoyez les nouveaux inscrits de Scratcher vers Google Sheets, Slack, votre CRM ou des milliers d’autres applications avec Zapier.

## Besoin d’aide supplémentaire ?

De vraies personnes sont là pour vous aider. Si vous utilisez déjà Scratcher, le plus rapide est le chat dans la plateforme.

- **[Discutez avec nous](https://platform.scratcher.io/login)**

    Connectez-vous et cliquez sur le bouton de chat en bas à droite. Rex répond immédiatement, et notre équipe est à un clic.
- **[Prenez rendez-vous](https://scratcher.io/fr/book-a-meeting)**

    Un appel vidéo gratuit de 30 minutes avec notre équipe : une démonstration, des idées de campagnes ou de l’aide pour votre configuration.
- **[Écrivez-nous](mailto:contact@scratcher.io)**

    Écrivez à contact@scratcher.io et nous vous répondrons.