Интегратор на практике: подключение клиента

Результат первый: Kranvik Precision интегрирована

Здравствуйте и добро пожаловать в Академию PaperOffice AI. Четвертый эпизод серии для партнеров посвящен работе интегратора на практике: мы технически подключаем клиента. Сначала о результате. Для нашего клиента Kranvik Precision в Лондоне выделен Workspace в нашем аккаунте. Их счета автоматически поступают туда из их почтового ящика, а их команда задает вопросы по документам в Claude, не видя ничего другого в нашем аккаунте. Это достигается за четыре шага: выделенный Workspace для клиента, группа пользователей с ровно этим Workspace, групповой токен для Claude и автоматическое получение документов. Наконец, мы увидим, куда уходит использование.

Глава 1: Один Workspace на каждого клиента

Как интегратор, ваше решение работает на вашем собственном аккаунте PaperOffice. Ваш клиент платит вам по вашей цене, а ваше использование получает выгоду интегратора. Для каждого клиента создайте выделенный Workspace. Это гарантирует, что документы, агенты и знания остаются разделенными для каждого клиента. Мы называем его Kranvik Precision.

Глава 2: Группа с ровно этим Workspace

Чтобы убедиться, что команда вашего клиента видит только свой Workspace, создайте группу в разделе Группы пользователей. При настройке доступа к Workspace выберите белый список и назначьте туда только Kranvik Precision. Для этого Workspace вы определяете, что группа может делать с документами, например, просматривать и скачивать, но не загружать. Установите такие области, как Storage Mounts или Connectors, в значение «Нет доступа». Распространенной ошибкой является группа с полным доступом. Тогда токен видит все Workspaces в вашем аккаунте, включая тех ваших других клиентов. Поэтому проверьте в списке групп, что доступ ограничен.

Глава 3: Групповой токен для Claude

В разделе API и «Разработчик» вы создаете групповой токен для этой группы. Он предназначен для MCP Connect, то есть для Claude, ChatGPT или Cursor, и получает ровно те же права и Workspaces, что и группа. Вы можете скопировать токен в любое время из списка ключей API. Относитесь к нему как к паролю и передавайте только по защищенным каналам. В Claude ваш клиент добавляет PaperOffice в качестве коннектора и один раз входит в систему, используя токен. С этого момента его команда будет напрямую запрашивать свои документы в Claude. Для серверных процессов, с другой стороны, вы используете ключ API. Для Claude и других ИИ-ассистентов доступен групповой токен или пользовательский токен. Если кто-то покидает команду вашего клиента, обновите токен. Приложение немедленно генерирует новый, а старый становится недействительным. Ваш клиент один раз вводит новый токен в Claude.

Глава 4: Документы поступают автоматически

Теперь документы поступают самостоятельно. Самый простой способ — почтовый ящик счетов клиента: в разделе Storage Mounts Вы подключаете почтовый ящик через IMAP, указывая имя пользователя и пароль приложения. Connector в режиме импорта извлекает новые письма через фиксированные интервалы времени и сохраняет их в Workspace Kranvik Precision. Там PaperOffice обрабатывает документы так же, как и любой другой документ. Если у Вашего клиента есть NAS или сканер, подключите его тем же способом, например, через SFTP. Специальные видеоматериалы по этой теме доступны в Академии.

Глава 5: Пользовательские рабочие процессы с n8n

Для собственных процессов используйте API, например, с помощью n8n: новые счета извлекаются, проверяются и перенаправляются. Наш фильм «Входящие, которые думают вместе с Вами» в Академии показывает пошаговый процесс создания такого входящего потока.

Глава 6: Куда уходит использование

Все вызовы обрабатываются через Ваш аккаунт. Вы можете увидеть свою выгоду как интегратора на значке партнера на Вашей карточке тарифа и в каждой строке использования API. То, какую сумму Вы будете взимать с клиента, остается на Ваше усмотрение. Вкратце: один Workspace на клиента, группа, содержащая ровно этот Workspace, токен группы для Claude, и документы поступают автоматически через почтовый ящик или NAS. Все работает через Ваш аккаунт. Следующий и последний эпизод посвящен практике работы реселлера: как Ваш клиент начинает работать самостоятельно. До встречи в Академии PaperOffice AI.