Intégrateur en pratique : connecter un client

Résultat en premier : Kranvik Precision est intégré

Bonjour et bienvenue dans l’Académie PaperOffice AI. Le quatrième épisode de la série partenaires porte sur le travail d’intégrateur en pratique: nous connectons un client techniquement. D’abord, le résultat. Pour notre client Kranvik Precision à Londres, il y a un Workspace dédié dans notre compte. Leurs factures y arrivent automatiquement depuis leur boîte mail, et leur équipe pose des questions sur les documents dans Claude sans rien voir d’autre dans notre compte. Cela est réalisé en quatre étapes: un Workspace pour le client, un groupe d’utilisateurs avec exactement ce Workspace, un jeton de groupe pour Claude, et la réception automatique des documents. Enfin, nous verrons où aboutit l’utilisation.

Chapitre 1: Un Workspace par client

En tant qu’intégrateur, votre solution s’exécute sur votre propre compte PaperOffice. Votre client vous paie à votre tarif, et votre utilisation bénéficie de l’avantage intégrateur. Pour chaque client, créez un Workspace dédié. Cela garantit que les documents, les agents et les connaissances restent séparés par client. Nous le désignons sous le nom de Kranvik Precision.

Chapitre 2: Un groupe avec exactement ce Workspace

Workspaces. Pour garantir que l’équipe de votre client ne voit que son Workspace, créez un groupe sous Groupes d’utilisateurs. Lors de la configuration de l’Accès au Workspace, sélectionnez la liste blanche et attribuez uniquement Kranvik Precision à celle-ci. Pour ce Workspace, vous définissez ce que le groupe a le droit de faire avec les documents, comme la visualisation et le téléchargement, mais pas le téléversement. Définissez des zones comme Storage Mounts ou Connectors sur « Aucun accès ». Une erreur courante est un groupe avec un accès complet. Alors vérifiez dans la liste des groupes que l’accès est restreint.

Chapitre 3 : Un jeton de groupe pour Claude

Sous API & Développeur, vous créez désormais un jeton de groupe pour ce groupe. Il est destiné à MCP Connect, c’est-à-dire pour Claude, ChatGPT ou Cursor, et reprend exactement les droits et Workspaces du groupe. Vous pouvez copier le jeton à tout moment depuis la liste des clés API. Traitez-le comme un mot de passe et ne le partagez que via des canaux sécurisés. Dans Claude, votre client ajoute PaperOffice en tant que connecteur et se connecte une fois en utilisant le jeton. Dès lors, son équipe interroge directement ses propres documents dans Claude. Pour les processus serveur, en revanche, vous utilisez une clé API. Pour Claude et d’autres assistants IA, il existe le jeton de groupe ou le jeton utilisateur. Si quelqu’un quitte l’équipe de votre client, faites tourner le jeton. L’application en génère immédiatement un nouveau, et l’ancien devient invalide. Votre client saisit le nouveau dans Claude une seule fois.

Chapitre 4 : Les documents arrivent automatiquement

Maintenant, les documents arrivent d’eux-mêmes. La méthode la plus simple est la boîte mail de facturation du client: sous Storage Mounts, vous connectez la boîte mail via IMAP, avec le nom d’utilisateur et un mot de passe d’application. Un Connector en mode importation récupère les nouveaux emails à intervalles fixes et les stocke dans le Kranvik Precision Workspace. Là, PaperOffice lit les documents comme n’importe quel autre document. Si votre client dispose d’un NAS ou d’un scanner, connectez-le en utilisant la même méthode, par exemple via SFTP. Des vidéos dédiées sur ce sujet sont disponibles dans l’Académie.

Chapitre 5: Workflows personnalisés avec n8n

Pour vos propres processus, utilisez l’API, par exemple avec n8n: Les nouvelles factures sont extraites, vérifiées et transmises. Notre film « La boîte de réception qui réfléchit avec vous » dans l’Académie vous montre comment construire une telle boîte de réception étape par étape.

Chapitre 6 : Où va l’utilisation

Tous les appels sont traités via votre compte. Vous pouvez voir votre avantage d’intégrateur sur le badge partenaire de votre carte de plan et sur chaque ligne sous l’utilisation de l’API. Ce que vous facturez à votre client est à votre discrétion. En résumé: un Workspace par client, un groupe contenant exactement ce Workspace, un jeton de groupe pour Claude, et les documents arrivent automatiquement via boîte aux lettres ou NAS. Tout passe par votre compte. Le prochain et dernier épisode porte sur le travail en tant que revendeur en pratique: comment votre client commence par lui-même. À bientôt dans l’Académie PaperOffice AI.