Webhook

Un webhook est un rappel HTTP qui envoie automatiquement des données d'une application à une autre lorsqu'un événement précis survient. Contrairement aux [API](/glossary/api) où tu interroges régulièrement pour obtenir des mises à jour, les webhooks envoient les données en temps réel à mesure que les événements se produisent. L'application réceptrice écoute à une URL de destination spécifiée et traite les données entrantes dès leur arrivée. Les webhooks suivent un modèle éditeur-abonné — l'application source (l'éditeur) déclenche une requête HTTP POST vers une URL préenregistrée chaque fois qu'un événement déclencheur a lieu, et l'abonné traite la charge utile sans jamais avoir à la demander.

Les webhooks éliminent le besoin de transferts de données manuels ou d'interrogations constantes entre les systèmes. Pour les éditeurs numériques, cela signifie que les prospects capturés, les transactions de vente et l'activité des lecteurs peuvent circuler automatiquement vers les CRM, les plateformes d'e-mailing ou les bases de données internes au moment même où ils surviennent. Cela réduit les délais de quelques minutes ou heures à quelques millisecondes, supprime le travail manuel d'export-import et garantit que tes systèmes métier disposent toujours de données à jour. Sans webhooks, les équipes consultent les tableaux de bord manuellement ou construisent des traitements par lots planifiés qui s'exécutent en décalage par rapport aux événements en temps réel.

La fonctionnalité [automatisation et intégrations](/features/automation-and-integrations) de FlipLink prend en charge les webhooks qui se déclenchent lors d'événements clés. Tu peux configurer des URL de destination pour recevoir des données lorsqu'un nouveau prospect est capturé, qu'un document est consulté ou qu'une vente est finalisée via Stripe. Chaque webhook envoie une charge utile JSON structurée contenant les détails de l'événement à l'URL que tu as spécifiée. Cela te permet de connecter FlipLink à pratiquement n'importe quel système, y compris des outils comme Zapier, Make ou des back-ends personnalisés. Combinés à l'[intégration Google Sheets](/features/automation-and-integrations), les webhooks offrent aux éditeurs un moyen souple d'automatiser l'ensemble de leur flux de publication sans écrire de code.

Lorsqu'un événement déclencheur survient, FlipLink envoie une requête HTTP POST à l'URL de destination que tu as enregistrée. Le corps de la requête contient une charge utile JSON structurée comme suit : - **Type d'événement** — une chaîne identifiant l'événement (par exemple, `lead.captured`, `document.viewed`, `sale.completed`) - **Horodatage** — date et heure de l'événement au format ISO 8601 - **Données de la charge utile** — les champs propres à l'événement, tels que le nom du contact, l'e-mail, le titre du document ou le montant de la transaction Ta destination doit renvoyer un code d'état HTTP 200 pour confirmer la réception. Si la destination renvoie une erreur ou dépasse le délai d'attente, FlipLink réessaie la livraison pour qu'aucun événement ne soit perdu. Toutes les charges utiles de webhook sont envoyées via HTTPS, donc les données sont chiffrées en transit. Pour les développeurs qui créent des intégrations personnalisées, la structure JSON cohérente facilite l'analyse et l'acheminement des événements vers le bon gestionnaire dans ton application.

1. **Prépare ta destination.** Mets en place une URL HTTPS sur ton serveur, Zapier, Make ou tout service capable de recevoir des requêtes POST. La destination doit être accessible publiquement et renvoyer une réponse 200. 2. **Accède aux intégrations.** Dans ton tableau de bord FlipLink, ouvre les paramètres d'[automatisation et intégrations](/features/automation-and-integrations) de ta publication. 3. **Ajoute l'URL du webhook.** Colle l'URL de ta destination dans le champ de configuration du webhook. 4. **Sélectionne les événements déclencheurs.** Choisis quels événements doivent déclencher le webhook — capture de prospect, consultation de document, finalisation de vente ou autres, selon tes besoins. 5. **Envoie un événement de test.** Utilise la fonction de test pour envoyer un exemple de charge utile à ta destination. Vérifie que ton système reçoit et traite correctement les données. 6. **Passe en production.** Enregistre ta configuration. Dès lors, chaque événement correspondant dans ton flipbook déclenchera un POST en temps réel vers ta destination. 7. **Surveille la livraison.** Consulte périodiquement les journaux de ta destination pour confirmer que les webhooks arrivent bien. Si tu remarques des manques, vérifie que ta destination renvoie des réponses 200 et que ton serveur n'a pas de règles de pare-feu bloquant les requêtes de FlipLink.

| Aspect | Webhook | Interrogation d'API | |--------|---------|---------------------| | **Livraison des données** | Envoyée automatiquement quand les événements surviennent | Récupérée selon une fréquence que tu définis | | **Latence** | Quasi instantanée (millisecondes) | Dépend de l'intervalle d'interrogation (secondes à minutes) | | **Charge serveur** | Minimale — les requêtes ne se produisent que lorsqu'un événement se déclenche | Plus élevée — les requêtes ont lieu à chaque intervalle même sans changement | | **Mise en œuvre** | Enregistrer une URL, gérer les requêtes POST entrantes | Construire une tâche planifiée qui appelle l'API à répétition | | **Idéal pour** | Notifications en temps réel, synchronisation CRM, alertes instantanées | Traitement par lots, rapports périodiques, instantanés de données | | **Risque** | Une indisponibilité de la destination peut faire manquer des événements sans logique de réessai | Aucun événement manqué si l'interrogation rattrape son retard, mais une prise de connaissance différée | Pour la plupart des éditeurs FlipLink, les webhooks sont le meilleur choix pour les événements de capture de prospects et de vente où la rapidité compte. L'interrogation d'API convient mieux aux exports de statistiques périodiques ou aux tableaux de bord qui se rafraîchissent à intervalles définis. Beaucoup d'équipes utilisent les deux : des webhooks pour l'acheminement des prospects en temps réel et l'[API REST](/glossary/rest-api) pour les extractions de statistiques nocturnes.