Существует ли узел PaperOffice для n8n?
Нет. Отдельного узла, готовых учетных данных или опубликованных шаблонов нет. Вы работаете со стандартными узлами HTTP Request, Webhook и клиентом MCP, обращаясь к документированному REST-API и серверу MCP.
Какой ключ мне нужен?
Вы создаете его в приложении в разделе Аккаунт → API. Для REST используйте po_sk_ или po_ut_, для MCP — po_ut_, po_gt_ или OAuth 2.1; сервер MCP отклоняет po_sk_ и po_pk_. Достаточно подтвержденного адреса электронной почты. Функция API доступна во всех тарифах, включая Free.
Каким образом n8n узнает, что документ готов?
Через подписку на вебхук, начиная с Professional. Вы подписываетесь на событие document.processed, указав URL-адрес вашего узла вебхука в рабочей среде. Доставка содержит pofid, workspace_id, тип документа, key_fields и извлеченные поля. Для заданий, которые запускает сам n8n, используйте запрос GET /job/get/{job_id}.
Какие события может получать n8n?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed, document.legal_hold_placed, document.legal_hold_released, document.generated и task.completed. О завершении задания API можно узнать через запрос job/get.
Должен ли ваш экземпляр n8n быть доступен из публичной сети?
Для вебхуков — да. PaperOffice доставляет данные только по http или https на публичные адреса и не следует перенаправлениям. Частные адреса, localhost и хосты метаданных заблокированы. Для вызовов к серверам REST-API и MCP экземпляру n8n требуется только исходящий доступ к api.paperoffice.ai и mcp.paperoffice.ai.
Могу ли я создавать подписки на вебхуки в приложении?
Нет. Подписки на вебхуки создаются через API методом POST /webhooks/subscribe или с помощью инструмента MCP po_webhooks_subscribe. Отправив POST /webhooks/test, вы отправите test.ping на ваш узел вебхука.
Как проверить, что доставка исходит от PaperOffice?
Каждая доставка содержит подпись X-PaperOffice с sha256= и HMAC-SHA256 по исходному тексту. Секретный ключ находится в ответе на подписку. Дополнительно Вы можете настроить отправку собственного заголовка и включить аутентификацию заголовков в узле вебхука.
Может ли ИИ-агент использовать n8n в PaperOffice?
Да, через клиент MCP с URL-адресом сервера https://mcp.paperoffice.ai/dms и транспортом Streamable HTTP или SSE. Аутентификация осуществляется через OAuth 2.1 или токен po_ut_ или po_gt_. Доступные инструменты зависят от Вашего тарифного плана.
Может ли n8n передавать бизнес-данные в PaperOffice?
Да, начиная с Plus. В разделе Knowledge Base AI Вы создаете операционный источник типа Push (URL приема). n8n отправляет заказы, отправки, счета или предложения в виде JSON, не более 500 записей за вызов и 60 вызовов за 10 минут на источник. Чат- и телефонные агенты считывают эти данные начиная с Professional, но ничего не возвращают обратно.
Существуют ли ограничения на количество вызовов?
Да. Для каждого ключа в каждом плане предусмотрено как минимум 5 вызовов в секунду, 30 в минуту, 100 в час и 500 в день; в платных планах — больше. Циклы запросов учитываются, поэтому планируйте паузы длительностью от 5 до 10 секунд.
Возможно ли это также с Make или Zapier?
Да, по тому же принципу: в Make с помощью HTTP-модуля, в Zapier с помощью Custom Request к REST-API, для ИИ-агентов — с помощью клиента MCP к https://mcp.paperoffice.ai/dms. Собственных приложений или модулей для Make и Zapier не существует.
Где хранятся данные?
Документы, которые n8n отправляет в PaperOffice, обрабатываются PaperOffice в собственном центре обработки данных в ЕС. То, что сохраняет сам n8n, находится там, где работает Ваша инстанция n8n, будь то самостоятельное развертывание или облако n8n.