Comment intégrer Lead via webhook ?
L'intégration webhook de Lead vous permet de connecter vos formulaires externes (site web, Wix, landing pages publicitaires…) directement à votre pipeline de prospects. Chaque soumission de formulaire déclenche automatiquement la création d'une demande de contact ou d'essai dans Lead, sans intervention manuelle. Cette documentation s'adresse aux équipes techniques chargées de mettre en place cette intégration.
1. Comprendre les deux types de webhook
Lead propose deux endpoints distincts selon le type de demande à traiter :
- Demande de contact : un prospect souhaite être recontacté ou obtenir des informations sur votre club.
- Demande d'essai : un prospect souhaite bénéficier d'une séance ou d'une offre d'essai spécifique.
Les deux webhooks partagent la même URL de base et un fonctionnement identique, mais diffèrent sur certains champs obligatoires ou optionnels.
2. Envoyer une demande de contact
Endpoint
POST https://lead.masalledesport.com/api/lead/webhooks/clubEntry Champs obligatoires
| Champ | Type | Description |
|---|---|---|
apiKey |
Chaîne de caractère | Clé d'authentification de votre organisation (à demander au support Lead) |
club |
Chaîne de caractère | Identifiant de votre club |
email |
Chaîne de caractère | Adresse email du prospect |
lastname |
Chaîne de caractère | Nom de famille du prospect |
firstname |
Chaîne de caractère | Prénom du prospect |
Champs optionnels
| Champ | Type | Description |
|---|---|---|
gender |
Chaîne de caractère | Genre du prospect (M ou F) |
birthdate |
Chaîne de caractère | Date de naissance au format YYYY-MM-DD |
zipcode |
Chaîne de caractère | Code postal |
city |
Chaîne de caractère | Ville |
street |
Chaîne de caractère | Numéro et nom de la rue |
country |
Chaîne de caractère | Pays |
message |
Chaîne de caractère | Message libre du prospect |
source |
Chaîne de caractère | Origine du contact (voir valeurs possibles ci-dessous) |
utm_source |
Chaîne de caractère | Source de la campagne publicitaire |
utm_campaign |
Chaîne de caractère | Identifiant de la campagne |
utm_medium |
Chaîne de caractère | Canal d'acquisition |
isWix |
Chaîne de caractère | Indiquer "true" si le formulaire est hébergé sur Wix |
Valeurs acceptées pour le champ source
GOOGLE · META_ADS · MSDS_EXTERN_REFERER · MSDS · WEBSITE_FORM · WIDGET · ACTIVE_CAMPAIGN · TYPEFORM · AGENCE · EXO · VEL
Exemple de requête cURL
curl --request POST \
--url https://lead.masalledesport.com/api/lead/webhooks/clubEntry \
--header 'content-type: application/json' \
--data '{
"apiKey": "XXXXXXXX",
"club": "NOM_DU_CLUB",
"firstname": "Sarah",
"lastname": "Connor",
"email": "sarah.connor@example.com",
"message": "Ceci est un message de test"
}'
3. Envoyer une demande d'essai
Endpoint
POST https://lead.masalledesport.com/api/lead/webhooks/clubEntry Champs obligatoires
| Champ | Type | Description |
|---|---|---|
apiKey |
Chaîne de caractère | Clé d'authentification de votre organisation (à demander au support Lead) |
club |
Chaîne de caractère | Identifiant de votre club |
email |
Chaîne de caractère | Adresse email du prospect |
offername |
Chaîne de caractère | Nom de l'offre d'essai concernée |
lastname |
Chaîne de caractère | Nom de famille du prospect |
firstname |
Chaîne de caractère | Prénom du prospect |
Champs optionnels spécifiques à la demande d'essai
En plus des champs optionnels communs (coordonnées, UTM, source…), ce webhook accepte :
| Champ | Type | Description |
|---|---|---|
phone |
Chaîne de caractère | Numéro de téléphone (utilisé pour la création du prospect si nécessaire) |
source_url |
Chaîne de caractère | URL de la page hébergeant le formulaire (affichée dans l'activité Lead) |
4. Gérer les champs personnalisés
Vous pouvez transmettre dans le payload des champs qui ne font pas partie de la liste officielle. Ces champs ne seront pas interprétés par Lead, mais seront visibles dans l'activité du prospect, dans le bloc Message, au format clé : valeur.
Cela vous permet de transmettre des données contextuelles supplémentaires (numéro de campagne interne, identifiant CRM tiers, etc.) sans perturber le traitement de la demande.
5. Cas particulier : formulaires Wix
Si vos formulaires sont hébergés sur la plateforme Wix, vous devez ajouter le paramètre suivant à votre payload :
"isWix": "true" Ce paramètre indique à Lead que la requête provient d'un formulaire Wix, afin qu'elle soit traitée correctement par l'automatisation correspondante.
6. Obtenir votre clé API
La clé apiKey est propre à votre organisation et nécessaire pour authentifier chaque requête. Pour l'obtenir, contactez l'équipe support Lead. Elle vous communiquera également la valeur à utiliser pour le champ club.