![Logo Eldo blanc.png]](https://aide.eldo.com/hs-fs/hubfs/Logo%20Eldo%20blanc.png?height=40&name=Logo%20Eldo%20blanc.png){kind=small}
Table des matières
- Qu'est-ce qu'un webhook ?
- Pourquoi utiliser les webhooks Oplead ?
- Événements disponibles
- Cas d'usage concrets
- Configurer un webhook depuis l'interface Oplead
1. Qu'est-ce qu'un webhook ?
Un webhook, c'est une notification automatique qu'Oplead envoie à votre système dès qu'un événement se produit.
Analogie : C'est comme activer les notifications push sur votre téléphone. Plutôt que d'ouvrir l'application toutes les 5 minutes pour voir s'il y a du nouveau, vous recevez une alerte dès qu'il se passe quelque chose.
Techniquement, quand un événement défini se produit dans Oplead (ex. : un lead change de statut), Oplead envoie automatiquement une requête HTTP POST vers l'URL de votre choix, avec toutes les données du lead concerné.
La différence avec une API classique :
| API classique (polling) | Webhook |
|---|---|
| Vous interrogez Oplead régulièrement | Oplead vous prévient en temps réel |
| Charge serveur constante | Déclenchement uniquement à l'événement |
| Risque de données manquées entre deux appels | Notification immédiate et fiable |
2. Pourquoi utiliser les webhooks Oplead ?
Les webhooks permettent de synchroniser Oplead avec vos outils sans développement lourd ni interrogation permanente de l'API.
Exemples de ce que vous pouvez automatiser :
- Déclencher une action dans votre ERP externe dès qu'un lead est affecté
- Lancer une séquence de SMS ou WhatsApp dès qu'un lead entre en qualification avec Eldo Agent
- Mettre à jour un tableau de bord externe en temps réel
- Notifier votre équipe sur Slack lors d'un changement de statut important
3. Événements disponibles
Oplead déclenche un webhook sur 6 événements liés au cycle de vie des leads :
| Nom de l'événement | Déclencheur |
|---|---|
lead.attributed |
Un lead est affecté à un commercial |
lead.status_changed |
Le statut d'un lead change (ex. : A traiter → En cours - RDV) |
lead.rdv_updated |
Le rendez-vous d'un lead est mis à jour (date, heure, annulation…) |
lead.qualification_new |
Un nouveau lead entre dans le pipeline de qualification |
lead.follow_new |
Un nouveau lead entre dans le pipeline de suivi |
lead.qualification_status_change |
Le statut de qualification d'un lead change (à qualifier -> à rappeler |
Vous pouvez vous abonner à un ou plusieurs événements par webhook. Un même webhook peut écouter plusieurs événements simultanément.
4. Cas d'usage concrets
Eldo Agent — Qualification automatique par SMS/WhatsApp
C'est l'usage le plus puissant des webhooks Oplead aujourd'hui.
Scénario :
- Un nouveau lead est créé et entre dans le module de qualification Oplead
- Oplead envoie immédiatement un webhook
lead.qualification_newà Eldo Agent - Eldo Agent démarre automatiquement une séquence de qualification via SMS ou WhatsApp auprès du contact
- À l'issue de la conversation, Eldo Agent met à jour le statut du lead directement dans Oplead
Résultat : Aucun commercial n'a à intervenir sur la première prise de contact — le lead est qualifié, classifié et mis à jour automatiquement. Un gain de temps énorme et un taux de transformation boosté!
Autres exemples
Synchronisation ERP externe ou ou intranet
- Événement :
lead.attributed - Action : Créer ou mettre à jour le contact dans votre outil (ERP, intranet...) avec le nom du commercial assigné
Séquence email automatisée
- Événement :
lead.follow_new - Action : Inscrire le lead dans une séquence d'emails de bienvenue dans votre outil d'emailing
Synchronisation outil de devis
- Événement :
lead.status_changed - Action : Créer automatiquement un projet dans votre outil de devis en ligne lorsque le lead passe en statut "Devis à faire"
5. Configurer un webhook depuis l'interface Oplead
La gestion des webhooks est accessible depuis Paramètres ⚙️ > Webhooks.
Vue d'ensemble
La page affiche la liste de tous vos webhooks avec :
- La date de création
- Le nom du webhook
- Le statut (Actif / Inactif)
- Un lien Détails pour consulter ou modifier
Créer un nouveau webhook
Cliquez sur le bouton + en haut de la page pour ouvrir le formulaire d'ajout.
Champs à renseigner :
| Champ | Description |
|---|---|
| Nom du webhook | Un identifiant libre pour reconnaître ce webhook (ex. : eldo-agent-qualification) |
| Configuration | Cochez un ou plusieurs événements à écouter |
| URL de destination | L'URL https:// vers laquelle Oplead enverra les données |
L'URL doit obligatoirement être en HTTPS. Le préfixe
https://est imposé automatiquement.
Modifier un webhook existant
Cliquez sur Détails sur la ligne du webhook concerné.
Le panneau d'édition vous permet de :
- Activer ou désactiver le webhook (toggle Oui / Non)
- Modifier le nom, les événements écoutés, l'URL de destination
- Copier la clé secrète (bouton dédié) — cette clé sert à authentifier les webhooks côté réception sur votre outil qui exploite les informations envoyées par Oplead.
- Supprimer le webhook (menu ⋮ > Supprimer)
Ce qu'il faut savoir
Pas de retry automatique : Si votre endpoint est temporairement indisponible au moment où Oplead envoie le webhook, la notification est perdue. Assurez-vous que votre URL de destination est fiable et disponible en permanence.
Timeout et erreurs : Oplead enregistre les tentatives d'envoi (succès et échecs) dans ses logs internes, mais ne renvoie pas automatiquement les webhooks en erreur.
Mode test : Lors de la configuration via l'API, le paramètre ?test=true permet de valider l'abonnement sans déclencher d'envoi réel — utile pour vérifier la configuration en environnement de développement.
Pour toute question technique, consultez la documentation API Oplead ici, ou la documentation technique des webhooks Oplead ici.