Intégrations & API
Plyq se branche à vos outils. Pas l'inverse.
Vos pièces validées se rangent dans Google Drive, OneDrive ou SharePoint. Et avec l'API Plyq, votre CRM, votre ERP ou votre automate créent les demandes, suivent les dépôts et récupèrent les documents, sans ressaisie.
Créer une demande
curl -X POST https://www.plyq.fr/api/v1/requests \
-H "Authorization: Bearer plyq_xxx" \
-H "Content-Type: application/json" \
-d '{
"title": "Bilan annuel 2025",
"client_email": "dupont@exemple.fr",
"client_name": "M. Dupont",
"items": [
{ "label": "Avis d'imposition 2024" },
{ "label": "Factures EDF 2024", "expected_count": 12 }
]
}'Réponse
201 Created
{
"id": "ddc-456",
"title": "Bilan annuel 2025",
"portal_url": "https://www.plyq.fr/d/abc-def",
"created_at": "2026-06-08T15:00:00.000Z"
}Ce que l'API fait à votre place.
Quatre automatisations à mettre en place avec l'automate de votre choix, ou en quelques lignes de code si vous avez une équipe technique.
Un nouveau client dans le CRM, une demande de pièces créée
- HubSpot
- Salesforce
- n8n
- DéclencheurUn contact passe en « client » dans votre CRM
- Appel PlyqVotre automate appelle POST /api/v1/requests
- RésultatLe lien de dépôt revient dans la fiche du client, prêt à être envoyé
Votre logiciel métier ouvre le dossier, Plyq collecte
- Make
- Zapier
- DéclencheurUn dossier est créé dans votre ERP ou votre logiciel de gestion
- Appel PlyqLa demande Plyq est générée avec la bonne liste de pièces
- RésultatLe client dépose, vous validez, les relances tournent seules
L'équipe prévenue dès qu'un document arrive
- Slack
- n8n
- DéclencheurVotre automate interroge GET /api/v1/requests toutes les 10 minutes
- Appel PlyqIl repère les nouveaux dépôts
- RésultatUn message part dans le canal de l'équipe avec le nom du client
Les pièces validées rangées dans votre GED
- Make
- n8n
- DéclencheurChaque nuit, l'automate liste les demandes du jour
- Appel PlyqIl télécharge les documents validés via leur lien sécurisé
- RésultatIl les classe dans votre GED, votre archive ou un autre espace de stockage
Trois connecteurs natifs, zéro configuration technique.
Vous connectez votre compte, vous choisissez un dossier, c'est terminé. En mode zéro-stockage (plan Team), les fichiers de vos clients partent directement chez vous et Plyq n'en garde aucune copie.
Google Drive
Choisissez le dossier de destination dans un sélecteur intégré. Les pièces validées y arrivent avec un nom lisible.
OneDrive
Même fonctionnement avec votre compte Microsoft : connexion en deux clics, dossier au choix, création de dossier sur place.
SharePoint
Pour les équipes sous Microsoft 365 : ciblez un site SharePoint et sa bibliothèque de documents. Disponible dès le plan Pro.
L'API en bref.
Une API REST en JSON, six points d'accès, une authentification par token. La documentation complète, avec exemples et codes d'erreur, est disponible dans l'application dès le plan Pro.
| Méthode | Point d'accès | Droit requis | Usage |
|---|---|---|---|
| GET | /api/v1/requests | lecture | Lister les demandes, avec pagination et filtre par projet |
| GET | /api/v1/requests/{id} | lecture | Détail d'une demande : pièces, statuts, liens de téléchargement des documents |
| POST | /api/v1/requests | écriture | Créer une demande et sa liste de pièces, récupérer le lien client |
| DELETE | /api/v1/requests/{id} | écriture | Supprimer une demande et ses fichiers |
| GET | /api/v1/projects | lecture | Lister les projets de l'organisation |
| GET | /api/v1/projects/{id} | lecture | Détail d'un projet et de ses demandes |
Tokens à portée limitée
Lecture seule ou lecture et écriture. Un token par intégration, révocable à tout moment, avec date d'expiration au choix.
Jamais stockés en clair
Le token s'affiche une seule fois à la création. Nous n'en conservons qu'une empreinte SHA-256.
Téléchargements éphémères
Les documents se récupèrent via des liens signés valables 5 minutes, régénérés à la demande.
Débit maîtrisé et traçabilité
60 requêtes par minute et par token. Création et révocation des tokens inscrites au journal d'activité.
Ce qu'on nous demande sur l'API.
Faut-il savoir coder pour connecter Plyq à nos outils ?
Non. Avec un automate comme n8n, Make ou Zapier, vous reliez Plyq à votre CRM ou à votre messagerie d'équipe en configurant une requête HTTP, sans écrire de programme. Si vous avez une équipe technique, l'API REST s'utilise directement depuis n'importe quel langage.
Dans quels plans l'API et les intégrations sont-elles incluses ?
Les connecteurs Google Drive et OneDrive sont inclus dès le plan Solo, SharePoint dès le plan Pro. L'API est incluse dans les plans Pro (3 tokens) et Team (tokens illimités), avec la documentation complète dans l'application.
L'API envoie-t-elle l'email au client ?
Non. La création d'une demande par l'API renvoie le lien de dépôt du client. Vous l'envoyez depuis votre propre outil (CRM, messagerie, logiciel métier), avec votre mise en forme. L'envoi automatique par Plyq reste disponible depuis l'interface.
Plyq propose-t-il des webhooks ?
Pas encore. Aujourd'hui, un automate interroge l'API à intervalle régulier (toutes les 5 à 10 minutes) pour détecter les nouveaux dépôts. La limite de 60 requêtes par minute le permet largement.
Nos documents passent-ils par des serveurs tiers ?
Non. L'API est servie par Plyq, hébergé en Union européenne. En mode zéro-stockage (plan Team), les fichiers déposés partent directement dans votre Drive ou votre SharePoint et Plyq n'en conserve aucune copie.