Comment créer des webhooks dans Papermark ?

Besoin de déclencher des automatisations lorsque quelque chose se produit dans Papermark ? Avec les webhooks, vous pouvez envoyer des événements comme link.viewed ou document.created vers n'importe quel service externe en temps réel.

Les webhooks sont disponibles sur le forfait Business (ou pendant votre essai gratuit). Vous devez être Propriétaire de l'espace de travail ou Administrateur pour les gérer.

Avant de commencer

• Décidez où vous recevrez les événements (par ex. Slack, Zapier, point de terminaison personnalisé).
• Assurez-vous que la destination peut accepter des requêtes POST avec des corps JSON.
• Générez ou ayez accès à votre URL de réception.

Étape par étape

1. Ouvrez les paramètres – Cliquez sur l'icône Paramètres dans la barre latérale gauche, puis choisissez Webhooks dans le menu.

2. Créez un webhook – Appuyez sur Créer un webhook dans le coin supérieur droit.

3. Nommez-le – Entrez un nom descriptif comme Alertes Slack (min. 3 caractères).
4. Collez votre URL de point de terminaison – C'est là que Papermark enverra les requêtes POST.
5. Copiez le secret – Un secret de signature unique est généré automatiquement. Enregistrez-le pour pouvoir vérifier les signatures.
6. Choisissez les déclencheurs – Sélectionnez un ou plusieurs événements à envoyer. Vous pouvez combiner des déclencheurs de plusieurs catégories :
   • Niveau équipe – document.created, document.updated, document.deleted, dataroom.created
   • Niveau document – link.created, link.updated
   • Niveau lien – link.viewed, link.downloaded

7. Enregistrez le webhook – Cliquez sur Créer. Vous verrez le nouveau webhook dans la liste avec son statut.
8. Testez la livraison – Effectuez une action qui correspond à l'un de vos déclencheurs et vérifiez votre point de terminaison ou le journal de livraison.

Vérification des signatures

Chaque requête inclut un en-tête X-Papermark-Signature contenant un hachage HMAC-SHA-256 de la charge utile. Hachez le JSON brut avec votre secret enregistré et comparez la valeur hexadécimale pour vous assurer que l'appel provient bien de Papermark.

X-Papermark-Signature: 3a1d5f…

Gestion des webhooks

• Modifier – Cliquez sur un webhook dans la liste pour le renommer, ajouter/supprimer des déclencheurs ou changer l'URL.
• Consulter les journaux – Ouvrez un webhook et passez à Journal de livraison pour voir chaque tentative et code de réponse.
• Supprimer – Utilisez le bouton Supprimer dans la page de détails du webhook pour arrêter les livraisons.

Conseils

• Maintenez votre point de terminaison hautement disponible ; Papermark réessaie les livraisons échouées pendant 24 heures.
• Utilisez des files d'attente (par ex. AWS SQS, RabbitMQ) pour découpler le traitement de la réception.
• Filtrez les événements par le champ event pour les acheminer vers différents gestionnaires.

Besoin d'aide ? Envoyez un email à support@papermark.com ou utilisez le chat intégré à l'application – nous sommes heureux de vous aider !