Passer au contenu principal

Vue d’ensemble

Les webhooks vous permettent de recevoir une notification HTTP POST sur votre propre point de terminaison à chaque fois qu’une conversion se termine. Utilisez-les pour déclencher des workflows dans Zapier, Make, n8n, ou n’importe quel backend personnalisé.
Les webhooks sont une fonctionnalité du plan PRO. Chaque utilisateur peut enregistrer jusqu’à 3 points de terminaison webhook.

Configuration

  1. Ouvrez l’extension Web2MD et allez dans Settings.
  2. Faites défiler jusqu’à la section Webhooks.
  3. Saisissez l’URL de votre point de terminaison et cliquez sur Add Webhook.
  4. Copiez le secret de signature — vous en aurez besoin pour vérifier les requêtes entrantes.

Charge utile

Lorsqu’une conversion se termine, Web2MD envoie une requête POST à votre point de terminaison avec le corps JSON suivant :

Sécurité

Chaque requête webhook inclut un en-tête X-Web2MD-Signature contenant une signature HMAC-SHA256 du corps brut de la requête, signée avec le secret de signature de votre webhook.
Vérifiez toujours la signature avant de traiter un webhook. Cela empêche des attaquants d’envoyer des requêtes falsifiées à votre point de terminaison.

Exemple de vérification (Node.js)

Utilisez crypto.timingSafeEqual plutôt que === pour éviter les attaques par mesure du temps lors de la comparaison des signatures.

Comportement des tentatives

Si les deux tentatives échouent (réponse non-2xx ou délai dépassé), la livraison est abandonnée. Web2MD ne retente pas au-delà de cette seule nouvelle tentative.

Cas d’usage

Zapier / Make / n8n

Utilisez un déclencheur Webhook dans votre plateforme d’automatisation pour lancer un workflow chaque fois qu’une page est convertie — publier sur Slack, ajouter une ligne à une feuille de calcul, ou sauvegarder dans Notion.

Notifications Slack

Envoyez un message sur un canal Slack chaque fois qu’un membre de l’équipe convertit une page, pour tenir tout le monde informé.

Sauvegarde automatique vers un stockage externe

Récupérez le Markdown complet via l’API REST (en utilisant conversionId) et sauvegardez-le sur S3, Google Drive, ou votre propre base de données.

Pipeline analytique

Suivez le volume de conversions et les types de contenu en transmettant les événements webhook à votre backend analytique.

Tester les webhooks

Pendant le développement, utilisez un outil comme webhook.site ou ngrok pour exposer un point de terminaison local et inspecter les charges utiles entrantes avant de déployer votre gestionnaire en production.