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
- Ouvrez l’extension Web2MD et allez dans Settings.
- Faites défiler jusqu’à la section Webhooks.
- Saisissez l’URL de votre point de terminaison et cliquez sur Add Webhook.
- 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êtePOST à votre point de terminaison avec le corps JSON suivant :
Sécurité
Chaque requête webhook inclut un en-têteX-Web2MD-Signature contenant une signature HMAC-SHA256 du corps brut de la requête, signée avec le secret de signature de votre webhook.
Exemple de vérification (Node.js)
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.