Logo PDFHQ

Documents

DocumentationAutomatisation et intégrations

Aperçu de l'automatisation — Zapier, MCP et webhooks

Comparez les connecteurs Zapier privés, les outils MCP délégués OAuth, les webhooks de projet signés et l'orchestration API REST, avec les prérequis de déploiement et les limitations.

Clés API côté serveur Importations de stockage signées

Choisissez la bonne surface d'automatisation#

PDFHQ offre différentes surfaces d'intégration plutôt qu'un seul point de terminaison REST nommé Zapier ou MCP. L'API de tâche alimente le traitement ; les webhooks de projet livrent les événements ; une application CLI Zapier Platform non publiée enveloppe les opérations REST autorisées ; MCP expose les outils OAuth délégués pour les agents IA.

API directe : tâche documentée, importer, les routes IA et signature sont accessibles avec les identifiants et permissions de compte appropriés. Zapier : la source est disponible dans integrations/zapier mais il n'y a pas d'application publiée. MCP : le serveur local existe ; OAuth hébergé est en staging verrouillé et non certifié public. Webhooks : Les points de terminaison source existent mais retournent 503 sauf s'ils sont activés par un opérateur après la configuration et les tests.

Voir l'aperçu de l'intégration visuelle →

Exemple : tâche PDF → webhook → automatisation#

Commencez par soumettre une tâche PDF appartenant au projet en utilisant le cycle de vie API normal. Abonnez-vous à l'événement complété uniquement après que votre déploiement ait activé les webhooks client, le chiffrement et le worker de livraison. Stockez le secret de signature retourné une seule fois ; vérifiez la charge utile brute exacte et rejetez la relecture avant de déclencher l'automatisation en aval.

Créer un abonnement webhook privé
# Staging only: project API key stored on your server.
curl -X POST 'https://api.pdfhq.io/v1/webhooks' \
  -H 'x-api-key: YOUR_PROJECT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"target_url":"https://your-app.example/events/pdfhq","events":["pdf.job.succeeded","ai.job.succeeded"]}'
# The first response includes a one-time HMAC signing secret.
# Verify X-PDFHQ-Webhook-Timestamp and X-PDFHQ-Webhook-Signature: v1=...;
# reject old messages and deduplicate on the event ID.

La charge utile du webhook contient des métadonnées, pas des octets PDF ou des liens de téléchargement signés. Récupérez les résultats autorisés indépendamment via les API PDFHQ authentifiées. La livraison est au moins une fois, les consommateurs doivent donc gérer les doublons.

Événements webhook, vérification, tentatives et relecture →

Zapier : source d'application privée#

L'authentification par clé de projet active les déclencheurs et actions de tâches PDF/IA, avec REST Hooks signés pour les événements de projet pris en charge et secours par interrogation. Un document autorisé doit déjà être importé via le flux d'importation sécurisé. L'application ne peut préparer que des brouillons de signature sandbox non envoyés ; elle ne peut pas envoyer d'invitations en direct.

Validation hors ligne (avant la configuration de Zapier CLI privé)
cd integrations/zapier
npm install
npm test
npx zapier-platform validate

Validez le connecteur avec un compte développeur Zapier et une API de staging avant de publier quoi que ce soit. Ce référentiel ne contient pas de liste Zapier publique ni de lien d'installation en un clic.

Déclencheurs, actions et limitations Zapier →

MCP : accès délégué aux agents IA#

MCP utilise HQTools OAuth Authorization Code + PKCE et des portées PDFHQ vérifiées par audience. Ce n'est pas une variante de clé API de Zapier et ne reçoit pas de webhooks. Le stdio local peut être testé avec un jeton de courte durée obtenu séparément ; l'hébergement d'un serveur MCP distant nécessite une configuration d'opérateur, PKCE et l'acceptation du cycle de vie.

Cible de déploiement MCP distant – pas une revendication de connexion en direct
https://mcp.pdfhq.io/mcp

Les outils autorisés incluent l'état/la soumission des tâches PDF, les devis/tâches IA et l'état de signature limité. La rédaction, la suppression, la transmission de signature en direct et l'administration des identifiants sont délibérément exclus des outils autonomes. L'exécution IA continue selon les règles de crédit et de consentement HQTools.

Portées OAuth MCP et configuration de staging →

Autres systèmes de flux de travail#

Les connecteurs natifs Make et n8n ne sont pas implémentés ni publiés. Leurs modules HTTP peuvent appeler les opérations REST documentées, et les points de terminaison HTTPS compatibles peuvent recevoir les webhooks du projet une fois activés. Ne configurez pas les flux de travail de production tant que l'authentification du projet, les signatures d'événements, la facturation et les tentatives n'ont pas réussi les tests connectés.

Créer avec le démarrage rapide des tâches REST →
Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.