Comment créer des webhooks dans Papermark ?

Page des paramètres des webhooks

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

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

Barre latérale des paramètres des webhooks

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

Formulaire de création de webhook

Nommez-le – Saisissez un nom descriptif tel que Alertes Slack (min. 3 caractères).
Collez l'URL de votre endpoint – C'est là que Papermark enverra les requêtes POST.
Copiez le secret – Un secret de signature unique est généré automatiquement. Enregistrez-le pour pouvoir vérifier les signatures.
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

Nouveaux déclencheurs de webhook : link.created et document.created

Deux déclencheurs sont particulièrement utiles pour l'automatisation :

link.created se déclenche dès qu'un nouveau lien est généré pour un document ou une salle de données
document.created se déclenche dès qu'un nouveau document est téléversé

Automatisations courantes qu'ils permettent :

Synchronisation CRM : lorsqu'un nouveau lien est créé pour un investisseur, envoyez un enregistrement dans HubSpot ou Salesforce
Alertes Slack : notifiez un canal commercial lorsqu'un nouveau lien de pitch deck est généré
Workflows Zapier : lancez une automatisation en plusieurs étapes à chaque fois qu'un document est téléversé
Suivi interne : consignez chaque lien et document dans votre propre entrepôt de données pour l'analyse

Exemple de payload pour link.created :

{
  "event": "link.created",
  "data": {
    "id": "link_abc123",
    "url": "https://docs.acme.com/aB3kP9xQ7m",
    "documentId": "doc_xyz456",
    "name": "Investor pitch v3",
    "createdAt": "2026-05-29T12:34:56Z"
  }
}

Exemple de payload pour document.created :

{
  "event": "document.created",
  "data": {
    "id": "doc_xyz456",
    "name": "Q1 2026 financials.xlsx",
    "type": "spreadsheet",
    "teamId": "team_789",
    "createdBy": "user@acme.com",
    "createdAt": "2026-05-29T12:34:56Z"
  }
}

Sélection des déclencheurs de webhook

Enregistrer le webhook – Cliquez sur Créer. Vous verrez le nouveau webhook dans la liste avec son statut.
Tester la livraison – Effectuez une action correspondant à l'un de vos déclencheurs et vérifiez votre endpoint ou le journal de livraison.

Vérification des signatures

Chaque requête inclut un en-tête X-Papermark-Signature contenant un hash HMAC-SHA-256 du payload. 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 modifier l'URL.
• Voir les journaux – Ouvrez un webhook et basculez vers le Journal de livraison pour voir chaque tentative et code de réponse.
• Supprimer – Utilisez le bouton Supprimer dans la page de détail du webhook pour arrêter les livraisons.

Conseils

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

Guides associés

Workflows Papermark - des playbooks prêts à l'emploi qui combinent les webhooks avec Slack, des CRM, Zapier et bien plus
Comment utiliser l'API REST Papermark - associez le pull et le push pour une couverture complète
Comment utiliser le CLI Papermark - automatisez depuis votre terminal ou votre CI
Comment utiliser le serveur MCP Papermark - laissez les assistants IA agir sur les événements webhook
Comment connecter Slack à Papermark - envoyez les événements Papermark dans vos canaux Slack

Besoin d'aide ? Envoyez un e-mail à support@papermark.com ou utilisez le chat intégré à l'application - nous serons ravis de vous aider !