Données, CRM et conformité

API ou webhook : comment connecter un flux de leads ?

Option A

API

Interface appelée à la demande pour lire, créer ou modifier des ressources selon un contrat.

Option B

Webhook

Requête envoyée automatiquement à un destinataire lorsqu'un événement défini se produit.

Une API permet à un système de demander ou modifier des données lorsqu'il le décide ; un webhook pousse automatiquement un événement vers une URL lorsqu'il survient. L'API convient à la consultation, la synchronisation et les commandes ; le webhook réduit la latence des notifications. Une intégration fiable utilise souvent le webhook pour signaler et l'API pour vérifier ou compléter.

Matrice différentielle

Critère	API	Webhook
Déclencheur	Le client appelle	Le producteur pousse
Sens	Lecture et écriture possibles	Notification principalement unidirectionnelle
Latence	Dépend de la fréquence d'appel	Proche du temps réel
Données manquées	Récupérables par requête	Nécessitent reprise et journal
Sécurité	Authentification et autorisation	Signature, secret et anti-rejeu
Charge	Polling potentiellement coûteux	Pics lors des événements

Quel choix selon votre situation ?

Recommandé : API

Vous devez rechercher, filtrer ou corriger des leads

Le client choisit les ressources et actions, avec pagination, paramètres et réponses structurées adaptées aux opérations.

Recommandé : Webhook

Vous devez prévenir le CRM dès qu'un lead est prêt

L'événement est poussé sans attendre un prochain cycle de polling, ce qui réduit le délai de prise en charge.

Recommandé : Les deux

La livraison ne doit perdre aucun événement

Le webhook déclenche rapidement ; l'API permet d'accuser, relire, réconcilier et reprendre les éléments absents ou échoués.

Croire qu'un code 200 prouve le traitement

La réponse confirme seulement que l'endpoint a accepté la requête selon son contrat. Utilisez un identifiant idempotent, un accusé métier, des reprises limitées, une file d'erreur et une réconciliation périodique.

Sources vérifiées

About webhooks (GitHub Docs)

Questions fréquentes

Ce que l'on nous demande sur cet arbitrage

Quelle différence entre API et Webhook ?

Quand choisir API ?

Vous devez rechercher, filtrer ou corriger des leads : Le client choisit les ressources et actions, avec pagination, paramètres et réponses structurées adaptées aux opérations.

Quand choisir Webhook ?

Vous devez prévenir le CRM dès qu'un lead est prêt : L'événement est poussé sans attendre un prochain cycle de polling, ce qui réduit le délai de prise en charge.

Peut-on combiner API et Webhook ?

Oui. C'est même la combinaison recommandée pour un flux critique : webhook signé pour l'événement, API authentifiée pour l'état, les corrections et la reprise. Documentez versions, limites de débit et codes d'erreur.

Appliqué à Prospect.fr

Prospect.fr envoie un webhook idempotent lors de la livraison et expose l'état via API afin que l'acheteur puisse rapprocher chaque lead et chaque tentative.

Créer ma campagne Tous les comparatifs

Notions du lexique employées

Journal d’événements Reprise sur erreur webhook API de leads Webhook

Rédigé par Rédaction Prospect.fr · Dernière revue le 2026-08-28

Comparatifs

Comparatifs liés