Integrador na prática: conectando um cliente

Resultado primeiro: A Kranvik Precision está integrada

Olá e bem-vindo à Academia PaperOffice AI. O quarto episódio da série de parceiros trata do trabalho como integrador na prática: conectamos um cliente tecnicamente. Primeiro, o resultado. Para o nosso cliente Kranvik Precision, em Londres, há uma conta dedicada Workspace na nossa conta. As suas faturas chegam lá automaticamente a partir da caixa de correio deles, e a sua equipa faz perguntas sobre os documentos no Claude sem ver nada mais na nossa conta. Isto é alcançado em quatro passos: uma conta Workspace para o cliente, um grupo de utilizadores com exatamente esta conta Workspace, um token de grupo para Claude e o recebimento automático de documentos. Finalmente, veremos onde termina o uso.

Capítulo 1: Uma conta Workspace por cliente

Como integrador, a sua solução executa-se na sua própria conta PaperOffice. O seu cliente paga-lhe ao seu preço, e o seu uso recebe o benefício de integrador. Para cada cliente, crie uma conta dedicada Workspace. Isto garante que os documentos, agentes e conhecimentos permaneçam separados por cliente. Referimo-nos a ela como Kranvik Precision.

Capítulo 2: Um grupo com exatamente esta conta Workspace

Workspaces. Para garantir que a equipa do seu cliente vê apenas a sua conta Workspace, crie um grupo em Grupos de Utilizadores. Ao configurar o Acesso à conta Workspace, selecione a lista branca e atribua apenas a Kranvik Precision a ela. Para esta conta Workspace, define-se o que o grupo tem permissão para fazer com os documentos, como visualizar e descarregar, mas não carregar. Defina áreas como Storage Mounts ou Connectors como “Sem acesso”. Um erro comum é um grupo com acesso total. Então, verifique na lista de grupos que o acesso está restrito.

Capítulo 3: Um token de grupo para Claude

Em API & Developer, você cria agora um token de grupo para este grupo. Ele se destina a MCP Connect, ou seja, para Claude, ChatGPT ou Cursor, e assume exatamente os direitos e Workspaces do grupo. Você pode copiar o token a qualquer momento na lista de Chaves API. Trate-o como uma senha e compartilhe-o apenas por canais seguros. Em Claude, seu cliente adiciona PaperOffice como conector e faz login uma vez, utilizando o token. A partir de então, sua equipe consulta seus próprios documentos diretamente no Claude. Para processos de servidor, por outro lado, você utiliza uma chave API. Para Claude e outros assistentes de IA, há o token de grupo ou o token de usuário. Se alguém sair da equipe do seu cliente, substitua o token. O aplicativo gera imediatamente um novo e o antigo torna-se inválido. Seu cliente insere o novo no Claude uma vez.

Capítulo 4: Os documentos chegam automaticamente

Agora os documentos chegam por conta própria. A maneira mais fácil é a caixa de entrada de faturas do cliente: em Storage Mounts, conecte a caixa de entrada via IMAP, com o nome de usuário e uma senha de aplicativo. Um Connector no modo de importação recupera novos e-mails em intervalos fixos e os armazena no Kranvik Precision Workspace. Lá, PaperOffice lê os documentos da mesma forma que qualquer outro documento. Se o cliente tiver um NAS ou um scanner, conecte-o usando o mesmo método, por exemplo, via SFTP. Vídeos dedicados sobre este tópico estão disponíveis na Academia.

Capítulo 5: Fluxos de trabalho personalizados com n8n

Para seus próprios processos, utilize a API, por exemplo, com n8n: novas faturas são extraídas, verificadas e encaminhadas. Nosso filme “A caixa de entrada que pensa junto com você” na Academia mostra como construir essa caixa de entrada passo a passo.

Capítulo 6: Para onde vai o uso

Todas as chamadas são processadas através da sua conta. O senhor pode visualizar o benefício do seu integrador no emblema do parceiro no cartão do seu plano e em cada linha sob o uso da API. O valor que o senhor cobra do seu cliente por isso é de sua exclusiva decisão. Em resumo: um Workspace por cliente, um grupo contendo exatamente este Workspace, um token de grupo para Claude e os documentos chegam automaticamente via caixa de correio ou NAS. Tudo é processado através da sua conta. O próximo e último episódio trata do trabalho como revendedor na prática: como o seu cliente começa por conta própria. Até a próxima na Academia PaperOffice AI.