Webhook Lead — envoyez chaque lead vers votre outil
Configurez un webhook d'équipe pour recevoir une copie de chaque lead entrant dans votre propre outil (Google Sheet, CRM…), en parallèle du transfert vers les réseaux.
Mis à jour le 16 juin 2026
En plus de transférer les leads aux réseaux, vous pouvez aussi en faire arriver une copie vers votre propre outil — un Google Sheet, votre CRM, une automatisation. Vous configurez une seule URL, et RoyLead vous y envoie les données à chaque lead entrant. Cela fonctionne en parallèle du transfert réseau : ça ne le ralentit pas et ne le remplace pas.
Ouvrez votre équipe et allez dans l'onglet Transfert des leads :
📌 La section n'apparaît que pour les équipes Media Buyer et ne peut être modifiée que par le owner et les admins. C'est une URL par équipe.
Étape 1 — Préparez l'URL de votre outil
Le webhook envoie une requête POST avec des données JSON. Un Google Sheet ne peut pas la recevoir tout seul : il vous faut un récepteur intermédiaire qui transforme ces données en lignes de feuille de calcul. Les options les plus courantes :
- Google Apps Script — vous publiez un script comme "Web app" et obtenez une URL
…/exec. Gratuit. - Zapier / Make / n8n — vous créez un déclencheur "Webhook" et obtenez une URL à coller.
Configurez le récepteur pour écrire les champs dont vous avez besoin (voir ci-dessous ce que nous envoyons), puis copiez son URL.
⚠️ L'URL doit être en https. Une URL
httpou invalide est rejetée.
Étape 2 — Collez l'URL et lancez le Test
Dans la section Webhook Lead, collez l'URL dans le champ, puis cliquez sur Tester.
RoyLead envoie un lead d'exemple vers votre URL. Si vous voyez Webhook accessible, le récepteur fonctionne : passez à l'Étape 3. Si vous voyez une erreur, vérifiez que l'URL est correcte et que le récepteur est publié/actif.
Étape 3 — Enregistrez
Cliquez sur Enregistrer. À partir de maintenant, chaque lead qui entre dans l'équipe est envoyé vers votre URL.
Pour désactiver le webhook à tout moment, videz le champ et enregistrez.
Ce qui est envoyé
Pour chaque lead, RoyLead envoie ce JSON en POST :
{
"leadId": "lead_a1b2c3...",
"status": "pending",
"rejectionReason": null,
"campaignName": "Nom de la campagne",
"landingPageName": "Nom de la landing",
"country": "IT",
"createdAt": "2026-06-16T10:00:00.000Z",
"formData": { "nome": "Mario", "cognome": "Rossi", "telefono": "+393331234567", "email": "[email protected]" }
}
| Champ | Ce qu'il contient |
|---|---|
leadId | ID unique du lead dans RoyLead |
status | Statut : pending, rejected, duplicate, error… |
rejectionReason | Motif du rejet, le cas échéant (sinon null) |
campaignName / landingPageName | Campagne et landing d'origine |
country | Pays du lead |
createdAt | Date/heure d'entrée (format ISO) |
formData | Tous les champs remplis dans le formulaire |
Quels leads vous recevez
Vous recevez tous les leads entrant dans l'équipe : valides, rejetés, doublons et erreurs de configuration. Vous voyez ainsi votre volume brut complet.
🔒 Les soumissions de bots (elles remplissent le piège anti-spam) ne sont pas envoyées : c'est du trafic automatisé, pas de vrais leads, et ça polluerait votre feuille.
Ne le confondez pas avec le Webhook Token
Ce sont deux choses différentes :
- Webhook Lead (ce guide) : RoyLead envoie les leads vers votre outil.
- Webhook Token (dans Paramètres → Identifiants réseau) : le réseau envoie à RoyLead les mises à jour de statut (approuvé/rejeté).
Résolution de problèmes
| Ce qui se passe | Cause probable | Solution |
|---|---|---|
| Le test renvoie une erreur | URL incorrecte ou récepteur non publié | Revérifiez l'URL ; publiez/activez le récepteur |
| L'URL n'est pas acceptée à l'enregistrement | Pas en https ou invalide | Utilisez une URL complète https://… |
| Je ne vois pas la section Webhook Lead | Permissions ou type d'équipe | Seuls les owners/admins des équipes Media Buyer la voient |
| Les données arrivent mais n'atteignent pas la feuille | Le récepteur ne mappe pas les champs | Corrigez le script/Zap qui écrit les lignes |
En résumé
💡 Préparez un récepteur (Apps Script/Zapier), collez son URL https dans Transfert des leads → Webhook Lead, lancez Tester puis Enregistrer. À partir de là, chaque lead vous parvient aussi, en temps réel.
Prêt à passer à la pratique ?
Crée ton compte RoyLead et démarre en quelques minutes.