✦Intégrations

Brancher Plume à Make, Zapier ou n8n

Quand un dossier est rempli, Plume appelle l'adresse que vous lui avez donnée. Un scénario Make, un Zap ou un flux n8n peut alors ranger le PDF, prévenir un collègue ou mettre à jour un tableau — sans écrire de programme.

Avant de commencer

  • Une offre qui ouvre l'API : dès l'offre Essentiel, ou avec des pages achetées à la carte. La clé d'API se crée dans les paramètres.
  • Être responsable ou administrateur de l'espace : c'est lui qui déclare l'adresse du webhook, cinq adresses au plus par espace.
  • Une adresse en https, publique : celle que l'outil d'automatisation vous donne.

Les cinq étapes

  1. 1

    Créer le déclencheur

    Dans votre outil, créez un déclencheur qui reçoit un webhook, puis copiez l'adresse qu'il affiche.

  2. 2

    Déclarer l'adresse à Plume

    Un appel, une seule fois, connecté à Plume en responsable ou administrateur de l'espace. La réponse contient le secret du webhook : il n'est montré qu'à ce moment, gardez-le.

    POST /api/v1/tenants/{espace}/webhooks
{"url": "https://adresse-donnee-par-votre-outil"}

→ {"id": "…", "secret": "whsec_…"}

  3. 3

    Tester

    Un envoi de test part tout de suite : l'événement « ping » doit apparaître dans votre outil.

    POST /api/v1/tenants/{espace}/webhooks/{id}/ping

  4. 4

    Vérifier la signature

    Avant d'agir, recalculez la signature : HMAC-SHA256 du corps BRUT de la requête, avec le secret du webhook, préfixé de « sha256= ». Comparez-la à l'en-tête X-Plume-Signature ; si elle diffère, arrêtez le scénario.

  5. 5

    Aller chercher le dossier

    Le corps ne contient aucune donnée personnelle : il dit quel dossier est fini, et dans quel état. Avec fill_id et votre clé d'API, lisez l'état du dossier puis téléchargez le PDF rempli.

    GET /api/v2/dossiers/{fill_id}/etat
Authorization: Bearer plume_sk_…

Ce que reçoit votre outil :

X-Plume-Event: fill.done
X-Plume-Signature: sha256=21e667659d1a7a94…

{"created_at":"2026-10-03T10:00:00+00:00","event":"fill.done",
 "fill_id":"…","pages":3,"status":"succeeded","tenant_id":"…"}

Le corps ne contient aucune donnée personnelle ni contenu de document : ni nom de fichier, ni champ détecté, ni valeur écrite. Il dit qu'un dossier est fini, lequel, et avec quel état. Le reste se lit par l'API, avec votre clé.

Dans Make, Zapier et n8n

Make

Module « Webhooks » puis « Custom webhook » : Make crée l'adresse à déclarer.

Dans les réglages avancés du webhook, demandez les en-têtes de la requête et le corps tel quel (« JSON pass-through ») : la signature se calcule sur le texte reçu, pas sur un JSON réécrit.

Zapier

Application « Webhooks by Zapier », déclencheur « Catch Raw Hook » : il garde le corps brut et les en-têtes.

Une étape « Code by Zapier » recalcule le HMAC sur le corps brut ; un filtre arrête le Zap si les deux signatures diffèrent.

n8n

Nœud « Webhook », méthode POST : n8n affiche une adresse de test et une adresse de production.

Activez l'option du corps brut (« Raw Body »), puis un nœud « Crypto » en HMAC SHA256 avec le secret ; un nœud « IF » compare le résultat à l'en-tête.

Quelques idées de scénarios

  • Ranger le PDF rempli dans le dossier partagé du client.
  • Prévenir le collègue qui suit la personne quand son dossier est prêt à relire.
  • Ajouter une ligne à un tableau de suivi : date, formulaire, état.
  • Être alerté quand une analyse échoue (« fill.failed ») plutôt que de l'attendre.
Toute l'API sur la page Développeurs