Integratore nella pratica: collegamento di un cliente

Risultato iniziale: Kranvik Precision è integrata

Salve e benvenuti all’Accademia PaperOffice AI. Il quarto episodio della serie dedicata ai partner riguarda il lavoro da integratori nella pratica: connettiamo un cliente dal punto di vista tecnico. Innanzitutto, il risultato. Per il nostro cliente Kranvik Precision a Londra, è presente un Workspace dedicato nel nostro account. Le loro fatture arrivano automaticamente dalla loro casella di posta e il loro team pone domande sui documenti in Claude senza vedere altro nel nostro account. Questo si ottiene in quattro passaggi: un Workspace per il cliente, un gruppo di utenti con esattamente questo Workspace, un token di gruppo per Claude e la ricezione automatica dei documenti. Infine, vedremo dove finisce l’utilizzo.

Capitolo 1: Un Workspace per cliente

Come integratore, la propria soluzione gira sul proprio account PaperOffice. Il cliente paga al prezzo stabilito dall’integratore e l’utilizzo riceve il beneficio da integratore. Per ogni cliente, creare un Workspace dedicato. Ciò garantisce che documenti, agenti e conoscenze rimangano separati per ciascun cliente. Ci si riferisce ad esso come a Kranvik Precision.

Capitolo 2: Un gruppo con esattamente questo Workspace

Per garantire che il team del cliente veda solo il proprio Workspace, creare un gruppo sotto Gruppi di Utenti. Durante la configurazione dell’Accesso al Workspace, selezionare la whitelist e assegnare solo Kranvik Precision ad essa. Per questo Workspace, si definisce ciò che il gruppo può fare con i documenti, come la visualizzazione e il download, ma non il caricamento. Impostare aree come Storage Mounts o Connectors su “Nessun accesso”. Un errore comune è un gruppo con accesso completo. In tal caso, il token vede tutti i Workspaces nel proprio account, inclusi quelli degli altri clienti. Si prega quindi di verificare nell’elenco dei gruppi che l’accesso sia limitato.

Capitolo 3: Un token di gruppo per Claude

Sotto API & Developer, è ora possibile creare un token di gruppo per questo gruppo. È destinato a MCP Connect, ovvero a Claude, ChatGPT o Cursor, e assume esattamente i diritti e le Workspaces del gruppo. Il token può essere copiato in qualsiasi momento dall’elenco delle chiavi API. Trattarlo come una password e condividerlo solo tramite canali sicuri. In Claude, il cliente aggiunge PaperOffice come connettore ed effettua l’accesso una volta sola, utilizzando il token. Da quel momento in poi, il suo team interroga i propri documenti direttamente in Claude. Per i processi server, invece, si utilizza una chiave API. Per Claude e altri assistenti AI sono disponibili il token di gruppo o il token utente. Se un membro lascia il team del cliente, è necessario ruotare il token. L’app genera immediatamente un nuovo token e quello precedente diventa non valido. Il cliente inserisce il nuovo token in Claude una volta sola.

Capitolo 4: I documenti arrivano automaticamente

Ora i documenti arrivano da soli. Il metodo più semplice è la casella di posta delle fatture del cliente: sotto Storage Mounts, si collega la casella di posta tramite IMAP, con il nome utente e una password per le app. Un Connector in modalità di importazione recupera le nuove email a intervalli fissi e le memorizza nel Kranvik Precision Workspace. Lì, PaperOffice legge i documenti esattamente come qualsiasi altro documento. Se il cliente dispone di un NAS o di uno scanner, si colleghi utilizzando lo stesso metodo, ad esempio tramite SFTP. Video dedicati a questo argomento sono disponibili nell’Accademia.

Capitolo 5: Flussi di lavoro personalizzati con n8n

Per i propri processi, si utilizzi l’API, ad esempio con n8n: le nuove fatture vengono estratte, verificate e inoltrate. Il nostro filmato “La casella di posta che pensa insieme a Lei” nell’Accademia mostra come costruire tale casella passo dopo passo.

Capitolo 6: Dove finisce l’utilizzo

Tutte le chiamate vengono elaborate tramite il proprio account. È possibile visualizzare il vantaggio dell’integratore sul badge partner nella scheda del piano e su ciascuna riga sotto l’utilizzo API. La determinazione del prezzo da addebitare al cliente è a discrezione di chi legge. In sintesi: un Workspace per cliente, un gruppo contenente esattamente tale Workspace, un token di gruppo per Claude e i documenti arrivano automaticamente tramite casella di posta o NAS. Tutto passa attraverso il proprio account. L’episodio successivo e finale riguarda l’attività di rivenditore nella pratica: come il cliente può iniziare in autonomia. Alla prossima nell’Accademia PaperOffice AI.